SEO Audit Tool
A Python CLI that validates a site's rendered HTML before it ships, static or server-rendered. It checks the SEO fundamentals (titles, meta, Open Graph, JSON-LD, hreflang, canonical) plus the answer-engine layer: AI-crawler access rules, llms.txt structure, and Core Web Vitals. It runs on every deploy so regressions never reach production.
Project Overview
Search visibility now depends on two audiences: traditional search engines and the AI answer engines (Google AI Overviews, ChatGPT, Perplexity, Claude) that increasingly cite pages directly. The SEO Audit Tool is a Python command-line scanner that checks both, run as a pre-deploy gate so a page is verified before it ever goes live rather than fixed after a ranking drop.
On the classic SEO side it parses the rendered HTML, whether the page is static or server-rendered, and validates title and meta-description length, Open Graph and Twitter cards, JSON-LD structured data, heading hierarchy, image alt text, hreflang relationships, and canonical URLs. Because it reads rendered output rather than guessing from source, it catches issues that only appear in the final DOM.
On the answer-engine side it checks the signals that decide whether AI crawlers can read and cite a site: explicit allow rules for the major AI crawlers in robots.txt, a well-formed llms.txt with the required sections and citation guidance, schema that supports rich and AI results, and snippet eligibility (no nosnippet or max-snippet blocks). It pairs with a Core Web Vitals check so performance regressions are caught in the same pass. The output is a clear pass or fail report wired into deploy scripts, so every site is held to the same standard automatically.
Key Features
Rendered-HTML Validation
Parses the final DOM of static or server-rendered pages so it catches issues that only exist after the page renders, not just in source.
Meta, OG & JSON-LD
Validates title and description length, Open Graph and Twitter cards, and JSON-LD structured data for rich and AI results.
AI-Crawler & llms.txt Checks
Confirms explicit robots.txt allow rules for the major AI crawlers and a well-formed llms.txt with citation guidance for answer engines.
Hreflang & Canonical
Checks bilingual hreflang relationships and canonical URLs so language variants and duplicate URLs are handled correctly.
Core Web Vitals & Snippets
Pairs with a Core Web Vitals pass and snippet-eligibility check (no nosnippet or max-snippet blocks) so performance and citability hold.
Runs on Every Deploy
Wired into deploy scripts as a pass or fail gate, so SEO and AEO regressions are caught before they reach production.
Technology Stack
A Pre-Deploy Standard, Not a One-Off
Because it runs on every deploy across every site, the tool enforces one consistent SEO and answer-engine standard automatically. Issues are caught before launch, not discovered weeks later in a ranking report, which saves time and keeps every property citable by both search and AI engines.
