v2.0 — The SEO + GEO/AEO Playbook

The SEO + GEO/AEO playbook, v2.0

The open-source operating system behind a site that reached 11.08M impressions and 44.8K clicks in 90 days: 7.7× the impressions and 12× the clicks of the previous 90 days. Every number is verifiable in RESULTS.md.

The headline finding

Human-shaped search queries convert at 0.95%. Machine-shaped ones (AI research agents, scrapers, SEO tools) convert at 0.01%, a 95× gap. Blended CTR is no longer a title metric. human-query-split shows which pages are really underperforming for humans.

What's new

• A 6-chapter playbook: GEO & AEO, measurement, the day we noindexed our own site, entity pages, the content refresh system, and automation & cost.
• 6 new tools: human-query-split, matched-control-readout, traffic-guard, sitemap-health, evidence-verifier and rewrite-detector.
• Every script fixed, tested and documented: --help on everything, CI-friendly exit codes, and 146 offline tests running on Node 20/22/24.
• Guidance corrected:
  • the Indexing API is only for job and livestream pages;
  • Google retired the sitemap ping in 2023;
  • FAQ rich results have been restricted since 2023;
  • the sitelinks search box was removed in 2024.

Full list: CHANGELOG.md. The original version is preserved as v1.0.0.

Free and open source (MIT). If it helps you, a ⭐ helps others find it.