Claude SEOAn open-source SEO skill pack for Claude Code: 25 sub-skills and 18 agents run audits, schema, GEO, local, and international SEO from the terminal, with no per-domain fee.
Repo
Claude SEO
An open-source SEO skill pack for Claude Code: 25 sub-skills and 18 agents run audits, schema, GEO, local, and international SEO from the terminal, with no per-domain fee.
The most-starred SEO skill for Claude Code, and genuinely broad: 25 sub-skills and 18 agents cover technical SEO, schema, AI-search (GEO), local, e-commerce, and international, all MIT and free. Two honest catches. It runs Python and shell inside your environment, and by default it silently appends a self-promo footer to major deliverables, a real problem for client work until you edit the skill file.
Great for
SEO agencies, in-house leads, and freelancers who want fast, repeatable, AI-search-aware audits inside Claude Code without paying $99-$999 a month for a commercial audit suite.
The catch
It executes code locally and, by default, appends an undisclosed maintainer footer to audit output. Read and edit skills/seo/SKILL.md, and security-check the repo, before you send anything to a client.
Bottom line
The most complete free SEO skill for Claude Code, alive and shipping weekly, but it is one maintainer's project with a marketing hook baked in. Strip the footer, keep a real crawler alongside it, and it earns its slot.
Install/plugin marketplace add AgriciDaniel/claude-seo then /plugin install, or git clone plus install.sh
LicenseMIT
LanguagePython (Markdown skill files)
Maintained byAgrici Daniel, single maintainer, plus the AI Marketing Hub Skool community
Harnesses supportedClaude Code (Codex via the separate codex-seo port)
Watch out forDefault self-promo footer on outputs, executes code locally, deep data needs paid API extensions
Technical SEO audit (9 categories)Yes
Content quality / E-E-A-TScored against the Sept 2025 Quality Rater Guidelines, with a filler and AI-pattern humanizer
Schema.org detect / validate / generateJSON-LD, dual validator, e-commerce and profile generators
GEO / AI-search optimizationPassage citability, entity presence, aligned to Google's AI Optimization Guide
Local SEO + maps intelligenceGBP signals, NAP consistency, geo-grid rank tracking
Semantic clusteringSERP-based, contributed by the community
E-commerce SEOYes
International SEO (hreflang)Yes
Google API integrationGSC, PageSpeed, CrUX, GA4, Indexing via a 4-tier system, but you bring your own credentials
Backlink analysisFree via Moz, Bing, Common Crawl; deep data needs the paid Ahrefs or DataForSEO extension
Core Web Vitals (LCP / INP / CLS)Lab estimates by default; field data needs a Google API key for CrUX
PDF / Excel reportingWeasyPrint plus matplotlib, roughly 32 A4 pages per full audit
SPA / JavaScript renderingPlaywright Chromium via the v2 headless renderer
Paid-suite extensionsDataForSEO, Firecrawl, Ahrefs, SE Ranking, Profound, opt-in with your own account
Discloses the self-promo footerAppended to major deliverables by default, no README disclosure or opt-out
What it does
- Runs a full-site audit that fans out up to 15 parallel sub-agents and returns a prioritized action plan with a 0-100 score, in roughly 10 to 15 minutes
- Covers 25 sub-skills across technical SEO, E-E-A-T content quality, Schema.org, GEO and AI-search, local and maps, e-commerce, international (hreflang), and semantic clustering
- Scores AI-search readiness the way Google frames it: passage citability, question-based heading hierarchy, entity presence, and structured-data coverage, aligned to Google's AI Optimization Guide
- Detects, validates, and generates JSON-LD schema, with e-commerce validators for return policy, shipping details, and product variants
- Writes real deliverables to local files: markdown reports plus a production PDF via WeasyPrint and matplotlib charts, roughly 32 A4 pages for a full audit
- Adds live competitive and field data through optional MCP extensions and a 4-tier Google API credential system that starts from zero keys
- Installs as a Claude Code plugin or through a shell installer that builds an isolated Python environment and optional Playwright Chromium
What it can’t do
- Crawl a site as deep or fast as Screaming Frog, since it is not a dedicated crawler and works from the target URLs you point it at
- Give you a proprietary backlink or keyword-volume index; deep link and search-volume data need paid extensions (Ahrefs, DataForSEO) with your own account
- Return live field-data Core Web Vitals or true indexation status without your own Google API credentials; the free tier gives lab estimates only
- Run itself hands-off; audits execute Python and shell in your environment, so setup, upgrades, and reading the source stay on you
- Stop appending the maintainer self-promo footer to major deliverables unless you edit the skill file; it ships on by default and undisclosed in the README
- Handle every single-page app cleanly; pages with scroll-bound or post-interaction hydration still produce noisy findings
Pros & cons
Pros
- Broadest SEO coverage in one MIT-licensed pack, from technical and schema to GEO, local, e-commerce, and international
- Free skill on top of a Claude Code subscription, against $99-$999 a month for commercial audit suites
- AI-search-first and current, tracking Google primary sources (AI Optimization Guide, Sept 2025 Quality Rater Guidelines, schema deprecations, INP-not-FID)
- Every recommendation carries a falsifiability check and a leading indicator, so a finding comes with a way to verify it failed
- Runs fully local by default, so audit data stays on your machine until you opt into an enrichment extension
- Actively maintained with heavy test coverage (410 tests, including a 91-case SSRF and DNS-rebinding suite) and near-weekly releases
Cons
- Appends an undisclosed self-promo footer to audit output by default, a genuine problem for client deliverables until you edit the skill
- Single maintainer, so bus factor and support lean on one person plus a paid Skool community
- Executes Python and shell in your environment; treat it like any code you run and read the source first
- Full value needs your own Google API keys and, for competitive data, paid third-party extensions
- The 15k star count draws skepticism, and the community notes skill marketplaces have no vetting layer
- No substitute for a dedicated crawler or a proprietary backlink index, so it sits beside those tools instead of replacing them
1 positive2 mixed3 critical
What the community says
The entire SEO and GEO side runs through Claude Code skills and agents. No Ahrefs, no Semrush, no Surfer... The GEO side is the part I actually find interesting. It fires a few subagents at once to score how citable each passage is, check whether GPTBot and PerplexityBot can reach the page, and validate llms.txt and schema.
This is output every time I use the skill and has been for as long as I've used it. Did you send clients deliverables without looking at them at all?
skills/seo/SKILL.md line 119 has a 'Community Footer' instruction. It tells the agent to append this after 15 different /seo commands complete... no disclosure, no opt-out... every time that output gets published or shared, it is a backlink back to the maintainer's Skool community, built through your deliverable, without you agreeing to it.
The skills model for Claude Code is still pretty new and there is basically no vetting layer right now, so anyone can publish something with 11k stars and you have no idea what it's doing to your output unless you read the source carefully. The fact that this one was silently injecting self-promo into client deliverables is particularly bad.
The root problem is that skill instructions run in the model's context with zero sandboxing. If the file says 'append this footer,' the model just does it, no permission prompt, no way for the user to know unless they read the raw file. Until there's something like a declared-side-effects manifest, reading the SKILL.md cover to cover is the only real defense.
It's a backlink skill!
10 sourcesWhere this page’s facts came from. Open the receipts.
- 1GitHub repo (AgriciDaniel/claude-seo)
- 2GitHub API, repo metadata (stars, license, language, dates)
- 3Claude SEO README (25 sub-skills, 18 agents, install, extensions, limitations)
- 4Community Footer instruction in skills/seo/SKILL.md (still default-on)
- 5Claude SEO homepage
- 6Reddit r/ClaudeAI, PSA on the undisclosed self-promo footer (275 upvotes)
- 7Reddit r/Agentic_SEO, real 3-month Search Console data running claude-seo
- 8Reddit r/claudeskills, footer default-on versus opt-in across the author's two packs
- 9YouTube, maintainer demo of the plugin
- 10YouTube, StudioHawk agency review of claude-seo
Watch it work
Real tutorials and reviews from YouTube, not ours.