claude-seo

Claude SEO

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.

Installation

One-Command Install (Unix/macOS/Linux)

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

Manual Install

git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
./install.sh

Windows

irm https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.ps1 | iex

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

Command	Description
/seo audit <url>	Full website audit with parallel subagent delegation
/seo page <url>	Deep single-page analysis
/seo sitemap <url>	Analyze existing XML sitemap
/seo sitemap generate	Generate new sitemap with industry templates
/seo schema <url>	Detect, validate, and generate Schema.org markup
/seo images <url>	Image optimization analysis
/seo technical <url>	Technical SEO audit (8 categories)
/seo content <url>	E-E-A-T and content quality analysis
/seo geo <url>	AI Overviews / Generative Engine Optimization
/seo plan <type>	Strategic SEO planning (saas, local, ecommerce, publisher, agency)
/seo programmatic <url>	Programmatic SEO analysis and planning
/seo competitor-pages <url>	Competitor comparison page generation
/seo hreflang <url>	Hreflang/i18n SEO audit and generation

/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