seo-audit

Everything you need to audit a website's search visibility — completely local.

seo-audit is a free, local & technical SEO audit toolkit for DeepSeek Harness. One command turns a full technical, content, schema, local and generative-engine audit into a weighted, prioritised action plan — no SaaS, no per-domain pricing, no API key for the core audit.

git clone https://github.com/Haniubub/seo-toolkit && cd seo-toolkit && ./setup.sh
./seo audit https://example.com

What it does

split the work cleanly: the measurement layer is deterministic (own Python specialists + 53 curated scripts via ./seo <cmd>), and the judgment layer is LLM-driven (24 sub-skills + 18 specialist agents for E-E-A-T, GEO/AI Overviews, Local/GBP, SXO, schema and more). Every recommendation carries the four claude-seo fields.

LayerWhat it isHow it runs
Measurement5 Python specialists + 53 curated scripts./seo <command>
Judgment24 sub-skills + 18 agent promptsAgent executes via subagent / workflow

The fastest path from URL to action plan

  1. Broad, then deep — ./seo audit <url>, then drill into the highest-impact findings.
  2. Gated multi-agent fan-out — only the agents your site actually needs (~7–10, never all 18).
  3. One weighted score, sorted by dependency, with a falsifiability check per recommendation.
  4. Every recommendation ships with Observation → Dependency → Failure signal → Early indicator.

Coverage

AreaCommand
Technical SEO (9 categories)./seo technical <url>
On-page / content signals./seo page <url>
Schema.org / LocalBusiness./seo schema <url>
Local / NAP signals./seo local <url>
Render, hydration, console errors./seo visual <url>
Sitemap discovery & validation./seo sitemap <url>
QRG content-quality scoring./seo content <url|file>
Free backlink sources./seo backlinks <url>
Keyword clustering./seo cluster <keyword>
Content brief./seo content-brief <topic> [kw]
Drift tracking./seo drift baseline|compare|history <url>
Google APIs (PSI/CrUX/GSC/GA4)./seo google <sub> [args]
Run any of the 53 scripts./seo run <script.py> [args]

Frequently asked questions

Is seo-audit free?
Yes — MIT-licensed and local. The core audit needs no API key, no account and no domain pricing; only Python 3.10+, requests, beautifulsoup4, lxml and Playwright.
Does it need Claude Code or a subscription?
No. It's a self-contained port of claude-seo and runs standalone — no Claude Code, no plugin marketplace, no third-party SaaS.
Does it work without a Google API key?
The core audit works fully without any key. Google APIs (PageSpeed, CrUX, GSC, GA4), DataForSEO, Firecrawl, Ahrefs, Bing and Banana are ported but only activate once you supply their own credentials.
What are the four claude-seo fields?
Observation → Dependency → Failure signal → Early indicator. Field 2 sets the order, field 3 tells you how you'd know it worked, field 4 is the leading signal to watch.