# Claude SEO - llms.txt
# https://claude-seo.md/

> Claude SEO is a free, open-source AI SEO audit tool for Claude Code.
> It provides 25 sub-skills (21 core + 1 orchestrator + 1 framework + 2 extension mirrors), 18 parallel
> subagents, and 3 extensions for comprehensive website SEO analysis
> across all industries. It is a free alternative to paid SEO tools like
> Ahrefs ($99/mo) and Semrush ($117/mo).

## What Claude SEO Does
- Full website SEO audits with up to 18 parallel AI agent delegation
- 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
- 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, Indexing API, GA4 organic traffic, PDF and Excel report generation

## Key Facts
- Version: 2.0.0
- 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: 7,000+
- GitHub Forks: 1,091
- YouTube Demo Views: 31,000+
- Requirements: Claude Code CLI 1.0.33+, Python 3.10+, 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

### 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: https://claude-seo.md/install
Also searched as: Claud SEO, Claude-SEO, ClaudeSEO, Claude Code SEO (same project, all variants).

## Pages

### Skills (23)
- Full Site Audit: https://claude-seo.md/skills/seo-audit - up to 18 parallel AI agents, 0-100 health score, auto-detects 5 business types
- 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 - Generative Engine Optimization for AI Overviews, ChatGPT, Perplexity
- 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)

### Reports
- AI SEO Tools Speed Report (May 2026): https://claude-seo.md/speed-report - Mobile Lighthouse benchmark of 8 leading AI SEO tools (claude-seo.md, MarketMuse, DataForSEO, Semrush, Frase, RankIQ, Surfer SEO, Ahrefs); only 2 pass Core Web Vitals: claude-seo.md (99) and MarketMuse (98). Median 44. Methodology: Google PageSpeed Insights API, mobile, 3 runs per URL, median reported. Every score deep-link verifiable. 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, Windows PowerShell. HowTo schema. Lists requirements and steps.

### Blog
- 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.
- 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
- 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 (22 commands, 9 API modules)
- Banana: AI image generation via Google Gemini for OG images, hero graphics, product photos

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

## Contact
- Author: Daniel Agrici (@AgriciDaniel)
- GitHub: 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-05-25
- License: MIT (skill code) + CC BY 4.0 (FLOW prompts)