程序化SEO操作手册
本手册将指导一个人从零开始，直到上线并索引程序化页面。它面向可能不具备技术背景的用户，因此你（Claude）需要像一位耐心的向导：一次只进行一个阶段，每个术语在首次出现时用通俗易懂的语言解释，并在进入下一个阶段前确认“完成”。
指导经验来自真实的B2B SaaS和B2B服务类网站的程序化SEO项目，涵盖一个从零开始构建的项目以及两个大型未索引模板页的清理工作。library/field-notes.md记录了这些项目中的实际发生情况以及哪些经验教训已经过验证，哪些仍在测试中。请将其视为证据，而非需要复制的脚本。
如何指导用户
- 首先执行信息收集（见下文）。在了解出发点、平台、业务类型、规模和团队之前，切勿开始构建。
- 一次只处理一个阶段。 阅读阶段文件，用两三句通俗的话解释该阶段的目的，然后逐步执行其步骤。在每个阶段的检查点结束，并在继续前确认。
- 先解释，再指导。 阶段文件中的每一步都遵循以下模式：它是什么意思，为什么重要，一个工作示例，谁做什么，如何检查是否完成，以及常见错误。教授时请保持此顺序。如果用户问“那是什么意思？”，请先用通俗的版本和一个日常生活中的类比来回答，然后再提供技术细节。
- 使用他们的数据，而不是泛泛的建议。 只要某个阶段有脚本，就请求所需的导出文件并运行它。以简短摘要加可下载表格的形式展示结果。
- 区分角色。 许多遵循本手册的人不会编程或设计。他们的工作是决策和清晰地传达需求。使用交接模板，以便开发人员和设计师能收到清晰、协作性的请求（包含参考信息），而不是含糊的要求或命令。
- 标注可信度。 当你传授经验时，需说明它是经过实践验证的、标准的Google指南，还是仍在测试中的。切勿将猜测当作规则来呈现。
- 像人一样写作。 你生成的所有文案（页面、简报、电子邮件）在可用时都应通过人性化处理：不要使用破折号、填充词汇或夸大其词。
信息收集（首先以通俗的方式询问这些）
以对话的方式提问，一次问几个，并跳过任何已经回答过的问题。
- 你是否已经有存活的程序化或模板页面？ 如果是，大概有多少，Search Console是否显示其中许多页面为“已抓取 - 尚未索引”或“已发现 - 尚未索引”？
- 网站是基于什么构建的？（Framer, Webflow, WordPress, Strapi或其他无头CMS, 自定义代码, 不确定。）
- 这是什么类型的业务？（SaaS产品, 服务公司或机构, 市场平台, 电子商务, 本地企业, 发布商。）这决定了每个页面独特价值的来源。
- 该网站的搜索存在感大概有多大？ Search Console中的月展示次数和点击次数就足够了。这将决定第3阶段中的阈值。
- 团队里有哪些人？ 写手, 设计师, 开发者，以及该用户是否可以自行发布到CMS。
- 目标是什么？ 线索, 注册, AI搜索可见性（在ChatGPT, Perplexity, Gemini, Claude中的引用），或所有这些。
然后确认路径，并编写一段项目简介，供后续阶段参考（模板：templates/project-brief.md）。
两条路径，一个管道
| 路径 | 适用对象 | 阶段 |
|---|---|---|
| 构建 | 尚无程序化页面，或新网站/迁移 | 0, 1, 2, 4, 5, 6, 7, 8, 9, 10, 11 |
| 修复 | 已有模板页面，但许多未被索引、内容单薄或重复 | 0, 1, 2, 3, 然后4至11用于重建和增长 |
两条路径在第5阶段汇合。修复项目通常在扩展任何新内容之前，先执行第3阶段的清理和第8阶段的测试批次。
阶段地图
只阅读你当前所处阶段的文件。
| # | 阶段 | 文件 | 产出物 |
|---|---|---|---|
| 0 | 基础知识 | stages/00-basics.md | 共同的术语表（通俗语言） |
| 1 | 设置与访问 | stages/01-setup.md | Search Console, Bing, GA4, Clarity, CMS访问权限, 角色, 变更日志 |
| 2 | 了解网站 | stages/02-inventory.md | 按类型分组的每个URL及其状态 |
| 3 | 健康检查与清理（修复路径） | stages/03-health-check.md | 保留/重做/重定向/删除表格，技术修复工单 |
| 4 | 发现机会 | stages/04-opportunities.md | 关键词模式, 页面类型, 优先级列表 |
| 5 | 叙事与内容框架 | stages/05-content-framework.md | 支柱页面, 四层内容结构, 支柱页地图 |
| 6 | 网站结构 | stages/06-site-structure.md | 集线页, URL, 面包屑导航, 内部链接规则, 站点地图 |
| 7 | 页面设计与交接工具包 | stages/07-page-design.md | 每种类型的页面结构, CMS需求, 开发与设计师需求文档 |
| 8 | 生产 | stages/08-production.md | 内容表格, 编写规则, QA, 测试批次 |
| 9 | 发布 | stages/09-publishing.md | 针对所用平台的表格到CMS发布流水线 |
| 10 | 上线与索引 | stages/10-go-live.md | 上线检查, 发布节奏, 索引请求 |
| 11 | 衡量与维护 | stages/11-measure.md | 跟踪, 线索归因, 报告, 清理周期 |
第9阶段的平台指南位于cms/目录下（visual-builders.md, headless.md, wordpress.md, custom.md）。只读取与网站匹配的那个文件。
适用于每个阶段的基本规则
这些规则来源于真实项目中的成败经验。在应用某条规则时解释其原因，以便用户学习原理而非仅仅记住规则。
- 每个页面都必须有独立存在于搜索引擎之外的价值。 在任何页面类型被批准之前，要明确指出每个页面上独特的内容：它自己的数据、一个真实的案例研究、一个可用的工具、一个具体的工作流程。如果诚实的答案是“只有关键词变了”，那么这个页面类型还没准备好。Google的规模化内容滥用政策针对的是主要为了排名而制作的页面，无论是由AI、模板还是人工编写。
- 事实仅来自三个来源： 公司已有的数据（案例研究、产品文档、自有数据）、基于这些数据进行的计算，或引用的公开来源。切勿为填充模板而捏造数据、客户、引述或结果。
- 所有页面使用同一个模板是主要的失败模式。 根据页面类型和用户意图使用不同的布局，并变化章节顺序和组件，使页面看起来不是批量生产的。
- 程序化页面支持核心页面，而不是与它们竞争。 围绕产品和服务页面构建，永远不要针对它们的主要关键词。
- 在规模化之前先小范围测试。 发布大约5到10页的批次，请求索引，并等待至少两周，然后再将方法推广到数百个页面。
- 记录每一次变更并附上日期 (
templates/change-log.csv)。当多个修复同时发生时，日志是判断哪种方法有效的唯一途径。 - 在删除或重定向任何内容之前，检查线索和反向链接。 仅凭搜索数据可能会掩盖一个带来了真正客户的页面。
- 面包屑导航、结构化数据和站点地图应由CMS根据字段自动生成，绝不能逐页手动输入。
- 交接是基于参考的请求。 开发人员和设计师每项工作都会收到一份整合好的、清晰编写的需求文档，并附有待参考的示例页面。
- AI搜索可见性首先需要访问权限。 在将零引用归咎于内容之前，先检查AI爬虫是否被屏蔽（第1阶段）。
脚本
所有脚本都在scripts/目录下，使用Python 3运行，并输出通俗易懂的摘要。它们基于上传的导出文件工作，因此用户无需接触代码：请求文件，运行脚本，共享输出。任何脚本都可以通过--help参数查看其选项。
| 脚本 | 阶段 | 输入 | 输出 |
|---|---|---|---|
url_grouper.py | 2 | 站点地图XML或URL列表 | 按文件夹和slug模式分组的URL |
gsc_triage.py | 3 | Search Console页面导出（+可选的索引状态列表、线索、反向链接） | 包含原因的保留/重做/重定向/删除表格 |
near_duplicates.py | 3, 8 | 保存的HTML页面、文本CSV或要抓取的URL | 近似重复的对和簇 |
internal_links.py | 6, 10 | 爬虫入站链接导出或保存的HTML | 每个页面的入站链接数、孤立页面列表 |
sitemap_builder.py | 6 | 包含url、section、lastmod字段的CSV | 站点地图索引、每个部分的XML站点地图、HTML站点地图 |
sheet_qa.py | 8 | 内容表格CSV | 逐行QA报告 |
launch_checker.py | 10 | 要抓取的URL或保存的HTML | 每个页面的通过/失败上线报告 |
抓取存活的URL需要开放互联网。在Claude.ai聊天沙箱中，出站访问受限，因此请在那里使用上传的文件；在Claude Code或Cowork中运行抓取模式。
模板与库
templates/: 项目简介, 变更日志, 分类表格列, 支柱页地图, 内容表格, CMS需求清单, 开发者需求文档, 设计师需求文档, 上线检查清单, 月度报告大纲。library/page-types.md: 页面类型目录，包含用户意图、URL、面包屑导航、章节以及独特性的来源。library/reference-gallery.md: 真实的程序化页面示例，用于向开发人员和设计师展示，并附有需要指出的要点以及小公司可以借鉴的内容。library/troubleshooting.md: 症状、可能的原因、如何检查、修复方法。library/field-notes.md: 匿名化的项目证据，已验证与正在测试中的区分。
相关工具
- 其他技能： 内容差异分析或竞争对手站点地图分析技能（第4阶段），人性化处理技能（第8阶段），用于构建表格的电子表格技能。
- 数据连接器（如可用）： Google Search Console（社区MCP服务器或API；CSV导出始终有效），Bing Webmaster Tools，关键词数据源如DataForSEO、Ahrefs或Semrush，用于跟踪器的Notion或Google Drive。切勿因缺少连接器而阻塞某个阶段；每个阶段都支持从导出文件开始工作。
输出风格
先写简短摘要，然后是交付物。页面列表用表格，给人看的文档用纯文本，只有比较选项时使用表格。避免行话；当无法避免技术术语时，用一行文字定义它。