Universal Agentic SEO Toolkit

AI-powered SEO analysis and ranking engine that works with any agentic coding assistant — Antigravity, Cursor, Windsurf, Claude Code, and more. Auto-detects your environment and adapts its branding.

Features

Category	Commands	What It Does
Technical Audit	audit, page, geo	Full SEO audit, HTML analysis, AI search readiness
Performance	vitals, speed	Core Web Vitals (LCP, CLS, FCP, TTFB), speed fix suggestions
Competitive Intel	discover, compare, keywords	Auto-find competitors from Google, keyword gap analysis
Content Strategy	content, brief, plan	Content scoring, writing briefs, content calendar
SERP Targeting	serp	Detect Featured Snippets, PAA, FAQ + schema generation
Site Architecture	crawl, links	Multi-page sitemap crawl, internal link graph optimizer
Monitoring	track	Keyword rank tracking with position history
Reporting	report, fix	PDF report generation, auto-generate code fixes

Installation

Prerequisites

pip install requests beautifulsoup4 playwright
playwright install chromium

Clone

git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
pip install -r requirements.txt
playwright install chromium

Windows (PowerShell)

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

Quick Start

# Full SEO audit
python scripts/seo_toolkit.py audit https://example.com --output audit.json

# Generate PDF report
python scripts/seo_toolkit.py report audit.json --output report.pdf

# Discover your competitors
python scripts/seo_toolkit.py discover "your target keyword"

# Score your content vs top-ranking pages
python scripts/seo_toolkit.py content https://yoursite.com -k "target keyword"

# Core Web Vitals
python scripts/seo_toolkit.py vitals https://example.com

# SERP features + schema generation
python scripts/seo_toolkit.py serp "target keyword"

# Crawl entire site
python scripts/seo_toolkit.py crawl https://example.com --max-pages 20

All Commands

Technical Audit

python scripts/seo_toolkit.py audit <url> [-o file.json]     # Full SEO audit
python scripts/seo_toolkit.py page <url>                      # Single page HTML analysis
python scripts/seo_toolkit.py geo <url>                       # AI search visibility (GEO)

Performance

python scripts/seo_toolkit.py vitals <url> [-o file.json]    # LCP, CLS, FCP, TTFB
python scripts/seo_toolkit.py speed <url> [-o file.json]     # Speed fixes & suggestions

Competitive Intelligence

python scripts/seo_toolkit.py discover "<keyword>"            # Find top 10 competitors
python scripts/seo_toolkit.py compare <url1> <url2> [url3..]  # Side-by-side comparison
python scripts/seo_toolkit.py keywords <url> -k "<keyword>"   # Keyword gap analysis

Content Strategy

python scripts/seo_toolkit.py content <url> -k "<keyword>"    # Content score vs competitors
python scripts/seo_toolkit.py brief "<keyword>"                # Content writing brief
python scripts/seo_toolkit.py plan <site> -k "<keyword>"      # Content calendar

SERP & Schema

python scripts/seo_toolkit.py serp "<keyword>"                # SERP feature detection

Site Architecture

python scripts/seo_toolkit.py crawl <url> [--max-pages 20]   # Multi-page crawl
python scripts/seo_toolkit.py links <url> [--max-pages 15]   # Internal link optimizer

Monitoring & Reporting

python scripts/seo_toolkit.py track <site> -k "kw1, kw2"     # Rank tracker
python scripts/seo_toolkit.py report <audit.json> [-o file.pdf]  # PDF report
python scripts/seo_toolkit.py fix <audit.json>                # Auto-generate code fixes

Universal Agent Support

The toolkit auto-detects which agentic coding assistant you're running in and adapts its branding:

Agent	Detection	Theme
Antigravity	ANTIGRAVITY_AGENT env var	Purple
Cursor	CURSOR_* or VS Code env vars	Blue
Windsurf	WINDSURF_* env vars	Teal
Claude Code	CLAUDE_* env vars	Orange
Generic	Fallback	Green

MCP Server

For agents that support MCP (Model Context Protocol):

{
  "mcpServers": {
    "seo": {
      "command": "python",
      "args": ["scripts/mcp_server.py"]
    }
  }
}

Architecture

scripts/
├── seo_toolkit.py           # Main CLI router (15+ commands)
├── fetch_page.py             # HTTP fetcher with SSRF protection
├── parse_html.py             # HTML parser (SEO signals extraction)
├── analyze_geo.py            # AI search readiness (GEO)
├── analyze_visual.py         # Visual/screenshot analysis
├── analyze_vitals.py         # Core Web Vitals via Playwright
├── analyze_competitor.py     # Side-by-side comparison
├── analyze_keywords.py       # Keyword gap analysis (TF-IDF)
├── discover_competitors.py   # Google/Bing SERP scraper
├── detect_serp_features.py   # SERP feature detection + schema
├── score_content.py          # Content optimization scoring
├── crawl_sitemap.py          # Multi-page sitemap crawler
├── optimize_links.py         # Internal link graph optimizer
├── optimize_speed.py         # Speed analysis + fix suggestions
├── generate_brief.py         # Content writing brief generator
├── generate_content_plan.py  # Content calendar generator
├── generate_report.py        # PDF report generator
├── generate_fixes.py         # Auto-fix code generator
├── track_rank.py             # Keyword rank tracker
├── capture_screenshot.py     # Page screenshot utility
└── mcp_server.py             # MCP server for agent integration

License

MIT — see LICENSE