Read-only SEO HTTP audit with saved evidence
Fetch pages, robots.txt and sitemaps with GET only, keep the raw evidence, and report titles, canonicals, noindex and image crawlability with proof.
What it does
Audits a live site's technical SEO without changing anything.
- Fetches pages,
robots.txtand sitemaps (index to child sitemaps, recursively) and saves bodies, headers, redirects, hashes and timestamps - Extracts title, meta description, canonical, meta robots,
X-Robots-Tag, H1s, image alt text and OG images - Evaluates robots.txt with Google's documented rules (longest match, Allow wins ties) and checks whether images are actually crawlable
- Classifies findings as observed defects, items needing Search Console, or things that are not automatically defects
How to use
python scripts/seo_audit.py https://www.example.com/ --out ./seo-audit
It writes seo-audit/report.json and evidence/. The agent then reports priorities, target URLs, evidence and remedies, citing Google's official documentation.
Requirements
- Python 3 (standard library only)
Notes
- No publishing, CMS edits, Search Console registration or URL submission during the audit.
- Indexing and ranking are never judged without Search Console data.
- Keep concurrency and delays conservative to avoid loading the target site.
How to install
- Unzip the downloaded file (it contains a
readonly-seo-http-audit/folder withSKILL.md). - Copy the whole folder into your agent's skills folder.
- Claude Code:
~/.claude/skills/(per project:.claude/skills/) - Hermes Agent:
~/.hermes/skills/
- Claude Code:
- Restart the agent and check that the skill appears in its skill list.