mcpField
P
programmatic-seo

programmatic-seo

github.com/kostja94营销与增长1.1k2.2k 次安装3 天前更新
代码仓库

关于 programmatic-seo

programmatic-seo 是一项技能,指导如何用模板和结构化数据批量生成 SEO 页面。它帮助 SEO 与工程团队选择页面类型并打造有差异的内容,重点关注证据、数据质量和负责任地使用 AI。

主要功能

  1. 01模板、数据与自动化框架
  2. 02页面类型与方案选择
  3. 03用于页面差异化的证据块
  4. 04数据强度与来源评估
  5. 05基于可靠输入的 AI 页面定制

适用场景

  1. 01根据产品目录规划落地页
  2. 02构建集成或对比页面
  3. 03批量扩展 FAQ 与术语内容
  4. 04生成页面前评估数据质量

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/kostja94/marketing-skills --skill programmatic-seo

安装后在 Claude Code 中输入/programmatic-seo确认已加载。

详细介绍

SEO:程序化 SEO

介绍程序化 SEO——通过模板和结构化数据自动创建大量经过 SEO 优化的页面,而非手动编写每个页面。经典的“邮件合并”式程序化 SEO(一个僵化模板 + 替换变量)往往导致差异度低,页面显得内容单薄。在同一数据基础上负责任地使用 AI,可以大规模实现针对每个 URL 的定制——包括与搜索意图相符的文案、内容深度、常见问题、语气和本地化,同时遵循证据块、数据分级和质量检查(见下文的数据强度层级和AI 辅助生成)。

调用时:首次使用时,如有帮助,可先用 1–2 句话介绍此技能涵盖的内容及其重要性,然后提供主要输出。后续使用时,或用户要求跳过介绍时,直接提供主要输出。

**项目上下文:**如果根目录中存在 contextus.md,请阅读并仅加载与此任务相关的模块。如果没有 Contextus,请使用现有项目材料或用户提供的信息,并询问缺失信息;不要创建并行的上下文系统。

定义

程序化 SEO = 构建一个模板,并用数据库、API 或电子表格中的数据填充,以生成数百或数千个不同的页面。每个页面都面向一个长尾关键词(例如“[城市]最佳 SEO 工具”、“[App A] + [App B] 集成”)。

与传统 SEO 的主要区别:技术性强(SEO 人员 + 工程师);注重长尾关键词;数据驱动(数据质量决定成败);自动化;为规模化而构建。

经典模式的局限与 AI 增强差异化

时代问题有助之处
僵化的程序化 SEO一个模板,变化极少 → 标题和正文相似,E-E-A-T 较弱,显得“明显是邮件合并”仍需为每个 URL 提供独特证据,并有选择地进行索引
AI 增强的程序化 SEO同样的结构化数据行(事实、SKU、指标)为页面提供依据,但模型会为每个 URL生成不同的叙述:引言、常见问题深度、用户画像角度、本地化、内链建议——大规模提升差异化事实保留在数据层;AI 调整措辞和结构,而非编造数字——见AI 辅助生成

最佳实践立场:AI 是一种加速和定制工具,不能替代数据可辩护性(第 1–5 级)或技术 SEO(URL、架构标记、CWV)。使用得当时,它符合重质不重量的原则:减少内容单薄的 URL,增加更多独特且实用的页面。

三部分框架

组成部分作用
模板可复用的页面结构:布局、标题、内链、内容块;为空字段设置条件逻辑
数据结构化信息:地点、产品、价格、功能——必须准确、完整,并能带来真正的价值
自动化将数据连接到模板的系统;动态生成页面或批量发布页面
AI 层(可选)基于有依据的输入(行 JSON + 规则),为每个 URL生成多样化文案、扩展常见问题并调整章节重点——减少“模板雷同”带来的疲劳感,同时保持可审计性

页面 Playbook 矩阵(skills/pages)

