程序化 SEO(Programmatic SEO)规模化建站实战:基于 SEO Machine 的模板化页面体系搭建指南
程序化 SEO(Programmatic SEO)规模化建站实战:基于 SEO Machine 的模板化页面体系搭建指南
程序化 SEO(Programmatic SEO,简称 pSEO)是通过"模板 + 数据"批量生成 SEO 优化页面的规模化内容策略,它要求每一页都提供真实价值、避免内容稀薄(Thin Content)处罚,并在关键词模式、数据护城河与内部链接架构上做系统化设计。本文以开源项目 SEO Machine 中内置的 programmatic-seo 技能(.claude/skills/programmatic-seo/SKILL.md)为骨架,结合其配套的 12 大 Playbook 参考文档与仓库内的 Python 分析模块、SEO 指南等源码级实现,完整讲解从机会评估、Playbook 选型、模板设计到上线质量检查的全流程,读完即可在自己的 Claude Code 工作区中落地一套可复用的规模化建站方法。
什么是程序化 SEO:为什么"模板 + 数据"能规模化
程序化 SEO 的核心定义是:使用模板和数据批量构建 SEO 优化页面,让有限的编辑人力覆盖成千上万个长尾关键词页面。其目标有三个,缺一不可:
- 让页面获得排名——每页对应一个真实的搜索意图与关键词模式;
- 为用户提供价值——模板只是骨架,数据与内容差异才是血肉;
- 避免内容稀薄处罚——杜绝"换城市名生成 1 万页雷同内容"的经典翻车姿势。
在 SEO Machine 中,这一能力被封装为一个独立的 Claude Code 技能,其 Frontmatter 中的 description 明确了触发场景:当用户提到 "programmatic SEO"、"template pages"、"pages at scale"、"directory pages"、"location pages"、"keyword] + [city] pages"、"comparison pages"、"integration pages" 或 "building many pages for SEO" 时自动启用。这与仓库主 README([README.md)中对技能体系的定位一致——它是 26 个营销技能中 SEO 分类下的四个技能之一(/seo-audit、/schema-markup、/programmatic-seo、/competitor-alternatives),专门负责"规模化建页面",而审计与结构化数据由另外两个技能承接。
关键提示:本文讨论的是"批量新建页面"的方法论;如果你要做的是已上线页面的 SEO 诊断,应转向 seo-audit 技能;如果要为这些页面补充结构化数据,则参考 schema-markup 技能。
动手之前:初始评估的三步侦察
在设计任何程序化 SEO 策略之前,技能要求先完成三类上下文收集。如果工作区中存在 .claude/product-marketing-context.md,应当先读它,只针对文档未覆盖的信息提问,避免重复打扰。
1. 业务背景(Business Context)
- 产品/服务是什么?
- 目标受众是谁?
- 这批页面的转化目标是什么?
例如在仓库自带的 Castos 示例(examples/castos/)中,业务是播客托管 SaaS,转化目标自然是让访客注册托管服务,那么 Location、Comparison、Glossary 等 Playbook 的 CTA 设计都应围绕"注册/试用托管"展开。
2. 机会评估(Opportunity Assessment)
- 存在哪些搜索模式(关键词的重复结构)?
- 潜在页面数量级是多少?
- 搜索量的分布形态(头部词 vs 长尾词)如何?
这一步决定了项目值不值得做、做多大。技能原文特别强调要评估"search volume distribution"(搜索量分布),因为只有长尾足够厚实,规模化才有意义——这与仓库中 opportunity_scorer.py 的 8 因子机会评分思路一脉相承(体积 25%、位置 20%、意图 20%、竞争 15%、集群 10%、CTR 5%、新鲜度 5%、趋势 5%),底层逻辑都是"先量化机会,再投入产能"。
3. 竞争格局(Competitive Landscape)
- 这些词当前谁在排名?
- 他们的页面长什么样?
- 你现实中有没有可能竞争?
技能的判断标准很务实:竞争评估的结论必须是"可以现实地竞争",而不是"理论上能写 10 万页"。若头部结果全部是权威站点(如政府、大学、巨头官网),pSEO 页面上位难度极高,应谨慎立项。
六大核心原则:程序化 SEO 的底层纪律
原则 1:每一页都必须有独特价值
- 每页必须提供该页特有的价值;
- 不能只是模板里换几个变量;
- 独特内容最大化——差异化越强越好。
这是整个技能的最高优先级原则,也是对抗"内容稀薄"的唯一解药。从仓库源码看,SEO Machine 的 keyword_analyzer.py 会计算关键词密度、检测关键词堆砌风险并输出"distribution heatmap"(分布热力图),正是为了在成文阶段强制检查"内容是否真的围绕该页主题展开",而非变量空转。
原则 2:专有数据制胜——数据护城河的五个层级
技能的"数据可防御性"层级(Hierarchy of data defensibility)从强到弱:
| 层级 | 类型 | 说明 | 强弱 |
|---|---|---|---|
| 1 | Proprietary(自有) | 你自己创造的数据 | 最强 |
| 2 | Product-derived(产品衍生) | 来自你的用户行为/产品数据 | 强 |
| 3 | User-generated(用户生成) | 社区、UGC 内容 | 中 |
| 4 | Licensed(授权) | 独家授权数据 | 中 |
| 5 | Public(公开) | 谁都能用 | 最弱 |
这个层级直接决定了你的页面能不能建立别人抄不走的差异。公开数据(如天气、行政区划)人人可得,很难靠它做出护城河;而产品衍生数据(如 SaaS 内部的模板使用量、排行榜)则天然稀缺。选 Playbook 时,数据来源是首要约束条件(详见下文选型表)。
原则 3:干净的 URL 结构——用子文件夹,不要用子域名
技能给出硬性规范:
- 好的写法:
yoursite.com/templates/resume/ - 差的写法:
templates.yoursite.com/resume/
子域名在链接权重传递、品牌信任与维护成本上均劣于子文件夹,且容易造成内容被搜索引擎视为独立站点。同时,seo-audit 技能 的 URL 审计标准(可读、描述性、统一小写与连字符、无多余参数)也适用于这些批量页面,建议两套规范一起落地。
原则 4:真实匹配搜索意图
页面必须真正回答人们搜索的问题。程序化页面最容易犯的错是"模板对了、意图错了"——例如"resume template"是下载/使用的交易与信息混合意图,而"what is pSEO"是纯信息意图,两者的页面结构(工具型 vs 定义型)完全不同。仓库的 search_intent_analyzer.py 会把查询分类为 informational / navigational / transactional / commercial 四类并提供置信度评分,可用于在模板设计阶段预先校验意图匹配。
原则 5:质量优先于数量
宁可做 100 个优质页面,也不要 1 万个薄页面。 这是技能反复强调的护栏。仓库的 seo-guidelines.md 同样贯彻了这一思想:"不要为了凑字数注水""2,000 字有价值的内容好过 3,000 字注水内容"——对程序化页面而言,这个"有价值"的要求应落实到每一页的数据与叙述都真实、独特。
原则 6:避免 Google 处罚
- 禁止 Doorway Pages(门页/桥页);
- 禁止关键词堆砌;
- 禁止重复内容;
- 必须对用户有真实效用。
seo-guidelines.md 给出了关键词堆砌的反例,可直接作为模板质量的判别基准:
❌ "Podcast hosting is important. Podcast hosting helps podcasters. Our podcast hosting platform offers podcast hosting services for podcast hosting needs."
✅ "Podcast hosting is important for creators who want to distribute their show to major platforms. A reliable host ensures your episodes are accessible wherever listeners discover new content."
12 大 Playbook 全景:每种模式的定位、价值与 URL 结构
技能把成熟的程序化 SEO 打法归纳为 12 种 Playbook,并配有专门的参考文档 references/playbooks.md。先看概览表:
| Playbook | 模式 | 示例 |
|---|---|---|
| Templates | "[Type] template" | "resume template" |
| Curation | "best [category]" | "best website builders" |
| Conversions | "[X] to [Y]" | "$10 USD to GBP" |
| Comparisons | "[X] vs [Y]" | "webflow vs wordpress" |
| Examples | "[type] examples" | "landing page examples" |
| Locations | "[service] in [location]" | "dentists in austin" |
| Personas | "[product] for [audience]" | "crm for real estate" |
| Integrations | "[product A] [product B] integration" | "slack asana integration" |
| Glossary | "what is [term]" | "what is pSEO" |
| Translations | 多语言内容 | Localized content |
| Directory | "[category] tools" | "ai copywriting tools" |
| Profiles | "[entity name]" | "stripe ceo" |
1. Templates(模板)
- 模式:
"[Type] template"或"free [type] template",例:resume template、invoice template、pitch deck template - 本质:用户可直接下载或交互使用的模板资产
- 为什么有效:意图极强(用户当下就需要);可分享、可外链;天然适合产品驱动型公司
- 价值要求:模板必须真的可用(不能只是预览);每种类型提供多个变体;质量对标付费产品;下载/使用流程顺畅
- URL 结构:
/templates/[type]/或/templates/[category]/[type]/
2. Curation(策展榜单)
- 模式:
"best [category]"或"top [number] [things]",例:best website builders、top 10 crm software - 本质:对某品类做推荐排序的策展列表
- 为什么有效:比价型搜索者高度商业意图;常青内容可持续更新
- 价值要求:有真实的评估标准;有实际测试或专业经验;定期更新并展示日期;不能是纯联盟驱动的排名
- URL 结构:
/best/[category]/或/[category]/best/
3. Conversions(单位换算)
- 模式:
"[X] to [Y]"或"[amount] [unit] in [unit]",例:$10 USD to GBP、100 kg to lbs、pdf to word - 本质:格式、单位、货币之间的换算工具或页面
- 为什么有效:即时效用;搜索量极大;有重复使用潜力
- 价值要求:数据准确且实时;工具快速可用;推荐相关换算;移动端友好
- URL 结构:
/convert/[from]-to-[to]/或/[from]-to-[to]-converter/
4. Comparisons(对比页)
- 模式:
"[X] vs [Y]"或"[X] alternative",例:webflow vs wordpress、notion vs coda、figma alternatives - 本质:产品/工具/选项之间的头对头对比
- 为什么有效:高购买意图;搜索模式清晰;随竞品数量线性扩展
- 价值要求:诚实平衡的分析;真实的特性对比数据;按使用场景给出明确推荐;产品变化时及时更新
- URL 结构:
/compare/[x]-vs-[y]/或/[x]-vs-[y]/ - 延伸:仓库还提供独立的 competitor-alternatives 技能,专门覆盖"单一替代、复数替代、你 vs 竞品、竞品 vs 竞品"四种对比页格式,含模块化内容架构与"单一事实源"(single source of truth)数据设计,是做对比页的深度补充框架。
5. Examples(示例集)
- 模式:
"[type] examples"或"[category] inspiration",例:saas landing page examples、email subject line examples - 本质:真实世界示例的图集/合集
- 为什么有效:研究阶段流量;高度可分享;天然适合设计/创意工具
- 价值要求:真实高质量示例;截图或嵌入;分类/筛选;附带"为什么有效"的分析
- URL 结构:
/examples/[type]/或/[type]-examples/
6. Locations(本地页)
- 模式:
"[service/thing] in [location]",例:coworking spaces in san diego、dentists in austin - 本质:服务/商家/信息的本地化页面
- 为什么有效:本地意图流量巨大;随地理范围扩展;天然适合市场/目录型产品
- 价值要求:必须有真实本地数据(不能只换城市名);列出本地供应商/选项;本地化洞察(价格、法规);地图集成有帮助
- URL 结构:
/[service]/[city]/或/locations/[city]/[service]/
7. Personas(人群页)
- 模式:
"[product] for [audience]"或"[solution] for [role/industry]",例:payroll software for agencies、crm for real estate - 本质:面向特定人群定制的落地页
- 为什么有效:直接对话搜索者的处境;比泛化页面转化更高;随人群数量扩展
- 价值要求:真实的人群专属内容;突出相关功能;该人群的客户证言;人群专属用例
- URL 结构:
/for/[persona]/或/solutions/[industry]/
8. Integrations(集成页)
- 模式:
"[your product] [other product] integration",例:slack asana integration、hubspot salesforce sync - 本质:解释你的产品如何与其他工具协同的页面
- 为什么有效:截获其他产品的用户流量;高意图(他们正需要解决方案);随集成生态扩展
- 价值要求:真实的集成细节;配置步骤;组合用例;集成必须真实可用(不能是 vaporware)
- URL 结构:
/integrations/[product]/或/connect/[product]/
9. Glossary(术语表)
- 模式:
"what is [term]"/"[term] definition"/"[term] meaning",例:what is pSEO、api definition - 本质:行业术语与概念的教育型定义
- 为什么有效:漏斗顶端认知流量;建立专业权威;天然的内链机会
- 价值要求:清晰准确的定义;示例与上下文;关联术语互链;比字典更有深度
- URL 结构:
/glossary/[term]/或/learn/[term]/
10. Translations(多语言)
- 模式:同一内容的多语言版本,例:"qué es pSEO"、"was ist SEO"
- 本质:内容翻译并本地化到其他语言市场
- 为什么有效:打开全新市场;多数语言竞争更低;成倍放大内容触达
- 价值要求:高质量翻译(不能只是机翻);文化本地化;正确实现 hreflang;母语者审校
- URL 结构:
/[lang]/[page]/或yoursite.com/es/、/de/等
11. Directory(目录页)
- 模式:
"[category] tools"/"[type] software"/"[category] companies",例:ai copywriting tools、email marketing software - 本质:某品类下的综合目录
- 为什么有效:研究阶段流量捕获;外链磁铁;天然适合聚合/评测型产品
- 价值要求:覆盖全面;有用的筛选/排序;每个条目都有详情(不只是名字);定期更新
- URL 结构:
/directory/[category]/或/[category]-directory/
12. Profiles(人物/实体档案页)
- 模式:
"[person/company name]"或"[entity] + [attribute]",例:stripe ceo、airbnb founding story - 本质:知名人物、公司或实体的档案页
- 为什么有效:信息意图流量;建立主题权威;天然适合 B2B、新闻、研究类站点
- 价值要求:准确且注明来源;定期更新;有独特洞察或聚合价值;不能只是维基百科的翻版
- URL 结构:
/people/[name]/或/companies/[name]/
如何选择 Playbook:按资产匹配 + 组合叠加
按你拥有的资产匹配
| 如果你拥有... | 优先考虑... |
|---|---|
| 专有数据 | Directories、Profiles |
| 带集成的产品 | Integrations |
| 设计/创意型产品 | Templates、Examples |
| 多细分受众 | Personas |
| 本地业务布局 | Locations |
| 工具/工具型产品 | Conversions |
| 内容/专业能力 | Glossary、Curation |
| 竞争格局清晰 | Comparisons |
组合多个 Playbook
技能明确指出可以叠加使用,参考文档 references/playbooks.md 给出了四组经典组合示例:
- Locations + Personas:"Marketing agencies for startups in Austin"(本地 × 人群)
- Curation + Locations:"Best coworking spaces in San Diego"(榜单 × 本地)
- Integrations + Personas:"Slack for sales teams"(集成 × 人群)
- Glossary + Translations:多语言教育内容(术语 × 翻译)
组合不是简单拼接两个模板,而是让两个维度的变量在页面中同时产生差异,从而成倍放大"每页独特内容"的空间——这正是原则 1 与原则 2 在选型阶段的落地方式。
实施框架:从关键词模式到索引策略的五步流水线
第 1 步:关键词模式研究(Keyword Pattern Research)
识别模式(Identify the pattern):
- 重复结构是什么?(例如 "best coworking spaces in [city]")
- 变量有哪些?([category]、[city]、[year]…)
- 存在多少种唯一组合?
验证需求(Validate demand):
- 聚合搜索量(aggregate search volume)——所有组合的总量;
- 量级分布(head vs. long tail)——头部词 vs 长尾词的分布形态;
- 趋势方向(trend direction)——上升、平稳还是下滑。
这一步的输出直接决定页面规模上限。参考文档建议优先做高量级模式的验证,避免在无需求的组合上浪费产能(对应后文"常见错误"中的 Over-generation)。
第 2 步:数据需求(Data Requirements)
为每个页面定位数据来源:
- 什么数据填充每个页面?
- 是 first-party(第一方)、scraped(抓取)、licensed(授权)还是 public(公开)?
- 数据如何更新?(手动、定时任务、API 同步)
数据质量是 pSEO 的生命线。技能在"常见错误"中把 Poor data quality(过期或错误的信息) 列为五大坑之一;seo-guidelines.md 的内容刷新策略(12 个月以上的文章、过时统计、过时最佳实践都应更新)同样适用于数据驱动的程序化页面——数据源的更新机制必须在立项时就设计好,而不是上线后才补。
第 3 步:模板设计(Template Design)
页面结构骨架:
- 包含目标关键词的 Header;
- 独特的引言(不是简单换变量);
- 数据驱动的章节(data-driven sections);
- 相关页面/内链区;
- 与意图匹配的 CTA(Call to Action)。
确保唯一性(Ensuring uniqueness):
- 每页都需要独特价值;
- 基于数据的条件内容(conditional content);
- 每页的原创洞察/分析(original insights/analysis per page)。
值得对照的是仓库中 article_planner.py 的实现:它通过 SectionType 枚举(含章节类型分类)、calculate_word_target()(字数目标计算)和 plan_engagement_distribution()(互动分布规划)把一篇文章规划为可执行的章节计划,其 classify_section_type() 会按关键词匹配把标题归类为不同章节类型。程序化页面的模板设计可以借鉴同样的思路:模板中的每个区块都应有明确的类型职责(引言、数据区、对比区、FAQ、CTA),而不是"整页一个模板到处填词"。
第 4 步:内部链接架构(Internal Linking Architecture)
Hub and Spoke 模型:
- Hub:主分类页(枢纽页);
- Spokes:各程序化页面(辐条页);
- 相关辐条页之间互相链接(cross-links)。
避免孤儿页面(Avoid orphan pages):
- 每页都能从主站到达(3 次点击内可达);
- 所有页面进入 XML Sitemap;
- 面包屑 + 结构化数据(BreadcrumbList schema)。
仓库的 internal-links-map.md 把内链实践具体化为可执行的维护机制:为每个页面记录 URL、何时链接、锚文本示例,并强调"3-5 个内链、锚文本多样化、首段链接权重更高、及时更新地图"。对程序化站点而言,内链地图的价值会被放大——因为页面数量多,链接关系必须系统化而非靠记忆,hub-and-spoke 模型正是把这种系统化落到 URL 与导航结构上。
第 5 步:索引策略(Indexation Strategy)
- 优先索引高流量模式(prioritize high-volume patterns);
- 对极薄的变体页使用 noindex;
- 审慎管理爬取预算(crawl budget)——尤其对大型站点;
- 按页面类型拆分 Sitemap(separate sitemaps by page type)。
大型 pSEO 站点的爬取预算管理可以进一步参考 seo-audit 技能 的 Crawl Budget 清单:参数化 URL 是否受控、分面导航是否正确处理、无限滚动是否有分页兜底、会话 ID 是否进入 URL。这些检查项对程序化页面(经常产生海量组合 URL)尤其关键。
上线质量检查:Pre-Launch 清单与 Post-Launch 监控
上线前清单(Pre-Launch Checklist)
内容质量(Content quality):
- [ ] 每页提供独特价值
- [ ] 回答搜索意图
- [ ] 可读且有用
技术 SEO(Technical SEO):
- [ ] 唯一标题与 meta description
- [ ] 正确的标题层级结构
- [ ] 已实现 Schema 标记
- [ ] 页面速度可接受
内部链接(Internal linking):
- [ ] 已接入站点架构
- [ ] 相关页面已互链
- [ ] 无孤儿页面
索引(Indexation):
- [ ] 已在 XML Sitemap 中
- [ ] 可被爬取
- [ ] 无冲突的 noindex
关于"唯一标题与 meta description",seo-guidelines.md 给出了可直接套用的硬指标:Meta Title 50-60 字符且含主关键词,Meta Description 150-160 字符、包含价值主张与行动号召(Learn、Discover、Get 等动词),URL Slug 小写、连字符、3-5 个词、包含主关键词。这些指标应直接写进模板的变量生成规则中。而 Schema 标记可参考 schema-markup 技能:程序化页面常用 Article、FAQPage、BreadcrumbList、Product、LocalBusiness 等类型,技能特别指出"templated schema at scale"(规模化模板化 Schema)正是 programmatic-seo 与 schema-markup 两个技能的衔接点。
上线后监控(Post-Launch Monitoring)
需要追踪的指标:
- Indexation rate(索引率)
- Rankings(排名)
- Traffic(流量)
- Engagement(互动/参与)
- Conversion(转化)
需要警惕的信号:
- Thin content warnings(内容稀薄警告)
- Ranking drops(排名下滑)
- Manual actions(人工处罚)
- Crawl errors(爬取错误)
监控到异常后的处理路径与 seo-audit 技能 形成闭环:该技能给出的审计优先级(可爬取性与索引 → 技术地基 → 页面优化 → 内容质量 → 权威与链接)可以直接套用到"某批程序化页面不达标"的场景,按优先级逐层排查。
五大常见错误:规模化翻车的经典姿势
| 错误 | 表现 | 规避 |
|---|---|---|
| Thin content | 只在完全相同的内容里换城市名 | 用原则 1(每页独特价值)+ 数据驱动章节对冲 |
| Keyword cannibalization | 多页抢同一个关键词 | 建立关键词映射,每页唯一主词(seo-guidelines.md 明确要求站级关键词映射文档) |
| Over-generation | 生成了没有搜索需求的页面 | 先做第 1 步关键词模式验证,无需求不做 |
| Poor data quality | 过期或错误的信息 | 第 2 步就设计数据更新机制 |
| Ignoring UX | 页面为 Google 而存在,不是为用户 | 上线清单中的"可读且有用"逐页验收 |
输出格式:策略文档 + 页面模板
技能的产出物是两类标准文档:
1. 策略文档(Strategy Document)
- 机会分析(Opportunity analysis):关键词模式、量级分布、竞争格局结论;
- 实施计划(Implementation plan):Playbook 选型、数据源、模板骨架、索引策略;
- 内容指南(Content guidelines):每页价值标准、CTA 规范、语气约束。
2. 页面模板(Page Template)
- URL 结构:遵循各 Playbook 的 URL 规范(子文件夹、小写连字符);
- Title/Meta 模板:变量化生成,且满足 50-60 字符 / 150-160 字符约束;
- 内容大纲:Header(含关键词)→ 独特引言 → 数据章节 → 相关页面 → 意图匹配 CTA;
- Schema 标记:按页面类型附加 JSON-LD。
在 SEO Machine 中落地:任务清单与相关技能
技能在末尾给出 6 个任务相关问题,用于在每次执行前收敛范围:
- 你目标的关键词模式是什么?
- 你有什么(或能获取什么)数据?
- 计划生成多少页面?
- 你站点的权威度如何?
- 当前谁在排这些词?
- 你的技术栈是什么?
其中"技术栈"直接决定模板渲染方式:schema-markup 技能 区分了静态站点(HTML 模板直接嵌入 JSON-LD)、动态站点(React/Next.js 组件 SSR 渲染 Schema)、CMS/WordPress(Yoast、Rank Math 等插件)三类实现路径,程序化页面的模板引擎选择应与之对齐。
相关技能图谱
- seo-audit:上线后对程序化页面做审计(见 .claude/skills/seo-audit/SKILL.md);
- schema-markup:为批量页面添加结构化数据(见 .claude/skills/schema-markup/SKILL.md);
- competitor-alternatives:对比页的深度框架(见 .claude/skills/competitor-alternatives/SKILL.md)。
三者与 programmatic-seo 在技能 description 中相互引用、形成闭环:pSEO 负责"规模化造页",schema-markup 负责"让页面可理解",seo-audit 负责"上线后体检"。把这套技能组合放进 SEO Machine 的 Claude Code 工作区,配合 context/ 下的品牌声音、SEO 指南、内链地图等上下文文件,即可形成一个从机会评估到批量上线、再到持续监控的完整程序化 SEO 工作流。
总结要点: 程序化 SEO 的成败取决于四个变量的质量——关键词模式的真实需求、数据源的可防御性、模板的差异化深度、链接与索引的系统性。12 大 Playbook 提供了成熟的打法模板,六大原则提供了不可逾越的纪律边界,而上线前清单与上线后监控则把"规模化"始终锚定在"质量优先"的轨道上。