seo-audit is the site-wide entry point of the claude-seo plugin. It renders the homepage, detects the business type, crawls internal links and delegates to up to seventeen specialist agents for technical SEO, content, schema, sitemap, performance, visual checks, AI search, agent readiness, local, maps, Google data, analytics, backlinks, clustering, search experience, drift and e-commerce.
The results are aggregated into a 0 to 100 SEO Health Score with weighted categories and written to a folder of Markdown and JSON files, with an optional PDF report.
What You Get
- FULL-AUDIT-REPORT.md with findings per category
- ACTION-PLAN.md sorted Critical, High, Medium, Low
- audit-data.json envelope and per-category findings files
- Desktop and mobile screenshots when Playwright is available
- An optional A4 PDF report with charts and an implementation roadmap
Common Use Cases
- Audit a client site before a proposal
- Run a pre-launch check on a new site
- Re-audit after a migration and compare against the action plan
- Combine Search Console, Matomo and backlink data into one report
What Makes It Unique
It orchestrates the rest of the plugin: each category is owned by a specialist skill, optional data sources join only when credentials are detected, and every subagent writes partial findings early so a budget limit does not lose work. It also lists confirmed Google updates before attributing any traffic change.
Under The Hood
The skill is an orchestration recipe. It runs shell commands that start Python scripts through the claude-seo launcher to render pages with a headless browser, check which credentials exist and generate the PDF, and it crawls the target site over the network with a limit of five concurrent requests and a one second delay. It writes the audit folder of reports, JSON and screenshots to disk. A Shopify path swaps in a signed crawl. Fetched pages and API responses are treated as untrusted data, and the skill tells the agent never to change browser sandbox settings itself. The frontmatter does not declare the shell or file access.