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