Claude SEO is an open-source SEO analysis plugin for Claude Code. It adds aDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/AgricIDaniel/claude-seo/llms.txt
Use this file to discover all available pages before exploring further.
/seo command that runs 25 sub-skills and 18 specialist agents in parallel across technical SEO, content quality (E-E-A-T), Schema.org markup, AI search optimization (GEO), local SEO, e-commerce, and international SEO. Every audit produces a prioritized action plan where each recommendation is grounded in primary-source guidance from Google and carries an explicit “how would we know this failed?” check. Full site audits complete in 10–15 minutes. Everything stays on your machine by default — no data is sent to any third-party vendor.
Who Claude SEO Is For
Claude SEO is designed for practitioners who need fast, repeatable, falsifiable audits without the overhead of heavyweight commercial platforms.SEO Agencies
Replace quarterly deep audits with weekly automated runs. Same team capacity, 4× audit cadence, every recommendation comes with a falsifiability check the client can verify.
In-House SEO Leads
Run
/seo audit 24 hours before executive reviews. Catch schema deprecation, AI-citability gaps, expired-domain heritage risk, and parasite-SEO exposure before the CMO asks.Freelance Consultants
Anchor day-one client scope with a 15-minute audit and a real 0–100 health score. Win the engagement with concrete proof of value before you write the proposal.
Developer Teams
Scriptable, deterministic, MIT-licensed. No per-domain pricing, no proprietary lock-in, no telemetry. Output is plain Markdown and JSON — pipe it wherever you like.
Key Capabilities
Parallel Execution
Full site audits spawn up to 15 specialist agents simultaneously, completing in minutes rather than hours.
Falsifiable Recommendations
Every finding carries its first-principle observation, dependency relationships, a failure-mode check, and a leading indicator to monitor.
AI-Search First
Aligned with Google’s AI Optimization Guide. Question-based citability scoring, passage citability (134–167 word blocks), and entity-presence checks across Wikipedia, Reddit, YouTube, and LinkedIn.
E-E-A-T Coverage
Evaluated against the September 2025 Quality Rater Guidelines. Experience, Expertise, Authoritativeness, and Trustworthiness scoring with Google’s Who / How / Why heuristic.
Schema.org Complete
Detects, validates, and generates 30+ active JSON-LD types. Tracks deprecated types (FAQPage rich results retired May 7, 2026; HowTo September 2023) with replacement guidance.
Local SEO
Google Business Profile signals, NAP consistency across citations, review intelligence, geo-grid rank tracking, and LocalBusiness schema generation with all required properties.
Zero Required API Keys
The full audit pipeline works offline without any credentials. A 4-tier Google API system lets you enrich data gradually — Tier 0 (PageSpeed/CrUX) through Tier 3 (Keyword Planner).
SPA-Aware Rendering
Playwright Chromium renderer auto-detects Next.js, React, Vue, Nuxt, and Astro islands.
--render auto is the default across all fetching subagents.Compared to Manual Audits and Commercial Tools
Claude SEO occupies a different position from Screaming Frog (purpose-built crawler for link-graph depth), Ahrefs Site Audit (proprietary backlink index), and traditional agency engagements. It leads on conversational LLM-native workflow, recommendation falsifiability, open-source licensing, and AI-search-first audits. The integrations for Ahrefs and DataForSEO are opt-in MCP extensions, not replacements.| Manual audit | Agency engagement | Commercial SEO audit tool | Claude SEO | |
|---|---|---|---|---|
| Time per audit | 4–8 hrs senior SEO time | 1–3 weeks turnaround | 10–45 min crawl + report | 10–15 min |
| Cost | High (billable hours) | 15k+ project | 999/mo subscription | Free skill + Claude Code subscription |
| Repeatable | Inconsistent across analysts | Inconsistent across engagements | Yes | Yes, deterministic + scriptable |
| Output format | Wall-of-findings PDF | Branded slide deck | Web dashboard, CSV exports | Markdown + PDF + JSON, local files |
| Custom benchmarks | Manual per analyst | Agency-specific frameworks | Vendor-fixed | Edit local SKILL.md |
| Data leaves machine? | No (your spreadsheet) | Yes (sent to agency) | Yes (uploaded to vendor) | No, fully local by default |
| Lock-in | None | High | High (data-exit friction) | None. MIT, your files. |
| AI search awareness | Depends on analyst | Depends on agency seniority | Lagging (typically 6–12 mo behind) | Google AI Optimization Guide (May 2026), Sept 2025 QRG, INP-not-FID, GEO/AEO=SEO reframe, llms.txt evidence-based posture |
| Falsifiability per finding | No | No | No | Yes. Every recommendation carries a “how would we know this failed?” check + leading indicator |
Cost benchmarks: manual audit assumes a senior SEO consultant at typical agency billable rates; agency engagement based on common discovery/audit deliverable scopes; commercial-tool subscriptions reflect published mid-tier pricing across the SEO audit category (Ahrefs, Semrush, Sitebulb, Screaming Frog). Your numbers may differ.
The Audit Methodology
Claude SEO follows a 10-principle framework across four phases. Every emitted recommendation carries the first-principle observation it rests on, its dependency relationship to other recommendations, a “how would we know this failed?” check, and a leading indicator to monitor.| Phase | Principles | What it does |
|---|---|---|
| PERCEIVE | OBSERVE (external) · OBSERVE (internal) · LISTEN | Collect raw signals; audit your own assumptions; read what the SERP, the brand voice, and the community actually say |
| ANALYZE | THINK · CONNECT (lateral) · CONNECT (system) | Reduce to first principles; find non-obvious cross-skill links; sequence into a dependency graph |
| VALIDATE | FEEL · ACCEPT | Pressure-test against UX, brand voice, operator capacity; surface falsifiability |
| ACT | CREATE · GROW | Ship the artifact; set the feedback loop for the next audit |
Two Versions
Public open-source →AgriciDaniel/claude-seo: MIT-licensed, public releases, no membership required. Use this for stable, downloadable builds. Community private mirror →AI-Marketing-Hub/claude-seo: early access to upcoming features and direct collaboration with the AI Marketing Hub Pro community. Requires membership.
Ecosystem
Claude SEO is part of a family of Claude Code skills that interoperate cleanly. Run an audit, write optimized content, and generate imagery — all within the same Claude Code session.| Skill | What it does | How it connects |
|---|---|---|
| Claude SEO | SEO analysis, audits, schema, GEO | Core. Analyzes sites and generates action plans. |
| Claude Blog | Blog writing, optimization, scoring | Companion. Writes content optimized by SEO findings. |
| Claude Banana | AI image generation via Gemini | Shared. Generates images for SEO assets and blog posts. |
| Codex SEO | Codex-first SEO skill suite | Port. Same SEO system adapted for Codex skills, TOML agents, deterministic runners. |
| AI Marketing Claude | Copywriting, emails, social, ads, funnels, CRO | Community. Post-audit marketing action from SEO findings. |
| FLOW | Evidence-led SEO framework (41 AI prompts, CC BY 4.0) | Knowledge base. Powers seo-flow prompts. |
/seo audit https://example.com— identify content gaps and technical issues/seo backlinks https://example.com— analyze link profile and competitor gaps/seo geo https://example.com/blog/post— score AI-citation readiness/blog write "target keyword"— create SEO-optimized blog post (Claude Blog)/seo image-gen hero "blog topic"— generate hero image (Banana extension)