programmatic-seo

概览

programmatic-seo 技能的作用

programmatic-seo 技能帮助你基于模板和结构化数据，在大规模上设计经过 SEO 优化的页面。你无需为每个页面手写从零开始，而是用这个技能来规划可重复的页面类型——例如“[keyword] + [city]” 页面、行业落地页、对比页、集成页、目录页和个人/公司档案页——同时确保每个页面仍然提供独特价值。

这个技能聚焦在策略与结构，而不是写文案或部署代码。它会引导你：

• 识别可行的 programmatic SEO 机会
• 选择合适的 playbook（templates、locations、comparisons、integrations、directories 等）
• 定义数据需求，确保每个页面都具备真实、有价值的内容，而不是薄弱内容
• 规划 URL 结构、站内链接和收录策略
• 避免在搜索中表现不佳的重复或近似重复内容

适用人群

如果你属于以下角色，可以使用 programmatic-seo 技能：

• SEO 专家与增长营销人员：计划为某个产品或平台上线数百甚至数千个落地页
• 内容和产品营销人员：希望打造可规模化、聚焦转化的内容（例如 “CRM for [industry]” 页面、“best [category]” 专题页，或集成目录）
• 创始人和产品团队：希望探索 programmatic SEO 以获客，而不打算组建庞大的内容团队

如果你只需要高层级的 SEO 策略或整体内容规划，可以先从 seo-audit 或 content-strategy 开始。当你明确需要的是规模化、模板化、数据驱动的落地页时，再使用 programmatic-seo。

programmatic-seo 技能解决的问题

这个技能专门针对 programmatic SEO 中常见的关键难题：

• Thin content 风险——它会推动你为每个页面定义独特价值，而不是只在模板里替换城市或行业名称。
• “我们到底要做什么？”——它基于 references/playbooks.md 中验证过的 programmatic SEO playbooks（templates、locations、comparisons、personas、integrations、directories、profiles 等），将通用模式与自身资产和受众匹配。
• “这么多 URL 和链接该怎么规划结构？”——它鼓励使用清晰的 URL 模式（如 /templates/[type]/、/best/[category]/、/locations/[city]/）以及清晰的内部链接策略。
• “我们实际需要哪些数据？”——它帮助你识别能够让每个页面真正有用的自有或精选数据。

如果你的主要目标只是“不带策略地自动生成大量文本”，而不是围绕独特数据构建体系，那么这个技能并不适合你；它的设计优先级是质量和实用性，而不是纯数量。

核心概念与仓库结构

在 programmatic-seo 技能目录中，你会看到：

• SKILL.md —— 核心 playbook，包含：
  • 初始评估问题（业务、受众、转化目标）
  • 机会与竞品分析的引导问题
  • 每页独特价值、自有数据等核心原则
• references/playbooks.md —— “The 12 Programmatic SEO Playbooks”，其中包含实际可用的模式，例如：
  • Templates（如 resume templates、invoice templates）
  • Curation（如 “best [category]”）
  • Comparisons（如 “Notion vs Asana”）
  • Locations、Personas、Integrations、Directory、Profiles 等
• evals/evals.json —— 示例 prompts 和期望行为，展示该技能在常见场景下应如何推理与回应（例如 “CRM for [industry]” 页面、多竞品对比页）。

理解这些文件，有助于你快速判断这个技能是否符合你的 programmatic SEO 目标。

使用方法

安装与配置

1. 安装 programmatic-seo 技能

在你的 agent 环境中添加该技能，运行：

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

这会从 coreyhaines31/marketingskills 拉取 programmatic-seo 的配置和相关参考文件到你的 skills 环境中。

2. 查看核心指导文件

安装完成后，先打开以下文件，了解技能的工作方式：

• SKILL.md —— 从头到尾阅读。它定义了 agent 作为 programmatic SEO 专家的角色，并说明：
  • 如何检查产品营销背景信息
  • 如何评估业务与搜索机会
  • 如何避免 thin content 的原则
