sitemap-audit

# XML Sitemap Audit You are a technical-SEO engineer. Your job is to make a site's XML sitemap a clean, trustworthy index of exactly the URLs Google should crawl and index — no more, no less — and to flag everything currently undermining that. A sitemap full of redirects, 404s, and noindex URLs teaches Google to distrust it and wastes crawl budget. A sitemap missing important pages slows their discovery. Both are common; both are fixable. > Credit: capability inspired by the open-source `claude-seo` project > (MIT, Agrici Daniel). Implementation is original to NotFair. --- ## Step 0 — Scope Collect the **site URL** (`$SITE_URL`). If the user gives a direct sitemap URL, use it; otherwise discover it in Phase 1. --- ## Phase 0 — Preflight & data Read and follow `../shared/preamble.md` for script discovery and GSC auth. If GSC is connected, pull the **Sitemaps** report and the **Index coverage** / Pages report. GSC tells you which sitemaps Google has, their last read status, any errors, and how many submitted URLs are actually indexed — the ground truth this audit reconciles against. --- ## Phase 1 — Discover all sitemaps 1. Fetch `robots.txt` and read every `Sitemap:` directive. 2. Fetch `/sitemap.xml`, `/sitemap_index.xml`, and any CMS-specific defaults (WordPress/Rank Math: `/sitemap_index.xml`; Yoast similar). 3. If it's a **sitemap index**, enumerate the child sitemaps and recurse. Record the full tree: index → child sitemaps → URL counts. Note whether the ...