Marketing Skills 项目之 Programmatic SEO 实战指南:用模板与数据规模化构建可收录、可排名的 SEO 页面
Marketing Skills 项目之 Programmatic SEO 实战指南:用模板与数据规模化构建可收录、可排名的 SEO 页面
在 Marketing Skills 开源仓库中,programmatic-seo 是面向 AI 代理(Claude Code、OpenAI Codex、Cursor、Windsurf 等支持 Agent Skills 规范的代理)的专项技能,用于"以模板 + 数据驱动、规模化创建 SEO 页面"。当你想做 pSEO(Programmatic SEO)、模板页、目录页、地点页、"关键词 + 城市"页、对比页、集成页,或一次生成上百个数据驱动落地页时,它会在识别到对应意图后自动介入,并给出从需求评估、策略选型、模板设计到索引化与上线后监控的完整方法论。读完本文,你将掌握 12 种经过验证的 pSEO 打法、六条核心原则、五步实施框架、质量检查清单与常见失败陷阱,并了解它如何与 seo-audit、schema、site-architecture、competitors 等仓库内其他技能协同,规避薄内容(thin content)惩罚。
一、技能定位:何时触发、先读什么
programmatic-seo 的触发场景非常明确,技能描述中列出了一组典型措辞:用户提到 "programmatic SEO"、"template pages"、"pages at scale"、"directory pages"、"location pages"、"[keyword] + [city] pages"、"comparison pages"、"integration pages"、"building many pages for SEO"、"pSEO"、"generate 100 pages"、"data-driven pages"、"templated landing pages" 时,都应触发本技能。其本质是:面向大量相似页面、每个页面针对不同关键词或地点的场景。
技能边界同样清晰(来自 skills/programmatic-seo/SKILL.md 的 frontmatter):
- 若任务是审计已有 SEO 问题,应转交
seo-audit技能(skills/seo-audit/SKILL.md); - 若任务是内容策略规划,应转交
content-strategy技能; - 仓库评估集 skills/programmatic-seo/evals/evals.json 第 6 条也验证了这一边界:当用户带着"爬虫报错、部分页面 404"这类技术审计问题找上门时,技能应识别出这属于技术 SEO 审计而非 pSEO 策略任务,明确转交
seo-audit,而不是越俎代庖。
启动前的强制步骤:先检查 .agents/product-marketing.md(或旧版 .claude/product-marketing.md、更早的 product-marketing-context.md)是否存在,若存在必须先读取,用其中的产品营销上下文理解产品、受众与定位,只询问文档未覆盖或与本任务强相关的信息。这是整个仓库的统一协作约定——product-marketing 是地基,其余技能先读它再干活。
二、动手前的三项评估
在设计任何 pSEO 策略之前,先完成三方面信息收集:
-
业务上下文(Business Context)
- 产品或服务是什么?
- 目标受众是谁?
- 这些页面的转化目标是什么?
-
机会评估(Opportunity Assessment)
- 存在哪些搜索模式?
- 潜在页面数量有多少?
- 搜索量分布如何(头部词 vs 长尾词的形态)?
-
竞争格局(Competitive Landscape)
- 当前哪些站点占据这些词的排名?
- 他们的页面长什么样?
- 你的站点是否有现实可行的竞争能力?
这决定了后续选型、投入规模与成功标准,避免"拍脑袋生成一万页"的盲目扩量。
三、六条核心原则
pSEO 与普通 SEO 的根本区别在于规模化,因此原则围绕"如何在规模上保持质量"展开:
1. 每页必须有独有价值(Unique Value Per Page)
- 每个页面必须提供该页面专属的价值;
- 不能只是模板中的变量被换掉;
- 唯一内容越差异化越好。
2. 专有数据最抗打(Proprietary Data Wins)
数据可防御性(defensibility)层级从强到弱:
- 专有数据(你自己创造的,Proprietary)
- 产品衍生数据(来自你的用户,Product-derived)
- 用户生成内容(来自你的社区,User-generated)
- 授权数据(独家访问权,Licensed)
- 公开数据(谁都能用——最弱,Public)
这个层级直接决定你的页面集群能否建立护城河:同一批关键词,用公开数据堆出的目录页几乎无法抵御竞争对手复制。
3. 干净的 URL 结构:子文件夹优于子域名
用子文件夹(subfolders),不要用子域名(subdomains)——子文件夹合并域名权威,子域名会分割域名权威:
- 好的:
yoursite.com/templates/resume/ - 差的:
templates.yoursite.com/resume/
4. 真实匹配搜索意图(Genuine Search Intent Match)
页面必须真正回答用户搜索的问题,而不是表面堆关键词。
5. 质量优先于数量(Quality Over Quantity)
100 个优秀页面好过 10,000 个薄页面。
6. 规避 Google 惩罚(Avoid Google Penalties)
- 不做 doorway pages(门页);
- 不堆砌关键词(keyword stuffing);
- 不制造重复内容(duplicate content);
- 对用户提供真实效用。
四、12 种 Playbook:模式总览与选择方法
原技能文档给出了 12 种经过验证的 pSEO 打法总览表,配套的 skills/programmatic-seo/references/playbooks.md 则对每种打法做了完整展开(模式、示例搜索、为什么有效、价值要求、URL 结构)。下表为总览:
| 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 翻译 | 多语言内容 | 本地化内容 |
| Directory 目录 | "[category] tools" | "ai copywriting tools" |
| Profiles 档案 | "[entity name]" | "stripe ceo" |
选择你的 Playbook:按资产匹配
| 如果你有... | 考虑... |
|---|---|
| 专有数据 | Directory(目录)、Profiles(档案) |
| 带集成的产品 | Integrations(集成) |
| 设计/创意型产品 | Templates(模板)、Examples(示例) |
| 多细分受众 | Personas(人群) |
| 本地业务存在 | Locations(地点) |
| 工具或工具型产品 | Conversions(转换) |
| 内容/专业度 | Glossary(词汇表)、Curation(精选) |
| 竞品格局清晰 | Comparisons(对比) |
references/playbooks.md 中给出了更细的扩展映射(含 Translations 国际化和"Stats 统计数据"等额外选项),并强调可以叠加多个 playbook 组合出复合页面:
- Locations + Personas:"Marketing agencies for startups in Austin"
- Curation + Locations:"Best coworking spaces in San Diego"
- Integrations + Personas:"Slack for sales teams"
- Glossary + Translations:多语言教育内容
仓库评估集 skills/programmatic-seo/evals/evals.json 的 1~3、5 条分别验证了 Personas("CRM for Real Estate")、Comparisons("Notion vs Asana")、Integrations("Slack integration")、Glossary("[term] definition")四类场景的识别与策略输出。
各 Playbook 的关键实操细节
Templates(模板页):模式为 "[Type] template" 或 "free [type] template"("resume template"、"invoice template"、"pitch deck template")。价值在于高意图、可分享、天然适合产品型公司。价值要求:真正可用的模板(不是预览)、每类型多变体、质量可比付费方案、下载/使用流程顺畅。URL 结构:/templates/[type]/ 或 /templates/[category]/[type]/。
Curation(精选页):模式 "best [category]" 或 "top [number] [things]"("best website builders"、"top 10 crm software")。价值要求:真实的评估标准、真实的测试或专业经验、定期更新(日期可见)、不能只是联盟驱动的排名。URL:/best/[category]/ 或 /[category]/best/。
Conversions(转换工具页):模式 "[X] to [Y]"("$10 USD to GBP"、"100 kg to lbs")。价值要求:准确实时的数据、快速可用的工具、推荐相关转换、移动端友好。URL:/convert/[from]-to-[to]/ 或 /[from]-to-[to]-converter/。
Comparisons(对比页):模式 "X] vs [Y]" 或 "[X] alternative"。价值要求:诚实均衡的分析、真实的特性对比数据、按用例给出明确推荐、产品变化时更新。URL:/compare/[x]-vs-[y]/ 或 /[x]-vs-[y]/。仓库将其与 competitors 技能联动——[skills/competitors/SKILL.md 提供了四种对比页格式(单一替代品、复数替代品、你 vs 竞品、竞品 vs 竞品)及完整的页面结构模板。
Examples(示例页):模式 "[type] examples"("saas landing page examples")。价值要求:真实高质量示例、截图或嵌入、分类/筛选、解释它们为什么有效。URL:/examples/[type]/。
Locations(地点页):模式 "[service/thing] in [location]"("dentists in austin")。价值要求:真实的本地数据(不只是换城市名)、列出本地服务商、本地化洞察(价格、法规)、地图集成有帮助。URL:/[service]/[city]/ 或 /locations/[city]/[service]/。
Personas(人群页):模式 "[product] for [audience]"("crm for real estate")。价值要求:真实的人群专属内容、突出相关特性、该群体的见证、该受众的专属用例。URL:/for/[persona]/ 或 /solutions/[industry]/。
Integrations(集成页):模式 "[your product] [other product] integration"("slack asana integration")。价值要求:真实的集成细节、安装说明、组合用例、可用的集成(不是 vaporware 空中楼阁)。URL:/integrations/[product]/ 或 /connect/[product]/。
Glossary(词汇表页):模式 "what is [term]"("what is pSEO")。价值要求:清晰准确的定义、示例和上下文、链接相关术语、比词典更有深度。URL:/glossary/[term]/ 或 /learn/[term]/。
Translations(多语言页):模式为同一内容多语言本地化。价值要求:高质量翻译(不只是 Google 直译)、文化本地化、正确实现 hreflang、母语者审校。URL:/[lang]/[page]/(如 yoursite.com/es/)。hreflang 的实现细节(自引用条目、互指、x-default、子目录策略)可参考 skills/seo-audit/SKILL.md 中的国际 SEO 章节——错误的 hreflang 会直接导致整个语种集群不被索引。
Directory(目录页):模式 "[category] tools"("ai copywriting tools")。价值要求:覆盖全面、实用的筛选/排序、每个条目有详情(不只是名字)、定期更新。URL:/directory/[category]/。
Profiles(档案页):模式 "[entity name]"("stripe ceo")。价值要求:准确且注明来源的信息、定期更新、独特洞察或聚合、不只是维基百科的翻版。URL:/people/[name]/ 或 /companies/[name]/。
五、实施框架:五步落地
1. 关键词模式研究(Keyword Pattern Research)
识别模式:
- 重复结构是什么?
- 变量有哪些?
- 存在多少唯一组合?
验证需求:
- 聚合搜索量;
- 量级分布(头部词 vs 长尾);
- 趋势方向。
这一步决定页面集群的规模上限与优先级排序。
2. 数据需求(Data Requirements)
识别数据源:
- 每个页面由哪些数据填充?
- 是一方数据、抓取数据、授权数据还是公开数据?
- 数据如何更新?
对照前面"专有数据"层级评估每条数据的可防御性,优先用高层级数据建页。
3. 模板设计(Template Design)
页面结构:
- 包含目标关键词的页头(Header);
- 独特的引言(不只是变量替换);
- 数据驱动的内容区块;
- 相关页面 / 内链;
- 与意图匹配的 CTA。
确保唯一性:
- 每个页面都需要独有价值;
- 基于数据的条件化内容(conditional content);
- 每页的原创洞察/分析。
4. 内部链接架构(Internal Linking Architecture)
Hub and spoke(轮轴与辐条)模型:
- Hub:主分类页;
- Spokes:各个程序化生成页;
- 相关辐条之间交叉链接。
避免孤儿页(orphan pages):
- 每个页面都能从主站到达;
- 为所有页面提供 XML 站点地图;
- 面包屑 + 结构化数据。
关于 URL 层次、导航与内链的详细设计(3 次点击规则、扁平 vs 深层结构、面包屑与 URL 对齐、/compare/、/integrations/、/templates/ 等 URL 模式表),可直接参考 skills/site-architecture/SKILL.md——它与本技能在页面层级和内链设计上互为补充。
5. 索引化策略(Indexation Strategy)
- 优先做高搜索量的模式;
- 对极薄变体使用 noindex;
- 深思熟虑地管理抓取预算(crawl budget);
- 按页面类型拆分站点地图。
六、质量检查:上线前与上线后
上线前检查清单(Pre-Launch Checklist)
内容质量:
- [ ] 每个页面提供独有价值
- [ ] 回答了搜索意图
- [ ] 可读且有用
技术 SEO:
- [ ] 唯一的标题与 meta description
- [ ] 正确的标题层级结构
- [ ] 实现了 Schema 标记
- [ ] 页面速度可接受
内部链接:
- [ ] 已接入站点架构
- [ ] 相关页面已链接
- [ ] 无孤儿页
索引化:
- [ ] 在 XML 站点地图中
- [ ] 可被抓取
- [ ] 无冲突的 noindex
上线后监控(Post-Launch Monitoring)
追踪指标:索引率(Indexation rate)、排名(Rankings)、流量(Traffic)、互动(Engagement)、转化(Conversion)。
警惕信号:薄内容警告、排名下滑、人工操作(Manual actions)、抓取错误。
评估集第 4 条(skills/programmatic-seo/evals/evals.json)演示了典型的失败诊断路径:500 页只被收录 80 页时,应依次排查——薄内容(每页是否真有独有价值)、抓取预算、内部链接可达性、XML 站点地图是否包含、robots.txt 是否误拦、重复/近似重复内容,并明确提醒:无论怎么优化,Google 都可能选择不收录薄页面。
七、常见错误清单
- 薄内容(Thin content):仅在相同内容里替换城市名;
- 关键词蚕食(Keyword cannibalization):多个页面争夺同一关键词;
- 过度生成(Over-generation):创建没有搜索需求的页面;
- 数据质量差(Poor data quality):过时或错误的信息;
- 忽视用户体验(Ignoring UX):页面是为 Google 做的,不是为用户做的。
八、输出格式规范
策略文档(Strategy Document)
- 机会分析(Opportunity analysis)
- 实施计划(Implementation plan)
- 内容规范(Content guidelines)
页面模板(Page Template)
- URL 结构
- 标题/meta 模板
- 内容大纲
- Schema 标记
关于模板化的 Schema 实现(JSON-LD、@graph 组合多种类型、BreadcrumbList/FAQPage 等与 pSEO 页面高度相关的类型、验证工具与常见错误),参见 skills/schema/SKILL.md;完整 JSON-LD 示例见其 references/schema-examples.md。值得注意:schema 技能明确建议"考虑为常见问题添加 FAQ schema"(competitors 技能同样如此),而 Google 的富结果测试工具(Rich Results Test)会渲染 JavaScript,可用来验证 JS 注入的 JSON-LD。
九、任务专属提问清单
- 你在瞄准哪些关键词模式?
- 你有哪些数据(或可以获得哪些数据)?
- 你计划做多少页面?
- 你的站点权威性如何?
- 当前谁在这些词上排名?
- 你的技术栈是什么?
这些问题的答案直接决定 playbook 选型、数据来源与页面规模。
十、关联技能协同
- seo-audit(skills/seo-audit/SKILL.md):上线后审计程序化页面——可抓取性、索引化、on-page 优化、站点速度、移动端友好、URL 结构与内容质量评估都在其职责范围;
- schema(skills/schema/SKILL.md):为规模化页面添加结构化数据,支持模板化 schema;
- site-architecture(skills/site-architecture/SKILL.md):页面层级、URL 结构与内部链接规划;
- competitors(skills/competitors/SKILL.md):对比页框架,配合 Comparisons playbook 使用。
在 README.md 的技能依赖图中,programmatic-seo 属于 "SEO & Discovery" 类别,与 seo-audit、ai-seo、site-architecture、competitors、schema、content-strategy 同组。这套技能按 Agent Skills 规范组织,每个技能目录均含 SKILL.md(触发描述与工作流)、references/(深度参考)与 evals/(评估用例),可用 npx skills add coreyhaines31/marketingskills --skill programmatic-seo 单独安装,也可整体克隆到 .agents/skills/ 或 .claude/skills/ 后由 Claude Code、Codex、Cursor 等代理自动识别调用。
一句话总结:pSEO 不是"模板 × 变量替换"的批量生产机器,而是一场"数据资产 × 模板工程 × 意图匹配"的系统工程——先评估、再选型、后设计、重内链、控索引、持续监控,才能在规模化与内容质量之间取得平衡。