Local SEO Audit for Small Businesses (AI Agent Ready)

Audits a business website and returns a structured local SEO report: on page factors, technical health, local signals (NAP consistency, LocalBusiness schema, map embed, city keywords), a 0 to 100 score per category, and a prioritized fix list an AI agent can act on directly.

What it does

1. Runs site level technical checks: HTTPS, robots.txt, sitemap.xml.
2. Crawls up to maxPages internal pages in a real browser (Playwright) and audits each one: title tag, meta description, H1 structure, image alt coverage, internal links, canonical tag, schema.org markup, word count, mobile viewport, load time, and page weight.
3. Detects local SEO signals: phone numbers (tel: links and text), street addresses, phone consistency across pages, embedded maps, LocalBusiness JSON-LD completeness, and city keywords in titles and headings.
4. Computes scores: On Page, Technical, Local, and Overall (0 to 100).
5. Outputs one dataset item per audited page plus one summary item with the scores and a prioritized fix list. Every fix has a severity, the affected page, the issue, and a specific recommendation.

Input example

{
    "websiteUrl": "https://example-plumber.com",
    "businessName": "Smith Family Plumbing",
    "city": "Asheville, NC",
    "maxPages": 10
}

Only websiteUrl is required. businessName and city unlock the name consistency and city keyword checks. maxPages (default 10, max 50) caps both crawl depth and your cost.

Output example

The summary item (one per run, alongside one item per audited page):

{
    "type": "summary",
    "websiteUrl": "https://www.12bones.com",
    "businessName": "12 Bones Smokehouse",
    "city": "Asheville, NC",
    "pagesAudited": 5,
    "stoppedByBudget": false,
    "scores": { "onPage": 100, "technical": 100, "local": 55, "overall": 87 },
    "technicalDetails": {
        "https": true,
        "robotsTxtFound": true,
        "sitemapFound": true,
        "brokenPages": [],
        "avgLoadTimeMs": 1538,
        "sitemapSource": "https://12bones.com/sitemap.xml"
    },
    "napDetails": {
        "phones": ["8286871395"],
        "phoneConsistent": true,
        "pagesWithPhone": 5,
        "addressDetected": true,
        "mapEmbed": true,
        "localBusinessSchemaPages": 0,
        "schemaCompleteness": 0
    },
    "fixList": [
        {
            "severity": "high",
            "page": "site-wide",
            "issue": "No LocalBusiness schema.org markup found",
            "recommendation": "Add JSON-LD LocalBusiness markup to the home page with name, address, telephone, geo, url, openingHoursSpecification (name: \"12 Bones Smokehouse\")."
        },
        {
            "severity": "high",
            "page": "site-wide",
            "issue": "City \"Asheville, NC\" not found in any title or H1",
            "recommendation": "Include \"Asheville, NC\" in the home page title and H1, for example \"12 Bones Smokehouse, Asheville, NC\" or \"Your Main Service in Asheville, NC\"."
        }
    ],
    "generatedAt": "2026-07-05T13:01:28.517Z"
}

This is real output from a live test run against a real restaurant website. Each audited page is additionally pushed as its own dataset item with "type": "page" and the full per page checks (title, meta description, H1, images, canonical, viewport, word count, schema types, load time, page weight, and local signals).

Pricing

Event	Price	When charged
audit-init	$0.10	Once at run start, covers site level technical checks
page-audited	$0.02	Once per page analyzed
report-generated	$0.40	Once when the summary with scores and fix list is pushed

A default 10 page audit costs $0.70. Set a maximum total charge on the run to cap spend; the actor stops gracefully at your cap and only charges for completed work.

Use with AI agents

This actor uses pay per event pricing with limited permissions and no standby mode, which makes it discoverable and payable by AI agents through Apify's agentic payment support (x402). An agent can read the input schema, set a budget cap, run the audit, and consume the machine readable fix list without any human in the loop.

Limitations

• Audits publicly accessible pages only; pages behind login are not crawled.
• The crawl stays on the same hostname as websiteUrl.
• Phone detection is tuned for North American formats; international numbers in tel: links are still detected.
• includeCompetitorSnapshot is reserved for a future version and currently returns null.
• This actor audits the website itself. It does not fetch Google Business Profile data.

Who this is for

local seo audit, gbp audit companion, small business seo checker, on page seo analysis, technical seo scan, nap consistency check, localbusiness schema validator, seo fix list api, city keyword check, mobile viewport audit, sitemap and robots txt checker, page speed snapshot