程序化 SEO(Programmatic SEO)规模化建站实战:基于 SEO Machine 的模板化页面体系搭建指南

原创2026-09-16 16:11:371,844 阅读
文章标签:人工智能AI 应用AI 写作AI 技能Prompt 模板

程序化 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. 让页面获得排名——每页对应一个真实的搜索意图与关键词模式;
  2. 为用户提供价值——模板只是骨架,数据与内容差异才是血肉;
  3. 避免内容稀薄处罚——杜绝"换城市名生成 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 个任务相关问题,用于在每次执行前收敛范围:

  1. 你目标的关键词模式是什么?
  2. 你有什么(或能获取什么)数据?
  3. 计划生成多少页面?
  4. 你站点的权威度如何?
  5. 当前谁在排这些词?
  6. 你的技术栈是什么?

其中"技术栈"直接决定模板渲染方式:schema-markup 技能 区分了静态站点(HTML 模板直接嵌入 JSON-LD)、动态站点(React/Next.js 组件 SSR 渲染 Schema)、CMS/WordPress(Yoast、Rank Math 等插件)三类实现路径,程序化页面的模板引擎选择应与之对齐。

相关技能图谱

三者与 programmatic-seo 在技能 description 中相互引用、形成闭环:pSEO 负责"规模化造页",schema-markup 负责"让页面可理解",seo-audit 负责"上线后体检"。把这套技能组合放进 SEO Machine 的 Claude Code 工作区,配合 context/ 下的品牌声音、SEO 指南、内链地图等上下文文件,即可形成一个从机会评估到批量上线、再到持续监控的完整程序化 SEO 工作流。

总结要点: 程序化 SEO 的成败取决于四个变量的质量——关键词模式的真实需求、数据源的可防御性、模板的差异化深度、链接与索引的系统性。12 大 Playbook 提供了成熟的打法模板,六大原则提供了不可逾越的纪律边界,而上线前清单与上线后监控则把"规模化"始终锚定在"质量优先"的轨道上。

登录后查看全文
seomachine