programmatic-seo

programmatic-seo skill 概览

programmatic-seo skill 是做什么的

programmatic-seo skill 用来帮助你用模板、结构化数据和可复用的页面模式，批量规划 SEO 页面。它特别适合这类场景：城市/地区页、对比页、集成页、行业页、目录页、术语页，以及其他类似的“多页面”SEO 系统。在这些场景里，通用型 prompt 往往会低估内容单薄（thin content）的风险。

谁适合使用这个 skill

这个 programmatic-seo skill 最适合：

• 需要规划几十到上千个落地页的市场团队
• 想先验证 pSEO 是否值得投入的创始人
• 需要筛选页面类型和 URL 模式的 SEO/内容团队
• 手里有结构化数据、集成能力、示例素材或自有资产的产品驱动型团队

如果你只需要写少量编辑型文章，或者只是在做一个通用内容日历，它的帮助就没那么大。

它真正解决的核心问题

大多数用户真正需要的并不是“帮我生成 100 个 SEO 页面”，而是先回答几个更难的问题：

• 哪一种页面模式真正可行
• 每个页面要靠什么差异化，才足以获得排名
• 上线前到底需要哪些数据或资产
• 如何避免一次性发布大量内容单薄的页面
• 页面模板如何与业务目标和内链结构打通

这正是 programmatic-seo 比普通 brainstorming prompt 更强的地方。

这个 skill 的差异化在哪里

这个仓库一开始就强调了两个会直接影响决策的关键点：每个页面都必须有真实、独立的价值；而且相比简单替换关键词的模板，自有数据或实际工具价值通常更容易做出效果。它还在 references/playbooks.md 里提供了具体的 pSEO playbook，这比一句笼统的“做可规模化页面”更有实操价值。

什么情况下应该跳过 programmatic-seo

以下情况不建议使用 programmatic-seo：

• 你主要是在排查现有站点的 SEO 问题
• 你需要的是偏 Top-of-Funnel 的博客内容策略，而不是模板化页面
• 你唯一的差异化只是替换城市、行业或竞品名称，没有真实内容增量
• 你没有结构化输入、没有产品功能支撑，也没有可信的方法让页面之间形成实质区别

如何使用 programmatic-seo skill

安装 programmatic-seo skill

通过仓库安装：

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

安装后，当你的任务明确是在搭建可复用的 SEO 页面系统，而不是写单篇文章时，再把它接入你的 AI 工作流。

先读这几个文件

如果你是为了使用这个 programmatic-seo 指南，最值得优先阅读的顺序是：

1. skills/programmatic-seo/SKILL.md
2. skills/programmatic-seo/references/playbooks.md
3. skills/programmatic-seo/evals/evals.json

为什么按这个顺序读：

• SKILL.md 讲的是工作原则和评估流程
• references/playbooks.md 帮你把合适的页面类型和你的业务资产对应起来
• evals/evals.json 能让你看到高质量输出通常应该包含哪些内容

提问前先补齐产品上下文

这个 skill 明确要求先检查 .agents/product-marketing-context.md 或 .claude/product-marketing-context.md。这一步很重要，因为强 pSEO 方案高度依赖产品、受众、转化目标和现有定位。如果这些文件存在，先让模型读完，再开始问策略问题。

先确认这个 skill 需要什么输入

你的 programmatic-seo usage 质量，很大程度取决于你提供的输入。建议至少给出：

• 产品或服务描述
• 目标客户和搜索意图
• 页面对应的转化目标
• 候选关键词模式
• 预估页面数量
• 你目前已有的结构化数据
• 哪些自有数据、案例或产品功能能让页面真正有用
• 当前是谁在排名，他们为什么难以超越

如果这些信息缺失，输出基本只会停留在高层建议。

把模糊想法改写成高质量 prompt

弱 prompt：

• “Help us do programmatic SEO for our SaaS.”

更好的 prompt：

