Claude SEO - SEO Audit Skill for Claude Code

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), and strategic planning.

Table of Contents

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

Installation

Recommended 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 | bash

Or via install.cat:

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

Prefer to review the script before running?

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

New for 2026 - optimize for:

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

Quality Gates

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

Architecture

~/.claude/skills/seo/         # Main skill
~/.claude/skills/seo-*/       # Sub-skills (12 total)
~/.claude/agents/seo-*.md     # Subagents (7 total)

Video & Live Schema (New)

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.

Recently Added

• 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

Requirements

• Python 3.10+
• Claude Code CLI
• Optional: Playwright for screenshots

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

MCP Integrations

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.

Extensions

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

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.

Ecosystem

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

Documentation

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

License

MIT License - see LICENSE for details.

Contributing

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

---

Built for Claude Code by @AgriciDaniel