前言¶
「多城市落地页」「工具对比页」「集成说明页」这类需求，手工写几十页不现实，纯脚本拼字符串又容易变成薄内容、触发搜索引擎惩罚。Programmatic SEO（pSEO）的做法是：固定页面骨架，用数据填充变量，同时保证每一页对搜索意图有独立价值。下面介绍 Marketing Skills 系列里的 programmatic-seo Skill——它把策略、12 种页面玩法、实施框架和质检清单写进 Agent 指令，让对话式工具按同一套方法论帮你规划和落地批量 SEO 页面。
这是什么¶
programmatic-seo 是 coreyhaines31/marketingskills 仓库中的 Agent Skill（metadata.version 为 2.1.0）。Skill 自述定位为：在「模板 + 数据」前提下，批量创建以 SEO 为目标的页面，并兼顾排名、用户价值与避免 thin content。
触发场景包括用户提到 programmatic SEO、pSEO、template pages、directory / location / comparison pages、「[keyword] + [city]」、一次性生成大量相似落地页，或询问 pSEO 该用什么 CMS 等。若要做站内 SEO 审计或内容策略规划，官方建议分别使用同系列的 seo-audit、content-strategy。
核心功能¶
启动前的上下文与评估¶
执行策略前，Skill 要求先检查是否存在产品营销上下文文件，路径优先级为：
.agents/product-marketing.md.claude/product-marketing.md- 旧版文件名
product-marketing-context.md
若存在则先读取，再只追问文件中未覆盖、且与本任务相关的信息。设计 pSEO 前需弄清：业务与转化目标、搜索模式与潜在页面规模、竞品当前排名与页面形态。
六条核心原则¶
- 每页独特价值：不能只是模板里换几个变量。
- 数据可防御性：自有数据 > 产品衍生 > 用户生成 > 独家授权 > 公开数据（最弱）。
- URL 用子目录而非子域名（例如
yoursite.com/templates/resume/优于templates.yoursite.com/resume/）。 - 真实匹配搜索意图。
- 质量优先于数量（宁可 100 页高质量，也不要上万页薄内容）。
- 规避惩罚：避免门页、关键词堆砌、重复内容；页面须对用户有实际用处。
12 种 Playbook 概览¶
| 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 的详细实施见仓库内 references/playbooks.md。选型时可对照数据与产品形态（例如有专有数据可考虑 Directory / Profiles；有集成生态可做 Integrations；本地业务可做 Locations），且可叠加多种模式（如「Best coworking spaces in San Diego」）。
实施框架（六步）¶
- 关键词模式研究：识别重复结构与变量、组合数量；用聚合搜索量、头尾分布与趋势验证需求。
- 数据需求：明确每页字段来源（一方、抓取、授权、公开）与更新方式。
- 模板设计：标题区、非套话式导语、数据区块、相关内链、匹配意图的 CTA；用条件内容与逐页分析保证差异化。
- 内链架构：Hub-and-spoke（类目 Hub + 程序化 Spoke），Spoke 互链；避免孤岛页；sitemap、面包屑与结构化数据。
- 索引策略：优先高量模式；极薄变体可 noindex；按页面类型拆分 sitemap，注意抓取预算。
- 选型搭建平台：需支撑页面规模、数据刷新、服务端 HTML、按数据分支渲染、单页索引控制；优先沿用现有 CMS，否则挂在主域子路径。平台对比见
references/implementation-platforms.md。
质量与输出¶
上线前检查清单覆盖：内容独特性与意图匹配、title/meta 与标题层级、Schema、速度、内链与 sitemap、无冲突 noindex。上线后跟踪索引率、排名、流量、互动与转化；留意 thin content 警告、排名下跌、人工处置与抓取错误。
常见失误包括：只换城市名的薄内容、关键词自相蚕食、无搜索需求的过度铺页、数据陈旧、只为 Google 不做 UX。
Skill 约定的交付形态包括：策略文档（机会分析、实施计划、内容规范）与 页面模板（URL、title/meta 模板、内容大纲、Schema）。
任务中会主动追问：目标关键词模式、可用数据、计划页数、站点权威度、竞品排名者、技术栈等。
关联 Skill：seo-audit（上线后审计）、schema（结构化数据）、site-architecture（层级与内链）、competitors（对比页框架）。
安装与启用¶
本 Skill 遵循通用 SKILL.md 格式，源码目录为：
https://github.com/coreyhaines31/marketingskills/tree/main/skills/programmatic-seo
将 programmatic-seo 目录（含 SKILL.md 及 references/ 等）放入你所用 Agent 产品约定的 Skills 路径后，在对话中描述 pSEO 或上述触发词即可调用。已抓取资料中未给出 Cursor、Codex CLI、Claude Code 的统一安装命令或差异化配置，此处不展开各客户端差异。
典型用法¶
在已启用该 Skill 的 Agent 中，可按官方任务清单组织一次会话，例如：
- 说明产品与转化目标，并准备好
.agents/product-marketing.md（若已有）。 - 明确关键词模式，例如「
[CRM] for [行业]」或「[工具 A] vs [工具 B]」。 - 列出可填充模板的一方或授权数据源，以及计划页面数量区间。
- 要求输出：机会评估、选定 Playbook、URL 与子目录结构、单页模板大纲、内链 Hub 设计、上线前检查清单。
Skill 内置的 Output Format 可直接作为验收标准：是否给出策略文档与可复制的页面模板（含 Schema 要点）。
适用场景与注意¶
适合：增长、内容或全栈同学需要系统规划大批量 SEO 页面（目录、地域、对比、集成、术语库等），且希望在对话里固定「质量优先、数据可防御、避免门页」的约束，而不是让模型自由发挥拼页。
注意：Skill 是方法论与检查清单，不替代关键词工具、CMS 实现或法务对抓取/授权数据的审查；references/ 下的 playbooks 与平台文档需在仓库内打开细读。批量页面上线后应配合 seo-audit 做审计。官方页面 officialskills.sh 在本次资料抓取中未成功，以 GitHub 仓库内容为准。
结尾¶
programmatic-seo 把 pSEO 从「批量建站」收敛成可执行的 Playbook、实施六步与质检列表，适合作为 Marketing Skills 里偏技术深度的一条。需要完整 Skill 定义与引用文档时，请直接查看官方仓库：
https://github.com/coreyhaines31/marketingskills/tree/main/skills/programmatic-seo
