Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AgricIDaniel/claude-seo/llms.txt

Use this file to discover all available pages before exploring further.

Claude SEO adds a /seo command to Claude Code that fans 25 sub-skills and 18 specialist agents out in parallel across a target site. This guide covers the fastest path from zero to a running audit — plugin install takes under two minutes; a full site audit completes in 10–15 minutes.

​
Prerequisites

Before you begin, make sure you have:
  • Python 3.10 or higher — the installer checks this automatically and exits with a clear error if the version is too old
  • Claude Code CLI — install from claude.ai/claude-code
  • Git — required for the manual install paths; not needed for the plugin install
No API keys are required to run a full audit. Google API credentials are optional and unlock richer field data. See Optional: Google API setup below.

​
Install Claude SEO

1
Add the plugin to your Claude Code marketplace
2
Inside Claude Code, run:
3
/plugin marketplace add AgriciDaniel/claude-seo
4
This registers the plugin source in your local marketplace so Claude Code knows where to fetch it from.
5
Install the plugin
6
/plugin install claude-seo@agricidaniel-claude-seo
7
The installer downloads the skill files, copies 25 sub-skills to ~/.claude/skills/, places 18 subagent definitions in ~/.claude/agents/, and creates a Python virtual environment at ~/.claude/skills/seo/.venv/. It also attempts to install Playwright Chromium for SPA rendering; if that step fails, the audit falls back to WebFetch automatically.
8
Plugin install requires Claude Code 1.0.33 or later. If you are on an older version, use the manual install method described in the Installation guide.
9
Verify the install
10
ls ~/.claude/skills/seo/SKILL.md
11
If the file is present, the skill is installed correctly. You can also start Claude Code and type /seo to see the command help.
12
Start Claude Code
13
claude
14
You are now ready to run your first audit.

​
Run Your First Audit

With Claude Code running, pass any public URL to /seo audit: 
/seo audit https://example.com
Claude SEO detects the site’s industry (SaaS, local, e-commerce, publisher, or agency), spawns up to 15 specialist agents in parallel, and synthesizes their findings into a prioritized action plan. Watch the agents fan out in real time — technical SEO, content quality, schema validation, AI-search readiness, and more all run simultaneously.

​
Understanding the Output

A completed audit writes several files to your working directory:
FileWhat it contains
FULL-AUDIT-REPORT.mdComplete audit across all sub-skills, structured by discipline
ACTION-PLAN.mdPrioritized recommendations ordered by impact, each with a falsifiability check and a leading indicator
SEO Health ScoreA 0–100 score synthesized from weighted sub-scores across technical SEO (22%), content quality (23%), AI search readiness (10%), schema, local, and more
Each recommendation in ACTION-PLAN.md carries four fields:
  1. First-principle observation — the raw signal the recommendation rests on
  2. Dependency — which other recommendations this one depends on or unlocks
  3. Failure-mode check — “how would we know this failed?”
  4. Leading indicator — the metric to watch after implementing the fix
Open ACTION-PLAN.md and work through Critical findings first. Each one links back to the relevant section of FULL-AUDIT-REPORT.md for the full evidence trail.

​
Five Commands to Try Next

Once you have run your first full audit, explore the individual sub-skills: 
# Parallel sub-agents produce a prioritized action plan
/seo audit https://example.com
The full command reference — all 25 /seo commands with arguments and examples — lives in the Commands documentation.

​
Optional: Google API Setup

Claude SEO works fully offline without any credentials. Adding Google API credentials unlocks richer data at each tier:
TierCredentials neededWhat you gain
0API key onlyPageSpeed Insights, CrUX field data, CrUX History (25-week trend)
1+ OAuth or Service AccountSearch Console queries, URL Inspection, sitemap status, Indexing API
2+ GA4 property configOrganic traffic, top landing pages, device and country breakdown
3+ Ads developer tokenKeyword Planner search volume and competition data
Run the credential setup wizard inside Claude Code: 
/seo google setup
All credentials are stored in ~/.config/claude-seo/ with 0o600 file permissions. Nothing is checked into any repository and nothing is transmitted beyond Google’s own endpoints.
Without Google API credentials, Core Web Vitals scores are lab estimates from Lighthouse rather than field data from CrUX, and indexation status is inferred from page-level signals rather than confirmed via Search Console.

​
What’s Next

  • Installation guide — Manual install on macOS, Linux, and Windows; Playwright setup; uninstall instructions
  • Introduction — Full capability overview, methodology, and the ecosystem of companion skills
  • Commands reference — Every /seo command with arguments, examples, and output descriptions
  • YouTube demo — Watch a full audit with parallel agents fanning out across a real site

Build docs developers (and LLMs) love

Get started for freeTalk to us