seo-audit

seo-audit

Team Pick
SEO & AEO
Agrici Daniel
One command crawls the site, spawns a specialist agent per area, and hands back a prioritized action plan tied to a health score.
REPO
AgriciDaniel/claude-seo
INSTALL
Claude Code plugin
NEEDS
Python, Playwright
Last updated
August 4, 2026

Preview

seo-audit

What it is.

Claude SEO is a Claude Code plugin holding 25 sub-skills and 18 specialist agents, and seo-audit is the entry point that drives them. It renders the homepage first, works out what kind of business the site is, then follows internal links up to 500 pages while respecting robots.txt.

Then it delegates. Eight agents always run, across technical checks, content quality, schema, sitemaps, performance, visual rendering, AI-search readiness and search experience. Seven more spawn only when the site earns them, so a local service business picks up Google Business Profile and geo-grid checks that a SaaS site skips.

Everything is written under a {domain}-audit folder, and the drift agent compares against a stored baseline once one exists. So the second audit tells you more than the first.

What you get.

  • A health score from 0 to 100, aggregated across every agent that ran
  • A prioritized action plan where each item names the check that produced it
  • Audit files under {domain}-audit, so the next run has something to compare against
  • An optional PDF or HTML report for a client review
  • Drift comparison against a stored baseline once you have run it twice
HOW TO USE IT

How to set it up.

1

Add the marketplace once with /plugin marketplace add AgriciDaniel/claude-seo, then /plugin install claude-seo@agricidaniel-claude-seo.

2

Run /seo setup. It builds an isolated Python environment inside Claude's plugin data and installs Playwright Chromium, so your global packages stay untouched.

3

Check the install with /seo doctor before you point it at a client site.

4

Call the audit with a URL. The homepage gets rendered first, so a JavaScript-heavy site still gets read properly.

5

Leave the crawl at 500 pages for a first pass on a large site, and pull it down when you only care about the money pages.

6

Add Google credentials if you want field data. seo-google only spawns when google_auth.py --check finds them, and it brings in Core Web Vitals from CrUX plus indexation from Search Console.

Pricing Plans

Free. MIT license.

Optional DataForSEO, Moz, Bing and Google keys are billed by those providers. Checked against the repo in July 2026.

Use cases

Scoping before the proposal

A prospect's unfamiliar site lands in your inbox. Point the audit at the URL; you get the business-type read and a scored action plan inside one session, which is enough to price the engagement.

Watching drift week to week

You've audited once and don't want to re-read the same findings. Run it again on the same domain; the drift agent compares against the stored baseline and reports what moved.

A report for the room

The findings need to survive a leadership audience. Ask for the PDF or HTML report; the health score and the plan arrive presentation-shaped, with each item naming the check that produced it.

Adding Google field data

Lab numbers aren't convincing anyone. Add Google credentials before the run; the Google agent spawns and brings Core Web Vitals from CrUX plus indexation from Search Console into the same plan.

Best for

A first pass on an unfamiliar site

You get a business-type read, a crawl, and a scored action plan inside one session, which is enough to scope an engagement before writing a proposal.

Weekly checks on a site you own

The drift agent compares each run against the last stored baseline, so you see what moved instead of re-reading the same findings.

A second opinion before a leadership review

Schema deprecation and AI-citability gaps are the two things Search Console and Lighthouse stay quiet about, and both get their own agent here.

Read the source

Published by Agrici Daniel. Opens in a new tab.
Open the Tool

Questions about seo-audit

Does it need API keys?
How long does a full audit take?
Will it break my Python setup?
Can I run it on Codex?

Questions about SEO & AEO

What does a site crawl add to Search Console data?
How often should a technical audit run?
Strengths
  • Conditional agents mean a SaaS audit doesn't arrive padded with local SEO findings that don't apply.
  • Every recommendation carries a falsifiability check, so a client can test whether the advice held.
  • Built against Google's published AI optimization guide instead of community folklore.
  • MIT licensed, with tagged releases you can pin a client engagement to.
Limitations
  • The setup step installs Playwright Chromium, so budget disk space and a few minutes before the first run.
  • Backlink figures only appear when you supply Moz or Bing credentials, otherwise it falls back to domain-level Common Crawl data.
  • A full audit spawns up to 15 agents at once, which is heavy on a large site and on your token spend.
  • A private community mirror carries early access features, so the public repo trails it.
Skip this if
  • Skip it if you already run a crawl-to-findings audit on a schedule.

The team behind these plays.

We build inbound GTM engines for B2B software teams, and these are the plays we build from. Tell us the pipeline target and we'll show the plan under it.