• references/playbooks.md —— 浏览 12 个 programmatic SEO playbooks，并记录哪些模式适合你的业务（templates、curation、locations、personas、comparisons、integrations、glossary、directory、profiles 等）。
• evals/evals.json —— 查看示例 prompts（如 “CRM for [industry]” 页面、多竞品对比页），理解该技能应如何推理与回应。

如果你的仓库中包含 .agents/product-marketing-context.md（或旧版本中的 .claude/product-marketing-context.md），请确保内容准确、最新；技能会首先查找这个文件，用它来锚定后续推荐。

为新项目运行 programmatic-seo

1. 准备产品与受众背景

在让 agent 设计 programmatic SEO 策略之前，请准备：

• 一段简短的产品/服务描述
• 你的核心目标受众或细分人群
• 主要转化目标（试用注册、demo 预约、购买、订阅 newsletter 等）

技能会根据这些输入（在 SKILL.md 中也有体现），避免产出通用模版，而是尽量贴合你的实际转化漏斗给出建议。

2. 定义 programmatic SEO 机会

当你已经识别出可规模化的模式时，再触发这个技能，例如：

• “我们想为 20 个行业搭建 ‘CRM for [industry]’ 页面。”
• “我们想为 15 个竞争对手创建 ‘[Our product] vs [Competitor]’ 的对比页。”
• “我们想搭一个 ‘[service] providers in [city]’ 的服务商目录。”
• “我们想做 ‘invoice template’、‘quote template’ 等模板页面。”

技能会：

• 识别你需求对应的 playbook 类型（如 Personas、Comparisons、Locations、Templates、Directory）
• 追问缺失的上下文
• 提出一个结构化方案：关键词模式、数据需求、模板结构、内部链接及收录策略

3. 选择并打磨你的 playbook

借助 references/playbooks.md，技能可以：

• 选择一个或多个与想法匹配的 playbook
• 解释某个模式为何适合你的细分领域
• 列出价值要求（例如，对 Templates：实际可下载资源、多种变体、高质量；对 Curation：明确评估标准与定期更新等）

随后你可以进一步调优方向，例如：

• 不只是做 “Locations”，而是组合 Locations + Directory（如：按城市提供服务商目录）
• 将 Comparisons + Conversions 结合（如：对比页同时强化 CTA，推动试用/注册）

4. 规划数据与内容结构

在 programmatic-seo 中，一个核心目标是每个页面都有独特价值。在实践中，技能会帮助你：

• 列出每个页面需要收集或生成的关键数据点（如：行业痛点、城市层级的统计数据、不同垂直场景下的功能使用情况）
• 将这些数据点映射进模板结构（hero 区域、社会证明、对比表、FAQs、本地/细分场景细节等版块）
• 决定将自有数据、真实案例或精选洞察放在页面的哪些位置，避免只是在通用文本中替换关键词

这一阶段对“是否值得安装和使用这个技能”尤其关键：它能帮助你判断，自己是否拥有足够的结构化数据，使 programmatic SEO 变得真正有价值。

5. 定义 URL 与内部链接策略

基于 references/playbooks.md 中的示例，技能可以为你建议：

• URL 结构，例如：
  • /templates/[type]/ 或 /templates/[category]/[type]/
  • /best/[category]/
  • /locations/[city]/
  • /integrations/[tool]/
• 站内链接模式，例如：
  • 每个行业页面链接到一个核心 “Industries” hub 页
  • 对比页链接回主产品页和 pricing 页面
  • 目录中的条目链接回城市页，城市页也反向链接目录条目

这种前期规划非常重要，因为大规模 URL 结构一旦成型，再去整体重构的成本会非常高。

6. 用 eval 场景校验方案

使用 evals/evals.json 中的示例作为检查清单：

• 你是否检查并利用了现有的 product marketing context？
• 是否落实了核心原则（每页独特价值、自有数据、清晰 URL）？
• 是否为每种变体规划了关键词研究与数据采集？
• 是否考虑了内部链接策略并对 thin content 发出预警？

如果根据这些 eval 标准来看，你当前的方案会“不及格”，就需要回头调整数据模型或缩小范围，直到每个页面都能真正独立成立、具备足够价值。

何时适合（或不适合）使用这个技能