• “We sell CRM software for SMBs. We are considering CRM for [industry] pages for 40 industries. Our goal is demo bookings. We have customer examples, industry workflow templates, and benchmark data for 12 industries. Competitors rank mostly with generic copy. Help us assess whether this programmatic-seo idea is viable, which playbook it fits, what makes each page genuinely unique, what template sections we need, and what pages should not be published until we have stronger data.”

这个更好的 prompt 给了 skill 足够的信息去判断“是否适合做”，而不只是机械地产出一堆看起来很积极的建议。

用 playbook 给你的想法归类

这个 programmatic-seo skill 一个非常实用的点，就是它用 playbook 来组织思路。根据 references/playbooks.md，常见模式包括：

• templates
• curation
• comparisons
• examples
• locations
• personas
• integrations
• glossary
• translations
• directory
• profiles

这一步很重要，因为“programmatic SEO”本身太宽泛了。CRM for healthcare 的建设方式，和 Notion vs Asana 不一样，和 /integrations/[tool]/ 页面也完全不是同一种打法。你最终选择的 playbook，会直接决定数据要求、模板结构和质量门槛。

用这个 skill 反向检验页面是否真的有独特性

最重要的使用习惯是：要求这个 skill 解释，为什么每个页面都值得独立存在。好的 prompt 应该要求它输出：

• 针对该页面类型的独特版块思路
• 可以利用的自有数据机会
• 产品层面的专属实用价值
• 在不同页面变体之间会发生实质变化的页面元素
• 哪些组合应该 noindex、合并，或者干脆不要做

如果答案大部分只是把变量替换进标题里，那就该及时停下来。这正是这个 skill 最擅长帮你提前暴露的核心风险。

不要只要页面想法，还要要实现方案

一个高质量的 programmatic-seo guide prompt，应该要求输出：

• 机会评估
• 模板和数据模型
• URL 结构
• 内链方案
• 收录标准
• 转化元素放置位置
• 上线顺序
• 质量控制检查项

这样才能把 skill 推向“可执行方案”，而不是停留在关键词清单层面。

用 evals 校准你对输出的预期

这些 eval 示例其实能很好地告诉你，这个 skill 认为什么样的输出才算完整。比如对比页和 persona 类页面，理想输出通常应包含：

• playbook 识别
• 独特价值要求
• 自有洞察或数据机会
• 模板设计建议
• 内链策略
• thin-content 风险提醒

如果你的输出缺了这些，大概率不是 skill 不行，而是你的 prompt 还不够具体。

一套适合 SEO Content 团队的 programmatic-seo 实操流程

推荐按这个顺序来：

1. 确认业务目标和转化事件
2. 判断最可能适合的 playbook
3. 估算页面规模和搜索模式
4. 定义什么数据能让页面真正形成差异
5. 围绕“实用价值”设计模板，而不是只围绕关键词
6. 决定哪些页面符合收录条件
7. 从核心页面到各变体页面建立内链，并让变体之间也能互链
8. 先上线一小批高质量页面，再决定是否全面扩张

对于那些很容易一上来就想“全部发出去”的 programmatic-seo for SEO Content 团队，这套流程尤其有用。

programmatic-seo skill 常见问题

programmatic-seo skill 适合新手吗？

适合，前提是你已经理解搜索意图、模板、内链这些基础 SEO 概念。这个 skill 的实用之处在于，它把 pSEO 拆成一组 playbook 和约束条件来讲，而不是把它包装成一个抽象的增长套路。不过如果你是完全新手，可能还是需要另外补上关键词研究和技术 SEO 基础。

programmatic-seo 和普通 SEO prompt 有什么不同？

普通 prompt 很容易产出泛泛的页面创意。而这个 programmatic-seo skill 更适合以下需求：

• 在真正开做前先做适配性判断
• 提前提示 thin-content 风险
• 指出如何在规模化前提下保持独特性
• 按你的业务模式匹配合适的 playbook
• 给出可重复执行的上线结构

这会让你在安装和采用时更有把握，也能减少上线劣质页面的概率。

哪些业务最适合用？

最佳适配场景：

• 具备 integrations、comparisons、templates 或垂直行业场景的 SaaS
• marketplace 和 directory 类产品
• 拥有结构化库存或 profile 数据的产品
• 拥有自有数据集、benchmark、案例或用户生成内容的公司

