← Back to research
·6 min read·company

claude-seo

claude-seo is a universal SEO skill for Claude Code with 25 sub-skills, 18 subagents, extensions for DataForSEO, Firecrawl, and Banana, and coverage spanning technical SEO, E-E-A-T, schema, GEO/AEO, local SEO, e-commerce, and PDF/Excel reporting. 8,686 stars, MIT license.

Key takeaways

  • Broadest SEO coverage of any Claude Code skill — 25 sub-skills spanning technical SEO, content optimization, E-E-A-T, schema markup, GEO/AEO, backlinks, local SEO, e-commerce, international SEO, and strategic planning
  • 8,686 stars (up from 2,656 in March 2026), MIT license, Python. v2.0.0 "Security + AI-Search Major Release" shipped May 25, 2026 with Google APIs, PDF/Excel reporting, and citability scoring
  • 18 specialist subagents, up to 15 in parallel — the most comprehensive automated audit architecture in the category, backed by 271 tests
  • Once traditional-SEO-first, v2 is now explicitly AI-search first — aligned with Google's AI Optimization Guide, with passage citability scoring and evidence-based llms.txt posture

FAQ

What is claude-seo?

A universal SEO skill for Claude Code that provides 25 sub-skills covering technical SEO, content optimization, E-E-A-T analysis, schema markup, GEO/AEO, backlinks, local SEO, e-commerce, and international SEO. It uses 18 specialist subagents (up to 15 in parallel) and integrates with DataForSEO, Firecrawl, Google SEO APIs, and Banana image generation.

How does claude-seo differ from geo-seo-claude?

claude-seo offers the broadest SEO coverage in the category and, as of v2.0.0, is explicitly AI-search first with passage citability scoring. geo-seo-claude remains GEO-focused; claude-seo now covers comparable AI-search ground plus far more traditional SEO depth.

Does claude-seo require paid APIs?

The core skill and all 25 sub-skills are free and open source under MIT license. Optional extensions (DataForSEO, Firecrawl, Banana) and Google Ads Keyword Planner data require separate API subscriptions. A private community mirror with early-access features requires AI Marketing Hub Pro membership.

What agents does claude-seo support?

Claude Code natively. The author also maintains Codex SEO, a separate Codex-first port with the same SEO workflow surface. Unlike seo-geo-claude-skills which supports 35+ agents via skills.sh, claude-seo is tightly integrated with Claude Code's skill system.

Overview

claude-seo is the most comprehensive SEO skill for Claude Code — 25 sub-skills covering everything from technical audits to E-E-A-T analysis to backlinks, local SEO, e-commerce, and programmatic SEO content generation. The v2.0.0 "Security + AI-Search Major Release" (May 25, 2026) repositioned the project as AI-search first, aligned with Google's AI Optimization Guide, with question-based citability scoring and an evidence-based posture on llms.txt.

Key stats (as of June 11, 2026): 8,686 stars, 1,264 forks, MIT license, Python. Created February 7, 2026; last pushed May 25, 2026.

AttributeValue
Stars8,686 (as of June 11, 2026)
LicenseMIT
LanguagePython
CreatedFebruary 7, 2026
Latest releasev2.0.0 (May 25, 2026)
Sub-skills25
Subagents18 (up to 15 in parallel)
ExtensionsDataForSEO, Firecrawl, Banana (image gen)
CategorySEO/GEO Agent Skills

How It Works

claude-seo installs as a Claude Code plugin (or via install script) and exposes 27 user-invokable commands across an orchestrator and 25 sub-skills. Running a full audit fans out up to 15 specialist subagents in parallel — more than any other tool in the category — that each handle a different analysis dimension. Results synthesize into a prioritized action plan with a 0-100 health score, and v2 makes every recommendation falsifiable: each carries a "how would we know this failed?" check and a leading indicator.

Extensions System

The standout architectural feature is the extensions system. Rather than trying to do everything natively, claude-seo provides hooks for external data sources. The DataForSEO extension pulls real search volume, keyword difficulty, SERP features, and competitor data; Firecrawl adds full-site crawling; Banana adds AI image generation for SEO assets.

v2 also added a first-party Google APIs integration (/seo google) with a 4-tier credential system: a free API key unlocks PageSpeed Insights and CrUX; OAuth adds Search Console and the Indexing API; further tiers add GA4 and Keyword Planner data. PDF reports are generated via WeasyPrint with matplotlib charts.

