有机增长
你在当前项目上运行 PLAYBOOK.md 中的系统。开始时读一次，然后仅在到达使用该模块的阶段时再读取。将每个发现写入项目中的 docs/seo/（从 templates/ 复制模板），并在每个阶段后提交。
地图
| # | 阶段 | 读取 | 项目中的输出 |
|---|---|---|---|
| 0 | 侦察 + 基准 | PLAYBOOK.md §0 | docs/seo/00-baseline.md |
| 1 | 技术 SEO | checklists/technical-seo.md | 代码 + seo.config.mjs |
| 2 | Search Console + Bing | checklists/search-console.md | 基准数据 |
| 3 | 研究：趋势、支付意愿、自动补全、Ahrefs/Semrush、Search Console、来源 | modules/research.md | docs/seo/research/*.md、09-sources-log.md |
| 4 | 增长计划 | modules/pseo-2.md、modules/tool-led-seo.md、modules/money-pages.md、modules/linkable-assets.md | docs/seo/03-seo-plan.md |
| 5 | 清理 + 构建 | PLAYBOOK.md §5、简报 04/07/08 | 页面、重定向、05-consolidation-map.md |
| 6 | GEO + 转化 | modules/geo-ai-search.md、modules/seo-to-revenue.md | robots、页面形状、CTA、事件 |
| 7 | 启动 + 测量 | PLAYBOOK.md §7 | docs/seo/06-launch-log.md |
用户可以只要求一个部分（“仅工具SEO”、“审计我的网站”、“pSEO计划”）。那就只做那个阶段，但还是要先快速运行阶段0。
先询问（仅限代码无法告知的内容）
- 生产域名和首选主机（apex 或 www）。
- 目标国家和语言。 不要从创始人的位置推断。
- Search Console / 分析工具的访问权限。
- 付费关键词工具（Ahrefs、Semrush）。截图或导出文件即可。
- 网站上的任何评分、评论数量或“已被使用”的声明是否真实？
脚本（Node 18+，无依赖项；位于 scripts/）
| 脚本 | 用途 |
|---|---|
check-live.sh <url> | 爬虫从实时站点获取的内容：重定向、404、robots、sitemap、每页的标题/规范链接/H1（无需JS） |
prerender.mjs --config seo.config.mjs | SPA → 每个路由的静态HTML + 404.html + spa.html + sitemap.xml |
audit.mjs <dist> --base <url> | 检查构建的HTML：标题、描述、规范链接、H1、内容稀薄页面、JSON-LD、sitemap一致性、评分Schema |
overlap.mjs <dist> --prefix /<cluster>/ | 重复内容门控：5词分片Jaccard系数，要求<40%且字数≥800 |
autocomplete.mjs "<种子词>" --gl us,gb,au --expand | 按国家获取真实的Google自动补全查询（需求证据） |
硬学到的规则
- 用目标市场的语言进行研究。 错误国家的自动补全曾导致一整批错误市场的页面。
- 每次研究抓取都保存为带日期的文件，放在
docs/seo/research/中，并将每个页面上的事实记录到09-sources-log.md（法律事实的官方来源；竞争对手事实需注明日期并每90天重新检查；不可验证的声明不予记录）。 - Ahrefs的免费工具有人工检查，用户必须通过。要求提供截图，切勿尝试绕过。
- 页面因需求而存在。 每个计划页面都要注明其证据。
- 质量门控不是可选的。 与同类页面重叠度<40%、字数≥800词、拥有自身的数据/工具/输出。模板化的
{城市}替换应使用noindex并排除在sitemap之外。规模化内容惩罚会影响整个域名。 - 工具是页面，不是部件。 每个工具都需要独特的编辑指南、FAQ和静态HTML中的Schema，否则就是内容稀薄页面。
- 更少、更深入的页面。 将内容稀薄的文章合并到深度指南中，并对每个旧slug进行301重定向。
- 不要虚构数字或社会证明。 价格需在页面上注明来源或计算得出；竞争对手事实需注明日期；仅当所有者确认为真实时才使用评分Schema。
- 爬虫（以及AI爬虫）必须能看到内容，且不依赖JavaScript。
- 一个主机、一个URL、真实的404、sitemap与页面数据同源生成。
- 分批发布，每批10-20个；仅扩展获得展示量的部分。
- 每个页面以相关的CTA结尾；按页面组跟踪转化。
工作风格
- 影响生产环境的更改（重定向、robots.txt、noindex、删除页面）需先获得用户一行确认，并附上列表。
- Search Console、DNS和分析点击由用户负责；提供精确的操作步骤。
- 每次构建后运行
audit.mjs，每次部署后运行check-live.sh，并粘贴总结。 - 在
06-launch-log.md中记录带日期的数据，以便下次会话进行比较。
框架
prerender.mjs 适用于客户端渲染的SPA（Vite、CRA、React Router）。Next.js、Astro、Nuxt、SvelteKit、Remix：使用它们的元数据API和sitemap插件，并仍然在构建输出上运行 audit.mjs。WordPress/Webflow/Shopify：跳过阶段1的代码，使用针对实时站点的检查清单配合 check-live.sh。