pi-use-claude-seo

Claude SEO ported to the pi coding agent runtime.

25 SEO skills, 18 subagents, and 30 Python scripts for comprehensive website SEO analysis.

What's Included

| Category | Count | Examples | |----------|-------|---------| | Skills | 25 | Technical SEO, Content/E-E-A-T, Schema, GEO/AI Search, Local SEO, Backlinks, Clustering, Drift Monitoring | | Subagents | 18 | Parallel audit delegation via pi-subagents | | Python Scripts | 30 | Google APIs, DataForSEO, Moz, Bing, Common Crawl, PDF reports, drift baselines | | Extensions | 2 | /seo command registration, schema validation hook |

Install

pi install npm:pi-use-claude-seo

Requirements

• Python 3.10+
• pi-subagents (recommended for parallel audit delegation)

# Install pi-subagents if you don't have it
pi install npm:pi-subagents

Optional Dependencies

# For Google API integration (Search Console, PageSpeed, CrUX, GA4)
pip install google-api-python-client google-auth-oauthlib

# For PDF report generation
pip install weasyprint matplotlib

# For screenshots and visual testing
pip install playwright && python -m playwright install chromium

# For NLP analysis
pip install google-cloud-language

Quick Start

# Start pi
pi

# Full site audit (uses parallel subagents)
/seo audit https://example.com

# Single page analysis
/seo page https://example.com/about

# Technical SEO
/seo technical https://example.com

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

# AI search optimization (GEO)
/seo geo https://example.com

# Local SEO
/seo local https://example.com

# Backlink profile
/seo backlinks https://example.com

# Content quality (E-E-A-T)
/seo content https://example.com

# Strategic planning
/seo plan saas

Commands

| Command | Description | |---------|-------------| | /seo audit <url> | Full website audit with parallel subagent delegation | | /seo page <url> | Deep single-page analysis | | /seo technical <url> | Technical SEO audit (9 categories) | | /seo content <url> | E-E-A-T and content quality analysis | | /seo content-brief <topic> | Generate SEO content brief | | /seo schema <url> | Schema.org detection, validation, generation | | /seo images <url> | Image optimization audit | | /seo sitemap <url> | Sitemap analysis or generation | | /seo geo <url> | AI Overviews / GEO optimization | | /seo plan <type> | Strategic planning (saas, local, ecommerce, publisher, agency) | | /seo programmatic <url> | Programmatic SEO analysis | | /seo competitor-pages <url> | "X vs Y" comparison pages | | /seo local <url> | Local SEO (GBP, NAP, citations, reviews) | | /seo maps <command> | Maps intelligence (geo-grid, GBP audit) | | /seo hreflang <url> | International SEO / hreflang audit | | /seo google <command> <url> | Google APIs (GSC, PageSpeed, CrUX, GA4) | | /seo backlinks <url> | Backlink profile (Moz, Bing, Common Crawl) | | /seo cluster <keyword> | SERP-based semantic clustering | | /seo sxo <url> | Search Experience Optimization | | /seo drift baseline <url> | Capture SEO baseline | | /seo drift compare <url> | Compare against baseline | | /seo ecommerce <url> | E-commerce SEO analysis | | /seo flow <stage> <url> | FLOW framework prompts |

How It Works

Architecture

~/.pi/agent/
├── skills/
│   ├── seo/              # Main orchestrator
│   ├── seo-audit/        # Full audit with subagent delegation
│   ├── seo-technical/    # Technical SEO
│   ├── seo-content/      # E-E-A-T analysis
│   └── ... (25 total)
├── agents/               # pi-subagents agent definitions
│   ├── seo-technical.md  # package: seo
│   ├── seo-content.md
│   └── ... (18 total)
└── extensions/
    ├── seo-setup.ts      # /seo command, script path resolution
    └── seo-schema-validator.ts

Subagent Delegation

Full audits use pi-subagents to run analysis in parallel. Agents are namespaced under seo.*:

subagent({
  tasks: [
    { agent: "seo.seo-technical", task: "Technical audit on https://example.com" },
    { agent: "seo.seo-content", task: "Content quality analysis" },
    { agent: "seo.seo-schema", task: "Schema validation" },
    { agent: "seo.seo-geo", task: "AI search visibility" }
  ],
  concurrency: 4,
  context: "fresh"
})

Without pi-subagents installed, the skills still work — the model reads each sub-skill inline and runs the analysis sequentially.

Script Resolution

The extension sets SEO_SCRIPTS_DIR at session start. When skills reference python scripts/foo.py, use python $SEO_SCRIPTS_DIR/foo.py.

Google API Setup

Rate limit warning: Without an API key, PageSpeed Insights uses a shared anonymous quota (240 QPM per IP). You'll likely hit rate limits on first use. Create a free API key (takes 2 minutes) to get your own quota bucket.

See the auth setup guide for configuring Google Search Console, PageSpeed Insights, CrUX, GA4, and Indexing API.

Quick start (Tier 0 — free, no billing):

1. Go to console.cloud.google.com
2. Create a project, enable PageSpeed Insights API + Chrome UX Report API
3. Create an API key under Credentials
4. Save to ~/.config/claude-seo/google-api.json:

{
  "api_key": "AIzaSy..."
}

5. Verify: python $SEO_SCRIPTS_DIR/google_auth.py --check

4-tier credential system (all free):

| Tier | Auth | APIs | |------|------|------| | 0 | API key | PageSpeed, CrUX, CrUX History | | 1 | + Service Account | + GSC, URL Inspection, Indexing | | 2 | + GA4 config | + GA4 organic traffic | | 3 | + Ads token | + Keyword Planner |

Attribution

Based on claude-seo v1.9.9 by AgriciDaniel. MIT License.

Community contributors: Lutfiya Miller (seo-cluster), Florian Schmitz (seo-sxo), Dan Colta (seo-drift), Chris Muller (seo-hreflang), Matej Marjanovic (seo-ecommerce).

Ported to pi runtime by zzapp.

License

MIT