$git clone https://github.com/umutxyp/Seo-Promt-MasterDrop this repo into your AI coding assistant. It auto-detects the workflow, maps every public route of your site, audits each page against Google's official SEO rules, and fixes the gaps — step by step, nothing left out.
| 1 | <div align="center"> |
| 2 | |
| 3 | # 🔍 SEO Prompt Master |
| 4 | |
| 5 | ### Google SEO — the full docs, as an AI prompt machine. |
| 6 | |
| 7 | **Drop this repo into your AI coding assistant. It auto-detects the workflow, maps every public route of your site, audits each page against Google's official SEO rules, and fixes the gaps — step by step, nothing left out.** |
| 8 | |
| 9 | [](LICENSE) |
| 10 | [](https://developers.google.com/search) |
| 11 | [](#-how-to-use) |
| 12 | [](CONTRIBUTING.md) |
| 13 | |
| 14 | </div> |
| 15 | |
| 16 | --- |
| 17 | |
| 18 | ## What is this? |
| 19 | |
| 20 | **SEO Prompt Master** is two things in one repo: |
| 21 | |
| 22 | 1. **A complete, up-to-date knowledge base** of Google's SEO guidance (`docs/`), distilled from [Google Search Central](https://developers.google.com/search) and [web.dev](https://web.dev), split into 9 focused, cited topics. |
| 23 | 2. **A self-executing prompt workflow** (`START.md` + `prompts/`) that turns any AI coding assistant into an autonomous SEO auditor for **your** codebase. |
| 24 | |
| 25 | You don't read a 200-page guide and try to remember it. You hand the whole thing to your AI, and it does the audit-and-fix loop **for your actual routes**, citing the exact rule behind every change. |
| 26 | |
| 27 | > Built from a real audit of a **40-locale, 574K-concurrent-user** production site ([mcstat.org](https://mcstat.org)) — the methodology is battle-tested, not theoretical. |
| 28 | |
| 29 | --- |
| 30 | |
| 31 | ## 🚀 How to use |
| 32 | |
| 33 | ### Option A — inside an AI coding tool (Claude Code, Cursor, Copilot, Gemini CLI, …) |
| 34 | 1. Copy this folder into your project (or open it alongside your repo). |
| 35 | 2. Tell your assistant: |
| 36 | > **"Read `START.md` and run the workflow on this project."** |
| 37 | 3. It will produce `ROUTES-INVENTORY.md` and `SEO-AUDIT-PROGRESS.md`, then fix issues page by page, verifying as it goes. |
| 38 | |
| 39 | ### Option B — chat assistant (Claude, ChatGPT, Gemini web) |
| 40 | 1. Paste the contents of `START.md` (and, if it fits, the `docs/`). |
| 41 | 2. Give it your repo (zip, paste files, or connect the tool to your codebase). |
| 42 | 3. Say **"Begin at Phase 0."** |
| 43 | |
| 44 | ### Option C — just the knowledge |
| 45 | Read `docs/` as a clean, current reference for Google SEO. Start at [`docs/README.md`](docs/README.md). |
| 46 | |
| 47 | --- |
| 48 | |
| 49 | ## 📂 What's inside |
| 50 | |
| 51 | ``` |
| 52 | seo-prompt-master/ |
| 53 | ├── START.md ← the bootstrap prompt (AI reads this first) |
| 54 | ├── prompts/ ← the 5-phase workflow |
| 55 | │ ├── 00-bootstrap.md detect stack + load knowledge base |
| 56 | │ ├── 01-discover-routes.md enumerate & classify every route |
| 57 | │ ├── 02-audit-page.md 9-point audit per public page |
| 58 | │ ├── 03-prioritize-fixes.md one ordered backlog (infra-first) |
| 59 | │ └── 04-apply-and-verify.md fix + typecheck/lint/build + prove it |
| 60 | ├── docs/ ← the knowledge base (source of truth) |
| 61 | │ ├── 01-meta-and-head.md |
| 62 | │ ├── 02-internationalization.md |
| 63 | │ ├── 03-ugc-forums-blogs.md |
| 64 | │ ├── 04-page-structure.md |
| 65 | │ ├── 05-rendering-and-core-web-vitals.md |
| 66 | │ ├── 06-sitemaps.md |
| 67 | │ ├── 07-image-seo.md |
| 68 | │ ├── 08-structured-data.md |
| 69 | │ └── 09-2024-2026-updates.md |
| 70 | ├── checklists/ ← quick pass/fail lists |
| 71 | │ ├── public-page-checklist.md |
| 72 | │ └── infrastructure-checklist.md |
| 73 | ├── templates/ ← output files the AI fills in |
| 74 | │ ├── routes-inventory.md |
| 75 | │ └── audit-progress.md |
| 76 | └── examples/ ← a worked example |
| 77 | ``` |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## 🧠 The workflow in one picture |
| 82 | |
| 83 | ``` |
| 84 | START.md |
| 85 | │ |
| 86 | ├─ Phase 0 Bootstrap ......... detect framework, rendering, i18n; load docs/ |
| 87 | ├─ Phase 1 Discover .......... list EVERY route → ROUTES-INVENTORY.md |
| 88 | │ classify: public-index / public-noindex / private |
| 89 | ├─ Phase 2 Audit ............. 9-point check per public page → SEO-AUDIT-PROGRESS.md |
| 90 | ├─ Phase 3 Prioritize ........ one backlog, infra-first (P1 → P2 → P3) |
| 91 | └─ Phase 4 Fix & |