About audit
audit is a read-only SEO and AI-search audit skill in the Claude SEO AI plugin, intended for website teams. It combines deterministic checks with specialist reviews and produces scored reports with evidence and prioritized actions.
Key features
- 01Read-only site audits
- 02URL and local project inputs
- 03SEO and AI-search visibility checks
- 04Specialist reviews by site vertical
- 05Scored reports with evidence
- 06Actions ranked by impact and effort
Use cases
- 01Assess a site's search SEO
- 02Review AI crawler access and content rendering
- 03Audit preview or staging sites before deployment
MCP support
The input does not describe MCP integration.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ hainrixz/ claude-seo-ai --skill auditAfter installing, type/auditin Claude Code to confirm it loaded.
Details
From the project README/claude-seo-ai:audit
A full, read-only SEO + AI-search audit. Never writes to the user's project; artifacts go to ${CLAUDE_PLUGIN_DATA}/runs (or --out).
$ARGUMENTS = <url|path> [flags]. The target is a URL (https://…) or a local web project / built HTML. If no target is given, ask for one. Flags are forwarded verbatim to the orchestrator, which passes them to audit.mjs: --pages N (pages to sample, default 12) · --max N (URLs to consider, default 40) · --render static|auto|js (default static — a headless run never launches a browser unless asked) · --ua default|googlebot|bingbot|gptbot|oai-searchbot|claude-searchbot (or a literal UA string) · --vertical <ids> (comma list of saas,blog-publisher,local-business,ecommerce,docs,generic; omit it to let the run infer one) · --environment production|preview|staging|local · --feed <path> (a product feed for the ACP lint) · --out <dir> (runs root; defaults to ${CLAUDE_PLUGIN_DATA}/runs).
What to do
- Invoke the seo-orchestrator skill with the target and all flags. It runs
audit.mjsonce — acquisition (crawl/snapshot → PageSnapshot v2), platform profile, vertical guess and the whole deterministic checks registry in a single call — refines the vertical with seo-vertical-detect (references/routing.md), dispatches the read-only specialist subagents in parallel with a dispatch envelope, then merges everything back withreport.mjs --mergeand scores. - Present, from
report.json:- The two scores — Search SEO and AI Visibility — each with a band (A–F) and a one-line interpretation. Never blended.
- A per-category breakdown for each score; coverage mode (full vs deterministic-only), the data tier reached, and the
needs_api/manual_reviewcounts (score confidence). - The sampling table: pages crawled by role, templates discovered vs sampled, and every skip with its reason.
- The platform profile (platform/framework/plugins, environment — e.g. "noindex expected on preview").
- A prioritized action list sorted by impact ÷ effort: status, evidence, recommendation, fixability (auto/proposed/advisory),
expected_impact(axis + confidence + magnitude). - The absolute report path (
<run_dir>/report.md).
- End by offering: "Run
/claude-seo-ai:fix <target>to apply the safe, deterministic fixes — you'll confirm each change" and "/claude-seo-ai:compare --baseline latest --against <target>after you deploy".
Every finding conforms to schema/finding.schema.json with reproducible evidence. Respond in the user's language (EN/ES).