相对较弱的适配场景：

• 数据很少、页面之间又缺乏差异化的业务
• 寄希望于仅靠 pSEO 弥补产品与市场匹配度不足的团队

这个 skill 会直接帮我生成页面吗？

它主要解决的是策略、结构和决策问题，而不是批量生产最终页面。你可以用它的输出去设计模板，再接到别的生成流程里，但它真正的价值在于帮你判断：哪些页面应该存在、每类页面应该达到什么质量门槛。

什么情况下不该用 programmatic-seo？

以下情况建议跳过：

• 你需要的是博客内容营销策略
• 你想做技术 SEO 审核
• 你的网站只需要少量手工撰写的落地页
• 你无法提供除变量 token 之外任何有意义的页面级输入

仓库里有配套材料吗？

有。最值得看的配套资产是 references/playbooks.md，它把 12 种 pSEO 模式对应到价值要求和 URL 结构上。evals/evals.json 也很值得读，因为它能直接透露这个 skill 对真实 prompt 的推理质量要求。

如何改进 programmatic-seo skill 的使用效果

给这个 skill 更强的业务输入

想快速提升 programmatic-seo 输出质量，最快的方法就是一开始就补足业务上下文：

• 收入模式
• 受众细分
• 目标动作
• 现有权威性
• 可用的结构化数据
• 能让每个页面形成个性化差异的产品功能

当它能把页面和转化、差异化联系起来时，表现会明显更好。

让它主动否掉坏想法

不要只问“我们该怎么做？”，也要补问：

• “哪些页面变体我们应该避免？”
• “哪些页面会很薄？”
• “哪些数据缺口会阻碍上线？”
• “什么情况下这个策略根本不可行？”

这样一来，programmatic-seo skill 会更适合拿来做决策，也能避免给你虚假的信心。

提供你数据集里的样例行

如果你已经有 spreadsheet、directory、inventory 或 competitor list，尽量附上 5 到 10 行样例数据。这会帮助 skill：

• 找出字段过弱的问题
• 识别哪些属性值得进模板
• 建议更合适的页面版块
• 估算页面之间能否形成足够明确的差异感

绝大多数时候，具体样例行都比抽象描述更有用。

让它按“用途”来设计模板版块

不要只说“写一个页面模板”，而要要求它按照用户需求去设计版块，例如：

• 这个页面帮助用户完成什么
• 这个变体具体改变了什么
• 有哪些证明材料或 benchmark 数据
• 产品为什么适合这个场景
• 有哪些对比或决策辅助信息
• 与页面意图匹配的 CTA 应该怎么放

这样能显著提高页面实用性，也能减少模板化套话。

盯住 programmatic-seo 的主要失败模式

这个 skill 本来就是为了帮你抓出常见 pSEO 失误而设计的，例如：

• 只是替换变量、没有新增价值的页面
• 一次性发布过多低信号组合
• 忽视内链
• 选了和自身资产不匹配的 playbook
• 误以为只要有搜索量就值得做
• 页面到产品之间没有清晰转化路径

如果输出没有覆盖这些问题，就说明 prompt 还需要继续打磨。

拿到第一版策略后继续追问

第一轮回答之后，可以继续这样追问：

• “Score these 30 page ideas by value and uniqueness.”
• “Which 10 should launch first?”
• “What data fields are mandatory before publishing?”
• “Show a high-quality template for one example page.”
• “What internal links should connect these pages to core commercial pages?”

通常从这一轮开始，programmatic-seo skill 才会明显拉开和单次 prompt 的差距。

把 programmatic-seo 和相邻 skill 分工使用

这个仓库本身也明确提示：不同任务要用不同工具。用 programmatic-seo 来处理可规模化页面系统，然后把以下任务交给其他工具或 skill：

• SEO audits
• broader content strategy
• page copy polishing
• technical implementation

这种分工能让 programmatic-seo skill 保持聚焦：专门判断一个 pSEO 系统是否值得存在，以及应该怎样把结构搭好。