This matters because most Claude Code SEO skills operate on static analysis alone — they can read your HTML and guess at optimization opportunities, but they can't tell you what people actually search for. The DataForSEO and Google API integrations close that gap.

E-E-A-T Analysis

claude-seo includes dedicated E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) analysis that evaluates content against Google's quality rater guidelines. It checks for author credentials, source citations, first-hand experience signals, and trust indicators — factors that correlate strongly with both traditional rankings and AI citation likelihood.


25 Sub-Skills

v2.0.0 nearly doubled coverage from the original 13 sub-skills to 25, organized into 8 categories around a central orchestrator. Highlights:

CommandPurpose
/seo auditFull site SEO audit with parallel subagent delegation
/seo pageDeep single-page analysis
/seo technicalTechnical SEO audit across 9 categories
/seo contentE-E-A-T and content quality analysis
/seo schemaDetect, validate, and generate Schema.org markup
/seo geoAI Overviews / Generative Engine Optimization
/seo planStrategic SEO planning (saas, local, ecommerce, publisher, agency)
/seo programmaticProgrammatic SEO analysis and planning
/seo localLocal SEO (GBP, citations, reviews, map pack)
/seo mapsMaps intelligence (geo-grid rank tracking, GBP audit)
/seo hreflangHreflang / i18n SEO audit and generation
/seo googleGoogle SEO APIs (GSC, PageSpeed, CrUX, GA4, PDF reports)
/seo backlinksBacklink profile analysis (Moz, Bing, Common Crawl)
/seo clusterSERP-based semantic clustering
/seo driftSEO drift monitoring with SQLite snapshots
/seo ecommerceE-commerce SEO and marketplace intelligence

Plus sitemaps, image optimization, competitor comparison pages, SXO analysis, the FLOW framework, and the three extension commands (/seo firecrawl, /seo dataforseo, /seo image-gen).


Competitive Position

claude-seo has moved from the middle of the SEO/GEO agent skills category toward the front. At 8,686 stars as of June 11, 2026 — up from 2,656 when this profile was first written in March — it now edges past geo-seo-claude (8,075) on star count, though it still trails Marketing Skills (32,921) on total adoption. With v2's citability scoring, the old "GEO is secondary" framing no longer holds: the project now markets itself as AI-search first.

The real-data integrations remain a genuine differentiator — DataForSEO, Firecrawl, and first-party Google APIs (Search Console, CrUX, GA4) connect the skill to actual search data rather than heuristic-based suggestions. The author also ships Codex SEO, a Codex-first port, extending the same workflow surface beyond Claude Code.


Strengths

  • Broadest SEO coverage — 25 sub-skills cover more ground than any competitor
  • Real search data — DataForSEO, Firecrawl, and Google APIs (GSC, CrUX, GA4), not just heuristics
  • 18 specialist subagents, up to 15 parallel — comprehensive and fast audits, backed by 271 tests
  • Citability scoring — v2 added passage citability analysis aligned with Google's AI Optimization Guide
  • PDF/Excel reporting — WeasyPrint-generated client-ready reports, new in v2
  • Falsifiable methodology — every recommendation carries a "how would we know this failed?" check

Weaknesses

  • Claude Code only (natively) — the Codex SEO port is a separate repo, and there is no skills.sh-style multi-agent distribution
  • Two-version split — early-access features live in a private community mirror gated behind paid AI Marketing Hub Pro membership
  • Paid-API dependency for live data — DataForSEO, Firecrawl, and Keyword Planner tiers require separate subscriptions
  • Breadth brings complexity — 27 commands and a 4-tier credential system is a lot of surface area for casual users

What Developers Say

Third-party commentary is still thin relative to the project's star count — most discussion happens inside the author's AI Marketing Hub community rather than in public forums. One independent assessment, from Violetta Bonenkamp (Mean CEO), listed claude-seo among five community skills worth studying:

"The sub-skill architecture is the most important thing to study here — breaking SEO into discrete, composable modules."


Bottom Line

Recommended if you want the most complete SEO skill for Claude Code: 25 sub-skills, real search data via DataForSEO/Firecrawl/Google APIs, citability scoring, and client-ready PDF reports — at 8,686 stars it now leads geo-seo-claude on adoption. Not recommended if you need multi-agent distribution beyond Claude Code (and the separate Codex port), or if you want every feature public — early access sits behind a paid community membership. Outlook: strong. v2.0.0 (May 2026) nearly doubled the skill surface and pivoted AI-search first; momentum, test coverage, and the extensions architecture all point toward continued category leadership.