# Claude SEO

> [Claude SEO](https://claude-seo.md/) is a free, open-source AI SEO audit tool for Claude Code.
> It provides 26 sub-skills, 19 specialist agents, 34 user-invocable commands,
> and 9 extensions for comprehensive website SEO analysis
> across all industries. It is a free, local alternative or complement to
> paid browser-based SEO platforms.

## What Claude SEO Does
- Full website SEO audits with 19 specialist agents and up to 17 concurrent workers
- Technical SEO analysis across 9 categories (crawlability, indexability, security, URL structure, mobile, Core Web Vitals with INP, structured data, JS rendering, IndexNow)
- Content quality assessment using the E-E-A-T framework (Sept 2025 QRG)
- Schema.org markup detection, validation, and JSON-LD generation
- Generative Engine Optimization (GEO) for AI Overviews, ChatGPT, Perplexity, Bing Copilot
- Agent readiness: Lighthouse Agentic Browsing fraction (X/N), accessibility tree for agents, robots.txt and Content-Signal per AI agent, llms.txt, Markdown delivery, discovery files, and WebMCP
- Local SEO analysis (Google Business Profile, NAP consistency, citations, reviews, map pack)
- Maps intelligence (geo-grid rank tracking, GBP audit, competitor radius)
- XML sitemap analysis and generation with industry templates
- Image optimization analysis (alt text, formats, lazy loading, CLS)
- Image file optimization (WebP/AVIF conversion, IPTC/XMP metadata, responsive variants)
- Google Images SERP analysis for competitive image search
- Strategic SEO planning with industry-specific templates
- Programmatic SEO at scale with quality gates
- Competitor comparison page generation ("X vs Y" and "alternatives to X")
- International SEO with hreflang audit and generation, plus DACH/FR/ES/JA cultural profiles
- Semantic topic clustering via SERP overlap analysis (no paid tools needed)
- Search Experience Optimization (SXO) with page-type mismatch detection and persona scoring
- SEO drift monitoring with SQLite baselines and 17 comparison rules
- E-commerce SEO with product schema, Google Shopping intelligence, Amazon marketplace data
- FLOW framework integration: 41 evidence-led AI prompts (Find, Leverage, Optimize, Win, Local) bundled under CC BY 4.0
- Backlink profile analysis with toxic link detection (free APIs: Moz, Bing Webmaster, Common Crawl + verification crawler)
- Google SEO APIs integration: Search Console, PageSpeed Insights, CrUX field data with 25-week history, eligible Indexing API workflows, GA4 organic traffic, PDF and Excel report generation
- Managed runtime setup and read-only diagnostics through `/seo setup` and `/seo doctor`

## Key Facts
- Version: 2.5.0 (released 2026-10-22)
- License: MIT (fully open source, free forever, no paid tiers); FLOW prompts CC BY 4.0
- Author: AgriciDaniel (https://github.com/AgriciDaniel)
- Website: https://claude-seo.md
- Repository: https://github.com/AgriciDaniel/claude-seo
- GitHub Stars: 19,695 (checked 2026-10-22)
- GitHub Forks: 2,859 (checked 2026-10-22)
- Demo: https://www.youtube.com/watch?v=COMnNlUakQk
- Requirements: Claude Code CLI 1.0.33+, Python 3.11 to 3.14, Git
- Supported Industries: SaaS, Local Service, E-commerce, Publisher, Agency
- Cost: $0 forever
- Community contributions: 4 Pro Hub Challenge skills integrated in v1.9.0 (seo-cluster, seo-sxo, seo-drift, seo-ecommerce). See CONTRIBUTORS.md in repo.

## SEO Health Score
Weighted 0-100 score across 7 categories:
- Content Quality: 23%
- Technical SEO: 22%
- On-Page SEO: 20%
- Schema/Structured Data: 10%
- Performance (Core Web Vitals with INP): 10%
- AI Search Readiness: 10%
- Images: 5%

## Installation

### Plugin Marketplace (Recommended, Claude Code 1.0.33+)
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup
/seo doctor

### Manual (macOS, Linux)
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

### Windows (PowerShell)
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

Short URL with copy-to-clipboard: [Claude SEO installation](https://claude-seo.md/install)
Also searched as: Claud SEO, Claude-SEO, ClaudeSEO, Claude Code SEO (same project, all variants).

## Pages

### Skills (26)
- [All Claude SEO skills](https://claude-seo.md/skills): Browse the complete collection of 26 skill detail pages
- [Full Site Audit](https://claude-seo.md/skills/seo-audit): 19 specialist agents, up to 17 concurrent workers, a vendor health-score heuristic, and 5 business profiles
- [Technical SEO](https://claude-seo.md/skills/seo-technical): 9 categories including crawlability, indexability, security, Core Web Vitals
- [E-E-A-T Content](https://claude-seo.md/skills/seo-content): Content quality per September 2025 Quality Rater Guidelines
- [Schema Markup](https://claude-seo.md/skills/seo-schema): JSON-LD detection, validation, generation for 30+ types
- [GEO / AI Search](https://claude-seo.md/skills/seo-geo): Standard SEO foundations for Google generative search plus platform-specific crawler and measurement reviews
- [Agent Readiness](https://claude-seo.md/skills/seo-agentic): Lighthouse Agentic Browsing reported as X/N, AI agent access policy, llms.txt, Markdown, discovery files, and optional WebMCP (new in v2.4.0)
- [Local SEO](https://claude-seo.md/skills/seo-local): Google Business Profile, NAP, citations, reviews, map pack
- [Maps Intelligence](https://claude-seo.md/skills/seo-maps): Geo-grid rank tracking, GBP audit, competitor radius
- [Single Page Analysis](https://claude-seo.md/skills/seo-page): Deep on-page SEO analysis
- [Image Optimization](https://claude-seo.md/skills/seo-images): Alt text, file sizes, formats, WebP/AVIF conversion, lazy loading, CLS, Google Images SERP
- [Sitemap](https://claude-seo.md/skills/seo-sitemap): XML sitemap analysis, generation, validation
- [Hreflang / I18N](https://claude-seo.md/skills/seo-hreflang): International SEO and hreflang audit with DACH/FR/ES/JA cultural profiles
- [Competitor Pages](https://claude-seo.md/skills/seo-competitor-pages): "X vs Y" and alternatives page generation
- [Strategic Planning](https://claude-seo.md/skills/seo-plan): Industry-specific SEO strategy and roadmap
- [Programmatic SEO](https://claude-seo.md/skills/seo-programmatic): Pages at scale with quality gates
- [FLOW Framework](https://claude-seo.md/skills/seo-flow): Evidence-led SEO with 41 AI prompts (Find, Leverage, Optimize, Win, Local) CC BY 4.0
- [Backlinks](https://claude-seo.md/skills/seo-backlinks): Free backlink audit, toxic link detection, competitor gap analysis (Moz, Bing, Common Crawl)
- [Google APIs](https://claude-seo.md/skills/seo-google): Search Console, PageSpeed Insights, CrUX, Indexing API, GA4, PDF/Excel reports
- [Topic Clusters](https://claude-seo.md/skills/seo-cluster): SERP-based semantic clustering, hub-and-spoke architecture, interactive cluster map (Pro Hub Challenge: Lutfiya Miller)
- [SXO](https://claude-seo.md/skills/seo-sxo): Search Experience Optimization, SERP-backward analysis, persona scoring (Pro Hub Challenge: Florian Schmitz)
- [SEO Drift](https://claude-seo.md/skills/seo-drift): SQLite-baselined regression monitoring across 17 rules, "git for on-page SEO" (Pro Hub Challenge: Dan Colta)
- [E-commerce SEO](https://claude-seo.md/skills/seo-ecommerce): Product schema, Google Shopping intelligence, Amazon marketplace analysis (Pro Hub Challenge: Matej Marjanovic)
- [DataForSEO extension](https://claude-seo.md/skills/seo-dataforseo): Live SERP, keyword volume, backlinks, AI visibility tracking via DataForSEO MCP
- [Image Gen extension](https://claude-seo.md/skills/seo-image-gen): OG previews, hero images, product photos, infographics via Gemini (banana MCP)
- [SEO Orchestrator](https://claude-seo.md/skills/seo): Routes a selected command to specialist skills and agents with explicit input, provider, output, side-effect, and approval boundaries
- [Content Brief](https://claude-seo.md/skills/seo-content-brief): Research-backed brief from a URL or keyword, including intent, relevant competitors, gaps, evidence needs, metadata, outline, and internal links

### Reports
- [AI SEO Tools Speed Report (May 2026)](https://claude-seo.md/speed-report): Archived mobile Lighthouse lab benchmark of 8 AI SEO tool homepages. Two stored Performance medians are 90 or higher and the overall median is 44. These lab scores are not Core Web Vitals field status. Methodology: Google PageSpeed Insights API, three requested mobile runs per URL, median summary. CC BY 4.0.

### AI Visibility
- [AI Visibility Tool](https://claude-seo.md/ai-visibility-tool): Source-backed workflow for checking brand and website visibility in AI answers, LLM mentions, citation sources, and answer-engine content gaps. Uses Google Search Central guidance, DataForSEO evidence, and cross-links to Claude Blog public-question content.

### Install
- [Install Page](https://claude-seo.md/install): Short URL for installation. Plugin marketplace one-liner plus manual install for macOS, Linux, and Windows PowerShell. Lists requirements and steps.

### Blog
- [Google September 2026 Spam Update: What We Know](https://claude-seo.md/blog/google-september-2026-spam-update): What Google confirmed about the September 2026 spam update, what nobody can confirm yet, and what to check now that the rollout is complete. Published 2026-09-29.
- [Claude SEO v2.4.0: Agent Readiness and Audit Fixes](https://claude-seo.md/blog/claude-seo-v240-release): New /seo agentic audit for AI agent readiness, an optional Matomo extension, installer security fixes, and fixes for issues #312, #314 and #317. Released 2026-09-24.
- [Does Your Website Need WebMCP? A Practical Fit Check](https://claude-seo.md/blog/webmcp-website-readiness): Assess a useful agent workflow, review browser requirements and scope a small pilot. Includes Daniel Agrici's video and dated demo evidence.
- [Claude SEO Blog](https://claude-seo.md/blog): Release notes, technical guides, tutorials, and comparisons
- [Hreflang x-default Guide](https://claude-seo.md/blog/hreflang-x-default-guide): When to use an unmatched-language fallback, how it differs from canonical URLs, and how to validate reciprocal alternate sets.
- [Local SEO in 2026](https://claude-seo.md/blog/local-seo-guide): Evidence-led guide to eligibility, Google Maps, reviews, location pages, structured data, measurement, and a 90-day operating plan.
- [How claude-seo.md Reached 34,100 Organic Clicks](https://claude-seo.md/blog/claude-seo-34k-organic-clicks): Search Console case study. 34,100 clicks, 719,000 impressions, 4.8% average CTR, average position 15.8, captured 2026-08-15. No ads and no purchased links.
- [Claude SEO v2.3.1: Three Releases From One Review](https://claude-seo.md/blog/claude-seo-v231-release): One review of 46 pull requests produced v2.2.6, v2.3.0 and v2.3.1 on September 10, 2026: hosted install fix, SSRF hardening with a local-target allowlist, Google guidance through September 2026, and 763 passing tests.
- [Claude SEO v2.2.5 Reliability and Google Updates](https://claude-seo.md/blog/claude-seo-v225-release): Installer packaging, JSON-LD graph validation, browser evidence, current Google guidance, and 439 passing tests.
- [Claude SEO v2.2.4 Managed Runtime and Reliability Release](https://claude-seo.md/blog/claude-seo-v224-release): Managed Python runtime, safer sitemap discovery, corrected Google workflows, portability fixes, and 410 passing tests.
- [Claude SEO v2.2.3 Current Guidance, Consistency Checks, and 328 Tests](https://claude-seo.md/blog/claude-seo-v223-release): Google guidance refreshed, command wiring corrected, strict consistency enforced, and 328 tests passed. No breaking changes.
- [Claude SEO v2.2.0 Security Hardening, Reliability Fixes, and Secret-Scan Gate](https://claude-seo.md/blog/claude-seo-v220-release): Installer injection and SSRF closed, GSC zero-click totals fixed, Unlighthouse and Ahrefs extensions repaired, secret-scan CI gate. 326 tests, no breaking changes.
- [Claude SEO v2.0.0 Hardened Release](https://claude-seo.md/blog/claude-seo-v2-release): Secure multi-agent orchestration, corrected Google integrations, and release validation.
- [FLOW Framework for SEO Guide](https://claude-seo.md/blog/flow-framework-seo-guide)
- [SEO Drift Monitoring Guide](https://claude-seo.md/blog/seo-drift-monitoring-guide)
- [Topic Clustering with SERP Overlap](https://claude-seo.md/blog/topic-clustering-serp-overlap)
- [Claude SEO v1.9.6 FLOW Framework Security Hardened](https://claude-seo.md/blog/claude-seo-v196-flow-security-hardening)
- [Claude SEO v1.9.0 Community Release](https://claude-seo.md/blog/claude-seo-v190-community-release)
- [Claude SEO v1.8.1 Image SEO](https://claude-seo.md/blog/claude-seo-v181-image-seo)
- [Claude SEO v1.8.0 Free Backlinks](https://claude-seo.md/blog/claude-seo-v180-free-backlinks)
- [Claude SEO v1.7.2 Update](https://claude-seo.md/blog/claude-seo-v172-update)
- [WP MCP Ultimate WordPress AI SEO](https://claude-seo.md/blog/wp-mcp-ultimate-wordpress-ai-seo)
- [Free SEO Reports with Google APIs](https://claude-seo.md/blog/google-api-seo-reporting-claude)
- [How to Run a Free SEO Audit](https://claude-seo.md/blog/how-to-run-free-seo-audit-claude-seo)
- [Claude SEO vs Ahrefs vs Semrush](https://claude-seo.md/blog/claude-seo-vs-ahrefs-semrush)
- [Technical SEO with Claude Code](https://claude-seo.md/blog/technical-seo-with-claude-code)
- [XML Sitemaps in 2026](https://claude-seo.md/blog/xml-sitemap-guide)
- [Robots.txt Guide 2026](https://claude-seo.md/blog/robots-txt-guide): Rule matching, indexing limits, AI crawler controls, safe templates, and testing.
- [GEO Guide](https://claude-seo.md/blog/generative-engine-optimization-guide)
- [Best Claude Code Skills](https://claude-seo.md/blog/best-claude-code-skills)
- [Schema Markup Generator Guide](https://claude-seo.md/blog/schema-markup-generator-guide)
- [Free SEO Audit Tools](https://claude-seo.md/blog/free-seo-audit-tool-guide)

## Ecosystem
- [Claude Blog](https://claude-blog.md/) - 19 sub-skills, 4 AI agents, 17 commands, 12 content templates. Blog engine consuming SEO findings.
- [Claude Banana](https://github.com/AgriciDaniel/banana-claude) - AI image generation for SEO assets
- AI Marketing Claude - cross-skill marketing automation

## Extensions
- Firecrawl: Full-site crawling, JS rendering, scraping, site mapping (4 commands: crawl, map, scrape, search)
- DataForSEO: Live SERP, keyword, backlink, on-page, content, AI visibility (23 commands, 9 API modules)
- Banana: AI image generation via Google Gemini for OG images, hero graphics, product photos
- Ahrefs: Backlink, keyword, and competitor data through the Ahrefs MCP integration
- SE Ranking: Rank tracking and competitive research
- Profound: AI visibility research and citation monitoring
- Bing Webmaster: Bing performance data and URL submission
- Unlighthouse: Site-wide Lighthouse auditing
- Matomo: Self-hosted or Matomo Cloud analytics as a GA4 alternative or complement (new in v2.4.0)

## MCP Integrations
- Official Ahrefs MCP (@ahrefs/mcp)
- Semrush MCP server
- Google Search Console, PageSpeed Insights, DataForSEO community servers
- Firecrawl MCP for JS-rendered sites

## Agent Resources
- [Agent skill catalog](https://claude-seo.md/.well-known/ard.json): Agentic Resource Discovery (ARD) catalog of the 26 Claude SEO skills, each linked to its SKILL.md for the current release. Also served at /.well-known/ai-catalog.json.
- WebMCP: the homepage, install page, and skills index register read-only tools (search_skills, get_skill, get_install_command, get_latest_release) in browsers that support WebMCP.

## Contact
- Author: [Daniel Agrici (@AgriciDaniel)](https://github.com/AgriciDaniel)
- [Repository Issues](https://github.com/AgriciDaniel/claude-seo/issues)
- [YouTube](https://www.youtube.com/@AgriciDaniel)
- [Skool](https://www.skool.com/@daniel-agrici-3925)
- [LinkedIn](https://md.linkedin.com/in/daniel-agrici)
- [Extended docs](https://claude-seo.md/claude-seo.md)
- Last updated: 2026-10-22
- License: MIT (skill code) + CC BY 4.0 (FLOW prompts)