This repository offers a comprehensive, up-to-date knowledge base of Google's SEO guidance, integrated into a self-executing prompt workflow. It transforms AI coding assistants into autonomous SEO auditors, capable of mapping site routes, auditing pages against Google's official rules, and systematically fixing identified gaps. This tool is designed for developers and technical users seeking to automate and rigorously apply SEO best practices directly within their codebase, leveraging battle-tested methodologies.

How It Works

The project combines a curated, cited knowledge base derived from Google Search Central and web.dev, organized into nine key SEO topics, with a 5-phase prompt workflow. This workflow, initiated via START.md, guides an AI assistant to detect the project's technical stack, load the SEO documentation, discover and classify all site routes, perform a detailed 9-point audit on each public page, prioritize necessary fixes, and then apply and verify these changes. This approach ensures that audits and fixes are grounded in official guidance and validated through automated checks.

Quick Start & Requirements

• Primary Install/Run: Option A (AI coding tool): Copy the repository folder into your project and instruct your AI assistant: "Read START.md and run the workflow on this project." Option B (chat assistant): Paste START.md and relevant docs/ content into the chat, provide your codebase, and say "Begin at Phase 0."
• Prerequisites: An AI coding assistant (e.g., Claude Code, Cursor, Copilot, Gemini CLI, Claude, ChatGPT, Gemini web). The workflow automatically detects the project's framework, rendering strategy, and internationalization setup.
• Output: The process generates ROUTES-INVENTORY.md and SEO-AUDIT-PROGRESS.md.
• Links: Google Search Central documentation: https://developers.google.com/search.

Highlighted Details

• Features a complete, up-to-date knowledge base of Google's SEO guidance, distilled from official sources and organized into 9 focused, cited topics.
• Provides an executable, 5-phase prompt workflow designed for autonomous SEO auditing and fixing within AI coding assistants.
• Methodology is battle-tested on a large-scale production site (mcstat.org) with 40 locales and 574K concurrent users.
• The 9-point audit covers critical areas: Metadata, Canonical/hreflang, Robots/indexing, Structured Data, Headings, Images, Internal Links, Rendering/Core Web Vitals, and Sitemaps.
• Incorporates current SEO trends and updates for 2024–2026, including Helpful Content updates and AI Overviews.

Maintenance & Community

The project is authored by Umut Bayraktar (@umutxyp), a full-stack developer with experience in building large-scale applications and AI systems. Pull requests are welcomed for updating rules with source links or adding framework-specific recipes. Contribution guidelines are available in CONTRIBUTING.md.

Licensing & Compatibility

The project is released under the MIT license, which permits commercial use and integration into closed-source projects. The knowledge base content is derived from public Google documentation.

Limitations & Caveats

The effectiveness of the automated workflow is dependent on the capabilities and interpretation of the AI coding assistant used. The README does not specify limitations regarding unsupported platforms or specific framework integrations beyond the auto-detection capabilities.