Claude SEO - SEO Audit Skill for Claude Code

SEO analysis plugin for Claude Code. 25 sub-skills (21 core + 1 orchestrator + 1 framework integration + 2 extension mirrors) and 18 sub-agents (15 core + 1 framework integration + 2 extension mirrors) covering technical SEO, on-page analysis, content quality (E-E-A-T), content briefs, schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO, maps intelligence, semantic topic clustering, search experience optimization (SXO), SEO drift monitoring, e-commerce SEO, international SEO with cultural profiles, FLOW framework integration, Google SEO APIs (Search Console, PageSpeed, CrUX, GA4), PDF report generation, and strategic planning.

Using Codex instead of Claude Code? Use Codex SEO, the Codex-first port of this project with Codex skills, TOML agents, plugin packaging, deterministic runners, and the same SEO workflow surface.

Table of Contents

• Installation
• Quick Start
• Commands
• Features
• Architecture
• Limitations
• Requirements
• Uninstall
• Extensions
• Ecosystem
• Documentation
• Community Contributors
• License
• Contributing
• Author

Installation

Plugin Install (Claude Code 1.0.33+)

# Add marketplace (one-time)
/plugin marketplace add AgriciDaniel/claude-seo

# Install plugin
/plugin install claude-seo@agricidaniel-seo

Manual Install (Unix/macOS/Linux)

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 > install.sh
cat install.sh        # review
bash install.sh       # run when satisfied
rm install.sh

Windows (PowerShell)

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.

Quick Start

# 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

Demo:

Watch the full demo on YouTube

/seo audit: full site audit with parallel subagents:

Commands

/seo programmatic [url|plan]

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

/seo competitor-pages [url|generate]

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

/seo hreflang [url]

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)

Features

Core Web Vitals (Current Metrics)

• 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 removed from all Chrome tools on September 9, 2024.

E-E-A-T Analysis

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

Schema Markup

• 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)

AI Search Optimization (GEO)

Optimize for:

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

Google SEO APIs

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: A4 reports with charts via WeasyPrint and matplotlib

4-tier credential system. Get value at every level:

Local SEO and Maps Intelligence

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

Quality Gates

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

Architecture

~/.claude/plugins/.../skills/seo/      # Main orchestrator
~/.claude/plugins/.../skills/seo-*/    # 25 sub-skills (auto-discovered)
~/.claude/plugins/.../agents/seo-*.md  # 18 sub-agents (auto-discovered)

Video and Live Schema

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 and 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. Full release history in CHANGELOG.md.

Limitations

Sites that render content client-side without server-side rendering will produce false-negative findings on content, schema, headings, and meta in most subagents. The orchestrator and most subagents fetch raw HTML rather than executing JavaScript, so a single-page application that hydrates content in the browser will appear empty to the auditor.

If your target site is an SPA without SSR (typical patterns: Vite/CRA React without prerender, client-only Vue/Angular, frameworks where the initial HTML response is largely an empty shell), use a tool that performs browser-rendered fetching for the audit. The seo-visual subagent does use Playwright when available and can verify that visible content matches what the raw-HTML subagents see; expect divergence on SPA targets.

Tracked as the v2.0 epic in #11.

Requirements

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

Uninstall

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

Extensions

Optional add-ons that integrate external data sources via MCP servers. The plugin works with 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 details.

DataForSEO

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.

Banana (AI Image Generation)

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.

Firecrawl (Site Crawling)

Full-site crawling and URL discovery using the Firecrawl MCP server.

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

# Example commands
/seo firecrawl crawl https://example.com
/seo firecrawl map https://example.com

See Firecrawl Extension for full documentation.

Ecosystem

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

Workflow example:

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

Documentation

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

Community Contributors

v1.9.0 includes contributions from the AI Marketing Hub Pro Hub Challenge:

See CONTRIBUTORS.md for full details and original repo links.

License

MIT License - see LICENSE for details.

Contributing

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

Author

Built by Agrici Daniel, AI Workflow Architect.

• Blog: deep dives on AI marketing automation
• YouTube: tutorials and demos
• All open-source tools