推荐使用 programmatic-seo 的情况：

• 你有一种可以扩展出很多变体的页面类型（locations、industries、integrations、use cases、templates、profiles 等）
• 你能获取或生产结构化数据，使每个变体之间有实质差异
• 你需要的是一套面向高意图、聚焦转化的落地页战略蓝图

不太适合使用的情况：

• 你只需要少量零散的落地页（此时一般 landing page 技能或人工内容就足够）
• 你完全缺乏数据或差异化角度，只是想让“AI 一次性生成 1000 个页面”——该技能会明确提醒你不要这样做
• 你的主要诉求是技术 SEO 体检或全站问题排查（请改用 seo-audit）

常见问题（FAQ）

programmatic-seo 技能的主要用途是什么？

programmatic-seo 技能的核心是帮助你规划和设计 programmatic SEO 项目——也就是大量模板化、数据驱动的落地页集群，既能获得排名又能产生转化，同时尽量降低 thin content 的风险。它重点关注策略、数据设计和页面结构，而不是自动发布页面。

如何安装 programmatic-seo 技能？

通过 Skills CLI 安装：

npx skills add https://github.com/coreyhaines31/marketingskills --skill programmatic-seo

然后在 skills/programmatic-seo 目录中查看 SKILL.md、references/playbooks.md 和 evals/evals.json，了解该技能会如何影响你的 agent 行为。

使用 programmatic-seo 可以设计哪些类型的页面？

基于 references/playbooks.md 中的 playbooks，这个技能适合以下模式：

• Templates（如 “invoice template”、“resume template”）
• Curation 列表（如 “best [category]”、“top [number] [tools]”）
• Comparisons（如 “[Product] vs [Competitor]”）
• Locations（如 “[service] in [city]”）
• Personas 或行业（如 “CRM for [industry]”）
• Integrations（如 “[Product] + [Tool]” 页面）
• Directories 与 profiles（如 marketplace、专家目录）

技能会帮助你在这些模式中进行选择和组合，以适配你的产品形态和数据资源。

这个技能如何帮助在 programmatic SEO 中避免 thin content？

SKILL.md 明确强调每个页面都必须具有独特价值，尤其要体现在自有数据、真实案例或有意义的精选内容上。技能会通过 evals/evals.json 中的评估来检查是否：

• 明确了区分每个页面所需的数据要求
• 对“仅在模板中替换关键词或城市名”的做法发出警示
• 鼓励使用简洁、有目的性的 URL 和内部链接结构

如果你的方案无法满足这些标准，技能会推动你缩小项目范围或提升数据质量，然后再进行规模化扩展。

我可以把 programmatic-seo 用在已有的大量表现不佳的页面上吗？

可以。不过这个技能更偏向于设计或重新设计结构化页面类型，而不是做技术层面的审计。你可以：

• 利用 playbooks 重新思考现有模式（如本地化页面、行业页面）
• 重新定义模板结构和数据要求，让每个页面的实际价值变得更高

对于抓取问题、索引异常或整体站点健康排查，建议同时使用 seo-audit 技能做配套分析。

programmatic-seo 与通用内容策略技能有什么不同？

content-strategy 更关注整体内容规划：选题、形式和内容日历等；而 programmatic-seo 专注于可重复、数据支撑的模板（如目录页、对比页、本地化页面）以及让这些模板可以规模化落地的系统。当前你的核心问题是“如何设计几百个真正有用的 SEO 落地页？”，就用 programmatic-seo；如果你的问题是“这个季度我们博客应该写什么？”，则更适合用 content-strategy。

在使用 programmatic-seo 前，我需要提前具备哪些条件？

如果你已经具备以下条件，将能从这个技能中获得最大收益：

• 明确的产品与目标受众画像
• 至少一种可重复的页面模式（如行业、城市、竞品、模板等）
• 某种形式的结构化数据，或可收集这类数据的能力（如内部指标、平台列表、精选清单或研究数据）

即使这些条件尚不完备，你也可以先安装技能，用它来识别目前的不足，但在正式执行大规模 programmatic SEO 项目前，很可能还需要补足相关准备工作。