google-search-ai-optimization

Build and audit web experiences for Google Search generative AI features using Google's official guidance as the baseline.

Decision Tree

What are you doing?

• Implementing SEO/GEO in a codebase

  • Read references/technical-implementation.md
  • Run python3 scripts/audit_page.py --input <url-or-html-file> --expect-indexable

• Planning or editing content for AI Overviews, AI Mode, or query fan-out

  • Read references/google-guidance.md
  • Then read references/content-and-entity-patterns.md

• Working on ecommerce, local business, or agentic user journeys

  • Read references/ecommerce-local-agentic.md