claude-seo: SEO audit in Claude Code

An agency SEO audit means an invoice that makes your eye twitch and a report "in a couple of weeks". The claude-seo skill runs the audit with a single /seo audit command — free, right in your terminal 🔍

What it is and who it's for

claude-seo (the AgriciDaniel/claude-seo repository) is an open-source plugin skill for Claude Code: 25 sub-skills and 18 specialized sub-agents that pull a site apart in parallel — technical SEO, content quality (E-E-A-T), Schema.org markup, optimization for AI search (GEO/AEO), local SEO, e-commerce and multilingual setups. What you get out isn't a score for the sake of a score, but a prioritized action plan where every recommendation is grounded in Google's primary sources and comes with a check for "how will we know it didn't work".

This is the tool from those viral posts about "a 60-second SEO audit that agencies charge tens of thousands for". Honestly: the author himself promises "minutes instead of hours" for a full site audit — there's not a word about 60 seconds in the repo, but the gist of the posts holds: what used to be a paid service is now one command. The repository was created in February 2026 and gathered ~11.3k GitHub stars in five months; the current release is v2.2.0 (June 2026).

Who it's for: site owners with no SEO budget, vibe coders (the audit lives where the code lives), freelancers and agencies — the author explicitly positions the skill as a way to close out day one with a client using a 15-minute audit and a real 0-100 score.

Key features

• /seo audit <url> — a full site audit: up to 15 sub-agents in parallel, a report with a 0-100 score and a prioritized action plan.
• 25 task-specific commands: /seo page (deep dive on a single page), /seo technical (9 technical SEO categories), /seo content (E-E-A-T against Google's rater guidelines), /seo schema (find/validate/generate JSON-LD), /seo geo (AI Overviews and citability in AI search), /seo backlinks (Moz, Bing, Common Crawl), /seo cluster, /seo local, /seo hreflang, /seo drift (change monitoring with snapshots in SQLite) and more.
• Works without a single API key: the free tier is fully local analysis, zero external requests.
• Optional Google APIs (free quotas): real Core Web Vitals from CrUX (LCP/INP/CLS), Search Console, GA4, PageSpeed — instead of lab estimates.
• Optional paid extensions: DataForSEO (live SERPs and keywords), Ahrefs, SE Ranking, Firecrawl (full-site crawling) — you need accounts with them.
• Reports: Markdown out of the box, PDF optionally (~32 A4 pages).
• MIT license, fine for commercial projects; there's a Codex port too (codex-seo).

Get started in 5 minutes

1. In Claude Code (version 1.0.33+), install it as a plugin:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo

Or by hand: git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git && bash claude-seo/install.sh (needs Python 3.10+; the installer sets up Playwright for SPA rendering itself). 2. Run the audit: /seo audit https://your-site.com — and watch the agents fan out across the site. 3. In a hurry? Start with a single page: /seo page https://your-site.com runs faster than a full audit.

When to use it, and when not to

✅ Use it if you have a site but no SEO budget: a full audit with a fix plan, free, from your own terminal. ✅ Use it if you're vibe coding a site in Claude Code: the skill finds the problems and Claude fixes them in the code right away — meta tags, schema, headings. ✅ Use it if you want verifiable recommendations with links to Google's primary sources rather than "improve your content". ❌ Skip it if you need quick niche or competitor research in a chat with nothing to install — ChatGPT Search or Perplexity (free tier, Pro $20/mo) will answer faster, but they won't truly audit your site. ❌ Skip it if you don't use Claude Code — the skill only lives inside it (there's a separate codex-seo port for Codex). ❌ Skip it as a replacement for rank and backlink monitoring platforms at scale — that's Ahrefs/SE Ranking territory; the skill only hooks them in as extensions.

The honest price

The skill itself is completely free and open source (MIT), no card needed, API keys optional. You only pay for tokens on your Claude subscription or API — and here's the catch: a full audit spins up as many as 15 agents in parallel, which burns a noticeable amount of tokens, and on lower plans you can hit your limits. Extensions are separate: Google APIs are free within their base quotas, while DataForSEO, Ahrefs, SE Ranking and Firecrawl require their own paid accounts. Tag: free / oss.

Gotchas

• The "60-second audit" from the viral posts is marketing: the README talks about minutes for a full audit (still faster than an agency's weeks). The single-page /seo page is the fastest path.
• Without the Google APIs, Core Web Vitals are lab estimates and indexation status is inferred from indirect signals; the repo states this honestly in its Limitations.
• Heavy SPAs that hydrate on scroll or click produce noisy findings — fix that by running the seo-visual sub-agent manually (Playwright snapshot).
• Up to 15 parallel agents means tokens go fast: on a Pro subscription watch your limits, and audit large sites in batches.
• You need Python 3.10+ and the Claude Code CLI — this is a terminal tool, not a web service.
• There's a private "community" version (AI-Marketing-Hub) behind a Skool membership — you don't need it to start: the public MIT version is fully functional without any membership.
• An audit is not traffic: the skill gives you a plan and finds problems, but the content and the actual fixes are on you (though you can hand the code changes straight to Claude).

🤖 Prompt accelerator

"I've installed the claude-seo skill. Run /seo audit https://<MY-SITE>. From the report, pick the top 5 issues by impact on organic traffic. For each one: explain in plain language what's wrong, which file or page to change, and make the changes in the project code right away — meta tags, JSON-LD schema, h1-h2 heading structure, alt text. Don't invent anything: tie every change to a specific recommendation from the report. After the fixes, run /seo page on the homepage and show me the score diff: before and after."