trac3r00 SEO Audit
The on-page basics that decide whether a page can rank, in one deterministic check — no browser, no API, no Lighthouse.
Commands
python3 scripts/seo_audit.py dist/index.html
python3 scripts/seo_audit.py dist/*.html --json
curl -s https://example.com | python3 scripts/seo_audit.py - --json
python3 scripts/seo_audit.py page.html --min-score 85
Checks
| Check | Pass | Warn/Fail |
|---|---|---|
title |
10-70 chars, non-empty | fail otherwise |
meta_description |
50-160 chars | fail otherwise |
h1 |
exactly one | fail otherwise |
image_alt |
every image has alt text | fail otherwise |
canonical |
present | warn if missing |
og_tags |
og:title + og:description | warn if missing |
lang |
html lang attribute | warn if missing |
Score = average of check weights (pass=100, warn=60, fail=0). Default gate: exit 1 below 70.
Pairs with
webapp-testing (browser-level QA after the static checks pass),
doc-reader (extract the HTML first if it is buried in a document).