此库中的页面类型位于 pages/{brand|content|legal|marketing|utility}/ 下。使用下表将搜索模式 → Playbook → 应打开的 *-page-generator 技能对应起来,以查看结构、文案和架构;并非每个文件夹都适合批量生成 URL。

Playbook意图示例 / 关键词模式页面技能(name)路径(参考)
替代方案 / 对比“[Competitor] alternatives”、“X vs Y”alternatives-page-generatorpages/marketing/alternatives
集成“[Product A] [Product B] integration”integrations-page-generatorpages/marketing/integrations
类别 / 目录分面列表、产品网格category-page-generator, products-page-generatorpages/marketing/category-pages, products
术语表 / 定义“what is [term]”、术语落地页glossary-page-generatorpages/content/glossary
常见问题 / 问答问题库、PAA 风格页面faq-page-generatorpages/content/faq
操作指南 / 流程步骤库、模板中的“[how to] [task]”模块howto-section-generatorcomponents/content/howto-section
对比矩阵(模块)功能 / 标准网格、来自数据源的“vs”单元格comparison-table-generatorcomponents/content/comparison-table
工具与潜在客户引流内容“free [x] tool/calculator”tools-page-generatorpages/content/tools
模板库浏览 → 详情(你的模板)template-page-generatorpages/content/template-page
资源中心指南、中心页、下载中心resources-page-generatorpages/content/resources
使用场景 / 解决方案“for [role]”、“by industry”use-cases-page-generator, solutions-page-generatorpages/marketing/use-cases, solutions
迁移 / 切换“migrate from [X]”migration-page-generatorpages/marketing/migration
营销活动落地页付费 / 细分受众落地页landing-page-generatorpages/marketing/landing-page
博客 / 文章大规模长尾文章blog-page-generator, article-page-generatorpages/content/blog, article
文档 / 功能 / API可扩展的文档版块、功能落地页、/api 营销页docs-page-generator, features-page-generator, api-page-generatorpages/content/docs, features, api
社会认同标志、案例研究、作品展示库press-coverage-page-generator, customer-stories-page-generator, showcase-page-generatorpages/marketing/press-coverage, customer-stories, showcase
计划与优惠初创企业 / 教育、竞赛、下载、联盟营销、媒体资料包startups-page-generator, contest-page-generator, download-page-generator, affiliate-page-generator, media-kit-page-generatorpages/marketing/*
定价 / 服务套餐、服务项目(谨慎用于 pSEO)pricing-page-generator, services-page-generatorpages/marketing/pricing, services

通常不适合大规模程序化生成(只有一个主要 URL 或合规要求较高):pages/brand/*(主页、关于、联系)、pages/legal/*、大多数 pages/utility/*(404、状态、注册登录等)——应将其视为一次性页面或由政策驱动,而非按模板 × 数据规模化生成。

选择页面手册

如果你有……优先考虑……先打开……
竞品列表 + 定位替代方案 / 对比alternatives-page-generator
集成目录(你自己的 + 合作伙伴的)集成矩阵integrations-page-generator
产品目录或 SKU分类 / 产品网格category-page-generator、products-page-generator
术语 / 定义数据库术语表glossary-page-generator
支持工单 / 从 PAA 挖掘的问题大规模 FAQfaq-page-generator
操作步骤库 / 流程模板扩展页面中的 HowTo 部分howto-section-generator
根据数据整理的竞品 / 功能矩阵扩展页面中的对比表区块comparison-table-generator(+ alternatives-page-generator,用于 URL 意图)
引流资源、计算器工具中心 + 单个工具页面tools-page-generator
你自己的模板(导出内容、图库项目)模板市场template-page-generator
ICP × 行业矩阵用例 / 解决方案use-cases-page-generator、solutions-page-generator
从竞品迁移的路径迁移migration-page-generator
营销活动或地理位置落地页落地页landing-page-generator
长篇 SEO 文章博客索引 + 单篇文章blog-page-generator、article-page-generator

模板结构(推荐)

区块用途
引言介绍;契合用户意图
证据区块每个页面独有的数据驱动内容(表格、列表、经核实的数据);让页面区别于内容单薄的页面
决策对比、建议或后续步骤
FAQ常见问题
CTA行动号召

证据区块 = 每个页面的真实结构化数据(企业名录、定价、评价、经核实的数据)。确保每个页面都能提供真正的价值,而非仅替换变量的重复套话。

数据实力层级(可辩护性)

最强大的程序化页面由只有你的产品(或你产品中的客户)才能生成的内容驱动——尤其是模板、导出内容和生成的成品。仅依赖第三方或抓取的列表,基础最薄弱。

层级来源示例相对风险
1 — 产品生成由你的产品创建或渲染的资产:页面 / 布局模板、电子邮件 / Notion / 代码模板、导出包、生成的预览、品牌化片段、“使用 [Product] 构建”的示例与真实 .json / CMS 字段关联的模板图库条目;导出内容的截图;独特的预览 URL最低,前提是每个 URL 都展示不同的生成结果
2 — 产品衍生你拥有的遥测数据和产品内数据:汇总数据、群组、基准、功能采用情况来自你数据仓库的“[行业]团队实现价值的中位时间”(已汇总)若已汇总 / 匿名化且符合政策,风险较低
3 — UGC / 客户内容评价、投稿、展示项目、经审核的社区内容展示网格;经核实的引言中等——需要审核 + 获得同意
4 — 获许可 / 合作伙伴提供独家数据源、联合营销数据集合作伙伴定价层级;获许可的行业数据中等——需遵守合同并规范引用
5 — 公开 / 抓取开放网络、目录、通用数据丰富服务填充名称 / 地址;常见事实最高——需要编辑加工、事实核查和真正的证据区块

为什么层级 1(模板和生成内容)表现最佳:基于你的模板系统构建的页面包含专有结构、变量和符合品牌规范的区块——竞争对手更难原样复制,也更容易证明其独特性(嵌入内容、下载项、ID)。当用户体验是“浏览图库 → 使用模板”时,可搭配 template-page-generator。

第 2 层 — 产品衍生(实用)
内容注意事项
来自你自己的后端、数据仓库或支持/CRM 导出的指标:按细分群体划分的激活率、集成受欢迎程度、错误预算、实现价值所需时间——而非泛泛的“行业报告”。隐私与服务条款:设置最小单元格样本量;不得识别个人;记录汇总了哪些数据以及汇总时间范围。
如果你能说明**“只有我们知道这些,因为它运行在我们的产品中”**,那就很适合。数据过时会损害信任:设置数据管道任务、标注“截至 [日期]”并自动失效。

AI 的应用:使用模型将结构化汇总数据转化为文字(介绍段落、“这对 [细分群体] 意味着什么”)——输入必须是经过验证的数据管道数字/表格,而非自由编造的内容。在页面上或附录中保留机器可读的表格或 JSON,以便审计相关声明。

第 3 层 — UGC / 客户内容(实用)
内容注意事项
引言、评价、展示投稿、社区模板——经同意后使用的用户内容。审核:垃圾信息、PII、攻击竞争对手的内容;使用姓名/标志需取得同意;只有准确时才使用 Review、CreativeWork 架构。
与第 1 层结合时效果很好(例如“客户制作的模板”图库)。数量多但质量差 → 页面内容单薄;限制投稿数量或为投稿评分。

AI 的应用:将长篇评价总结为要点;为图片生成替代文本草稿;将投稿归类到主题页面——发布前务必经过人工审核。不得伪造客户评价。

第 4 层 — 授权 / 合作伙伴(实用)
内容注意事项
合作伙伴价格表、联合营销报告、通过 API 提供的允许使用字段(标志、SKU)。合同范围:哪些字段可以出现在什么 URL 上;署名行;标志相关的 DMCA / 商标问题。
通常是一个数据源 → 多个 URL;独特性必须来自你的呈现方式、比较逻辑或计算器,而不能只靠原始数据源。刷新频率应与合作伙伴 SLA 挂钩。

AI 的应用:基于固定属性表(授权许可 + 合作伙伴规则)起草比较文案和常见问题;不得编造 SKU 或价格——从数据源读取,由 AI 组织措辞并精简。

第 5 层 — 公开数据 / 抓取数据(实用)
内容注意事项
开放数据、目录、类似 Wikipedia 的事实、对公开实体进行信息补充。重复和内容单薄的风险最高:所有人都能获取相同事实;你必须添加综合分析、编辑角度或独特工具(计算器、筛选器)。
实体 SEO和引用很重要:链接到权威来源;为易变事实标注日期。规划如何清理低流量的单薄 URL,或将其设为 noindex。

AI 的应用:使用模型将杂乱的公开文本整理成表格、拟定各部分大纲、建议内部链接——然后对名称、数字和日期进行事实核查。不要使用 AI 编造统计数据或引用;在验证之前,应将输出视为草稿。

AI 辅助生成(跨层级)

为什么 AI 适合现代程序化 SEO:早期的程序化 SEO 名声不佳,因为模板是固定的,而且文案千篇一律——针对每个查询几乎没有真正的差异化。大模型以每行数据中的事实和品牌规则为依据后,就能切实做到针对每个 URL定制标题、引言、常见问题,以及“此页面为何重要”等内容,而无需手动撰写数千个页面。这让大规模执行更贴近最佳实践(匹配意图、提供有用内容、创造独特价值),前提是不得让模型编造数据。

原则原因
让 AI 以结构化输入为依据将 JSON/CSV 行(层级、来源 URL、指标)传入提示词;在系统提示词中禁止编造数字。
将“事实”与“措辞”分开数据层 = 事实来源;AI = 语气、精简、本地化、常见问题、针对不同细分受众的侧重点——绝不可反过来。
调整结构,而不只是形容词根据行中的意图标记,要求采用不同的章节顺序、常见问题数量,或“新手 vs 高级用户”的角度——减少模板雷同。
人工或自动质检抽查流量较高的 URL;如果必填字段为空或缺少引用,则阻止发布。
在有帮助时披露例如:“引言由 AI 生成;数据来自 [internal report, Q3 2025]。”这能建立信任,也符合政策趋势。

AI 生成特别有用的场景:层级 2–5——原始材料已经是表格形式或重复性较高,但需要大规模生成易读且有差异化的文案。层级 1 也能从 AI 中受益(根据导出的 JSON 生成草稿),但差异化优势仍在于产品本身的产物。

运营要求(适用于所有层级)
要求做法
来源追溯记录数据来源;跟踪每个字段的来源
时效规则例如,每 90 天更新评分,每 30 天更新价格,布局变化时提升模板版本号
优先选择 1–2,而非 5在使用公开数据抓取前,先用产品生成或从产品推导的数据填充证据
AI 治理仅使用结构化输入;不得使用未经核实的数字;审核 UGC;可选披露
清理与合并对键去重;删除会产生重复意图的行

理想使用场景

关于使用哪种页面生成器技能,请参阅上文的 Page Playbook Matrix。常见模式:

使用场景示例
特定地点页面“[city] 的水管工”、“[neighborhood] 最佳餐厅”,并提供真实的本地数据
产品比较“[Product A] vs [Product B]”,并附结构化规格
替代品页面大规模生成“[Competitor] 替代品”页面;50 多个竞争对手;参见 alternatives-page-generator
软件集成“[App A] + [App B]”集成页面(例如 Zapier 的 50K+ 个页面)
免费工具“[X] 检查器”、“[Y] 计算器”、“[Z] 生成器”——独立工具页面;工具包中心;与主要产品面向相同的 ICP;潜在客户开发
旅行 / 目的地城市与景点的组合页面,包含评论和照片
电子商务分类页面、产品变体(尺寸、颜色、材质)
常见问题 / 问答由用户问题数据库提供内容的页面
薪资 / 定价采用结构化数据的比较页面

应避免的情况:网站结构薄弱;页面差异流于表面(只替换城市或名称);内容需要原创专业知识或 UGC 参与。

真实案例

案例仅供说明,不代表认可。

公司规模模式
Zapier50,000+ 个页面「[应用 A] + [应用 B]」集成
Airbnb—地点搜索;目的地 × 房源
评论平台—用户评论 + 自动生成的比较页面
旅游网站—目的地、酒店、航班、活动页面
NomadList2,000+ 个城市页面生活成本、网速(动态数据)
Semrush、Ahrefs50+ 个免费工具SEO 检查器、关键词工具、反向链接检查器;工具集中心 + 单个工具页面

内容要求

要求目的
每页 300+ 字避免因内容单薄而受到处罚
独特、可验证的数据除简单替换数据外,每个页面都必须添加有意义的页面专属内容
证据区块每个页面都包含带有真实数字/属性的表格、列表、示例
语义化 HTML结构规范;使用条件逻辑,避免出现空白或重复的区块
内部链接链接相关的程序化页面;提升流量并促进收录

技术注意事项

主题做法
子目录与子域名优先使用子目录(yoursite.com/integration/slack-notion/),而非子域名(integrations.yoursite.com/...),以便将权威度集中到主域名;如需调整结构,请参阅 url-structure、domain-architecture
选择性收录不要收录所有页面;对低价值页面使用 noindex 规则
站点地图分段按国家、语言、业务部门划分;管理抓取预算
URL 结构使用描述性 URL;保持层级清晰;请参阅 url-structure
SchemaJSON-LD:按页面类型使用 Product、Place、FAQ、ItemList
性能缓存、静态生成;Core Web Vitals

关键陷阱

陷阱后果
内容单薄除关键词外信息极少;文案笼统;占位内容区块 → 受到处罚
重复页面内容相同,仅替换数据 → 因内容单薄而受到处罚
索引膨胀生成本不应被收录的页面 → 浪费抓取预算
大量倾倒一次发布大量相似页面 → 触发垃圾内容信号
筛选器 URL使用筛选器而非独立 URL/标题 → 关键词蚕食

只有标题、一段文字,并且只是替换城市名称的页面无法获得排名,还可能受到 Google 处罚。

修复已构建的同质化页面

如果程序化页面已经发布,而且彼此看起来可以互换——结尾句相同、不同 URL 的价值主张完全一致、区块结尾如同克隆——请在触发质量信号前修复内容。

诊断方法

对渲染后的文件或源文件运行正则表达式扫描,找出重复的句尾和段落结构。留意出现在同类别页面中超过 30% 的模式。常见迹象包括:每个工具页面都以“X 是 Y 的理想选择”结尾;每个类别页面都使用相同的技术摘要;每个地点页面都使用相同的 FAQ 结尾。

在三个范围内进行扫描:单个页面内(各区块是否重复使用相同的结尾句式?)、单个类别内(所有视频工具页面是否共用一个模板?)以及不同类别之间(整个网站的每个页面是否都使用相同的价值陈述?)

将修复优先级划分为三个级别
优先级内容操作
P0 — 消除纯粹填充模板、没有信息价值的内容;每个页面说的都是同一件事根据每个页面的具体情况分别重写
P1 — 重写核心信息正确,但表达模式化(例如,“不同工具采用不同架构”——虽然正确,但很笼统)准备 8–15 种语义变体并交替使用,让相邻页面有所不同
P2 — 降低密度出现频率过高的常见词汇(例如,“无缝”出现在 80% 的页面中)替换约 30–40% 的用例,而非全部替换——常见词汇适度使用没有问题
分轮执行

先修复 P0 模式,每次处理一个类别。每轮结束后,重新扫描,确认相关模式已清除,且没有出现新模式。常见陷阱:对所有页面采用相同修复方式,用另一个模板替换原有模板。分散采用不同的改写方式,让按顺序处理的页面各有不同。

对于单页内部重复——即同一文件中的所有用例或工具描述都采用相同的结尾句——应使用功能性结尾,而非评价性结尾。功能性结尾会说明该条目在实践中解决了什么瓶颈;评价性结尾则只是宣称它是个不错的选择。

在工作流中预防

在 AI 生成提示词中加入结构多样性要求(变换各部分的结尾,禁止重复使用结尾套语)。将不同类别的页面放在同一批次生成,而非一次只处理一个类别。在发布前,检查同类别页面之间的 N-gram 重叠情况。

分步工作流

  1. 研究 — 细分领域、意图;纳入低搜索量关键词;使用 SEO 工具和问题数据库
  2. 收集数据 — 来源记录、新鲜度规则;使用第一方/授权数据;定义模板字段
  3. 选择技术栈 — Next.js + DB、Webflow CMS、WordPress、无头架构;复用 API + 模板
  4. 设计模板 — 引言、证据、决策、FAQ、CTA;架构;条件逻辑
  5. 构建数据库 — 将字段映射到模板位置;隐藏空字段
  6. 生成页面 — 描述性 URL;优化性能
  7. 部署与监控 — 站点地图;索引状态、排名、CTR、跳出率、转化
  8. 优化 — 精简效果不佳的页面;更新数据;对布局和 CTA 进行 A/B 测试

最佳实践

实践目的
质量优先于规模每个页面都必须提供真正独特且可验证的价值
差异化优先于克隆优先采用以 AI 为依据的文案变体 + 证据模块,而非仅通过替换 {city} 的静态段落
分批发布采用便于衡量的小批次;避免一次性大量发布
完善的信息架构添加指向相关指南/类别的内部链接
视觉元素在适用时使用表格、地图和比较内容
匹配意图避免通用模板文本;精准匹配用户意图

时间线与预期

  • 典型排名周期:约 6 个月
  • 已报告的增长:设计良好的主题集群可带来 40% 以上的流量增长
  • AI 搜索:结构清晰、数据丰富的内容在 AI Overviews 和引用层中表现更佳

输出格式

  • 模板设计(引言、证据、决策、FAQ、CTA;必需数据字段)
  • 数据要求(来源、新鲜度、准确性)
  • 内部链接(中心辐射式结构、相关页面)
  • 索引策略(选择性索引、站点地图分段)
  • 审核检查清单

相关技能

  • template-page-generator:模板结构;聚合(图库)和详情页;Tier 1 产品生成的模板 URL
  • landing-page-generator:以转化为导向的程序化页面;用于活动 CTA 的落地页结构
  • tools-page-generator:免费工具页面;工具集中心;程序化工具页面;潜在客户开发
  • alternatives-page-generator:大规模替代方案/对比页面;竞争对手品牌流量
  • category-page-generator、products-page-generator:类别/目录网格
  • glossary-page-generator、faq-page-generator、howto-section-generator、comparison-table-generator、resources-page-generator:定义、问答库、HowTo 步骤区块、对比矩阵、内容中心
  • use-cases-page-generator、solutions-page-generator、migration-page-generator:ICP/行业矩阵、迁移 SEO
  • integrations-page-generator:大规模集成配对页面
  • blog-page-generator、article-page-generator、docs-page-generator、features-page-generator、api-page-generator:长篇内容和产品页面规模化
  • press-coverage-page-generator、customer-stories-page-generator、showcase-page-generator:大规模展示证明
  • startups-page-generator、contest-page-generator、download-page-generator、affiliate-page-generator、media-kit-page-generator、pricing-page-generator、services-page-generator:计划和优惠(谨慎用于 pSEO)
  • content-strategy:内容集群、支柱页面;程序化页面作为集群节点
  • website-structure:扩展 URL 集之前先规划网站信息架构
  • url-structure、domain-architecture:路径、子目录策略
  • schema-markup:结构化数据(Product、Place、FAQ、ItemList)
  • internal-links:程序化页面的链接
  • xml-sitemap:大型程序化网站的站点地图分段
  • canonical-tag:重复/内容单薄的页面处理
  • seo-strategy、seo-audit:路线图和上线后审计

评论

支持 Markdown