← all repositories
AgriciDaniel/claude-seo

An SEO audit tool that dares you to prove it wrong

Claude SEO turns Claude Code into a parallel army of 18 specialist agents that audit websites against Google's own guidance—and every recommendation comes with a built-in falsifiability check.

12.1k stars Python AgentsCoding Assistants
claude-seo
Velocity · 7d
+190
★ / day
Trend
accelerating
star history

What it does

Claude SEO is a plugin for Claude Code that runs 25 sub-skills and 18 parallel agents across technical SEO, content quality, schema markup, local search, e-commerce, and AI-search optimization. You type /seo audit https://example.com and it fans out to check Core Web Vitals, E-E-A-T signals, Schema.org validity, backlink profiles, hreflang setup, and whether your content is actually citable by AI overviews. The output is a prioritized action plan, not a vague scorecard.

The interesting bit

The methodology is deliberately adversarial. Every recommendation must include the first-principle observation it rests on, its dependencies, and an explicit “how would we know this failed?” check with a leading indicator. It’s the rare SEO tool that treats its own advice as a hypothesis to be tested, not gospel to be invoiced. The project also tracks which Schema.org types Google has actually deprecated—HowTo, SpecialAnnouncement, ClaimReview, etc.—and refuses to recommend them, which is more diligence than most commercial tools show.

Key highlights

  • Parallel execution: up to 15 specialist agents run simultaneously, so full-site audits finish in minutes rather than hours
  • 27 invokable commands including /seo geo for generative-engine optimization, /seo drift for regression monitoring via SQLite snapshots, and /seo cluster for SERP-based semantic keyword grouping
  • Integrates Google APIs (GSC, PageSpeed, CrUX, Indexing, GA4) with a tiered credential system; CrUX History (25-week trends) included in the free tier
  • Optional extensions for DataForSEO live data, Firecrawl full-site crawling, and Banana AI image generation
  • 271 tests in CI, MIT license, with a private community mirror for early access

Caveats

  • Requires Claude Code 1.0.33+; there’s a separate Codex port if you’re on that toolchain instead
  • Some commands (DataForSEO, Firecrawl, image generation) are extensions, not core, so you’ll need additional accounts and API keys
  • The README is thorough to a fault—installation paths, version matrices, and security justifications for git clone over irm | iex consume significant real estate

Verdict

SEO agencies managing multiple client sites and in-house leads who need defensible pre-meeting audits will get the most value. If you just want a one-click Lighthouse score, this is overbuilt; if you want to hand a client a prioritized plan where every item can be verified as failed or fixed, this is built for that conversation.

Frequently asked

What is AgriciDaniel/claude-seo?
Claude SEO turns Claude Code into a parallel army of 18 specialist agents that audit websites against Google's own guidance—and every recommendation comes with a built-in falsifiability check.
Is claude-seo open source?
Yes — AgriciDaniel/claude-seo is open source, released under the MIT license.
What language is claude-seo written in?
AgriciDaniel/claude-seo is primarily written in Python.
How popular is claude-seo?
AgriciDaniel/claude-seo has 12.1k stars on GitHub and is currently accelerating.
Where can I find claude-seo?
AgriciDaniel/claude-seo is on GitHub at https://github.com/AgriciDaniel/claude-seo.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.