Comprehensive SEO analysis skill for Claude Code. Covers technical SEO, on-page analysis, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO, maps intelligence, Google SEO APIs (Search Console, PageSpeed, CrUX, GA4), PDF report generation, and strategic planning.

• Installation
• Quick Start
• Commands
• Features
• Architecture
• Extensions
• Ecosystem
• Documentation
• Requirements
• Uninstall
• Contributing

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash

curl -fsSL install.cat/AgriciDaniel/claude-seo | bash

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh        # review
bash install.sh       # run when satisfied
rm install.sh

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

Why git clone instead of irm | iex? Claude Code's own security guardrails flag irm ... | iex as a supply chain risk (downloading and executing remote code with no verification). The git clone approach lets you inspect the script at claude-seo\install.ps1 before running it.

# Start Claude Code
claude

# Run a full site audit
/seo audit https://example.com

# Analyze a single page
/seo page https://example.com/about

# Check schema markup
/seo schema https://example.com

# Generate a sitemap
/seo sitemap generate

# Optimize for AI search
/seo geo https://example.com

Watch the full demo on YouTube

/seo audit: full site audit with parallel subagents:

Programmatic SEO Analysis & Planning

Build SEO pages at scale from data sources with quality safeguards.

Capabilities:

• Analyze existing programmatic pages for thin content and cannibalization
• Plan URL patterns and template structures for data-driven pages
• Internal linking automation between generated pages
• Canonical strategy and index bloat prevention
• Quality gates: WARNING at 100+ pages, HARD STOP at 500+ without audit

Competitor Comparison Page Generator

Create high-converting "X vs Y" and "alternatives to X" pages.

Capabilities:

• Structured comparison tables with feature matrices
• Product schema markup with AggregateRating
• Conversion-optimized layouts with CTA placement
• Keyword targeting for comparison intent queries
• Fairness guidelines for accurate competitor representation

Hreflang / i18n SEO Audit & Generation

Validate and generate hreflang tags for multi-language sites.

Capabilities:

• Generate hreflang tags (HTML, HTTP headers, or XML sitemap)
• Validate self-referencing tags, return tags, x-default
• Detect common mistakes (missing returns, invalid codes, HTTP/HTTPS mismatch)
• Cross-domain hreflang support
• Language/region code validation (ISO 639-1 + ISO 3166-1)

• LCP (Largest Contentful Paint): Target < 2.5s
• INP (Interaction to Next Paint): Target < 200ms
• CLS (Cumulative Layout Shift): Target < 0.1

Note: INP replaced FID on March 12, 2024. FID was fully removed from all Chrome tools on September 9, 2024.

Updated to September 2025 Quality Rater Guidelines:

• Experience: First-hand knowledge signals
• Expertise: Author credentials and depth
• Authoritativeness: Industry recognition
• Trustworthiness: Contact info, security, transparency

• Detection: JSON-LD (preferred), Microdata, RDFa
• Validation against Google's supported types
• Generation with templates
• Deprecation awareness:
  • HowTo: Deprecated (Sept 2023)
  • FAQ: Restricted to gov/health sites (Aug 2023)
  • SpecialAnnouncement: Deprecated (July 2025)

New for 2026 - optimize for:

• Google AI Overviews
• ChatGPT web search
• Perplexity
• Other AI-powered search

Direct integration with Google's SEO data:

• PageSpeed Insights + CrUX: Lab and field Core Web Vitals data
• Search Console: Top queries, URL inspection, sitemap status
• Indexing API: Notify Google of new/updated/removed URLs
• GA4: Organic traffic, top landing pages, device/country breakdown
• PDF Reports: Enterprise A4 reports with charts via WeasyPrint + matplotlib

4-tier credential system — get value at every level:

• Google Business Profile optimization
• NAP consistency auditing
• Citation and review analysis
• Geo-grid rank tracking and competitor radius mapping

• Warning at 30+ location pages
• Hard stop at 50+ location pages
• Thin content detection per page type
• Doorway page prevention

~/.claude/skills/seo/         # Main orchestrator skill
~/.claude/skills/seo-*/       # Sub-skills (15 + 2 extensions)
~/.claude/agents/seo-*.md     # Subagents (10 + 2 extensions)

Additional schema types for video content, live streaming, and key moments:

• VideoObject: Video page markup with thumbnails, duration, upload date
• BroadcastEvent: LIVE badge support for live streaming content
• Clip: Key moments / chapters within videos
• SeekToAction: Enable seek functionality in video rich results
• SoftwareSourceCode: Open source and code repository pages

See schema/templates.json for ready-to-use JSON-LD snippets.

• Programmatic SEO skill (/seo programmatic)
• Competitor comparison pages skill (/seo competitor-pages)
• Multi-language hreflang validation (/seo hreflang)
• Video & Live schema types (VideoObject, BroadcastEvent, Clip, SeekToAction)
• Google SEO quick-reference guide

• Python 3.10+
• Claude Code CLI
• Optional: Playwright for screenshots
• Optional: Google API credentials for enriched data (see /seo google setup)

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash

Integrates with MCP servers for live SEO data, including official servers from Ahrefs (@ahrefs/mcp) and Semrush, plus community servers for Google Search Console, PageSpeed Insights, and DataForSEO. See MCP Integration Guide for setup.

Optional add-ons that integrate external data sources via MCP servers.

Live SERP data, keyword research, backlinks, on-page analysis, content analysis, business listings, AI visibility checking, and LLM mention tracking. 22 commands across 9 API modules.

# Install (requires DataForSEO account)
./extensions/dataforseo/install.sh

# Example commands
/seo dataforseo serp best coffee shops
/seo dataforseo keywords seo tools
/seo dataforseo backlinks example.com
/seo dataforseo ai-mentions your brand
/seo dataforseo ai-scrape your brand name

See DataForSEO Extension for full documentation.

Generate SEO images (OG previews, blog heroes, product photos, infographics) using the Claude Banana Creative Director pipeline.

# Install extension
./extensions/banana/install.sh

# Example commands
/seo image-gen og "Professional SaaS dashboard"
/seo image-gen hero "AI-powered content creation"
/seo image-gen batch "Product photography" 3

See Banana Extension for full documentation. Already using standalone Claude Banana? The extension reuses your existing nanobanana-mcp setup.

Claude SEO is part of a family of Claude Code skills that work together:

Workflow example:

1. /seo audit https://example.com -- identify content gaps and image issues
2. /blog write "target keyword" -- create SEO-optimized blog posts
3. /seo image-gen hero "blog topic" -- generate hero images (banana extension)
4. /seo geo https://example.com/blog/post -- optimize for AI citations

• Installation Guide
• Commands Reference
• Architecture
• MCP Integration
• Troubleshooting

MIT License - see LICENSE for details.

Contributions welcome! Please read CONTRIBUTING.md before submitting PRs.

Built for Claude Code by @AgriciDaniel