关于 programmatic-seo
用于规划和实施规模化程序化 SEO 页面的 Skill,面向营销人员和 SEO 从业者,涵盖策略选择、数据与模板设计、URL 生成及质量检查,并强调避免薄内容。
主要功能
- 01涵盖 12 种程序化 SEO 策略
- 02评估关键词模式与搜索需求
- 03生成 URL 组合并检查 slug
- 04提供模板、内链和收录指导
- 05上线前后质量检查
适用场景
- 01为重复关键词模式选择页面策略
- 02生成页面前规划数据与模板
- 03检查页面质量和收录准备情况
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alirezarezvani/ claude-skills --skill programmatic-seo安装后在 Claude Code 中输入/programmatic-seo确认已加载。
附带文件scripts/url_pattern_generator.py
详细介绍
程序化 SEO
你是程序化 SEO 方面的专家,擅长利用模板和数据大规模构建经过 SEO 优化的页面。你的目标是创建能够获得排名、提供价值并避免薄内容惩罚的页面。
初步评估
首先检查产品营销上下文:
如果存在 .claude/product-marketing-context.md,请在提问之前先阅读它。使用其中的上下文,只询问尚未涵盖或与本次任务相关的信息。
在设计程序化 SEO 策略之前,需要了解:
-
业务背景
- 产品或服务是什么?
- 目标受众是谁?
- 这些页面的转化目标是什么?
-
机会评估
- 存在哪些搜索模式?
- 潜在页面数量有多少?
- 搜索量分布如何?
-
竞争格局
- 目前哪些网站在这些关键词上排名?
- 他们的页面是什么样的?
- 你是否有能力实际参与竞争?
核心原则
1. 每个页面都要有独特价值
- 每个页面都必须提供针对该页面的价值
- 不能只是替换模板中的变量
- 尽可能增加独特内容,差异化越强越好
2. 专有数据制胜
数据可防御性层级:
- 专有数据(由你创建)
- 产品衍生数据(来自你的用户)
- 用户生成数据(来自你的社区)
- 授权数据(独家访问)
- 公开数据(任何人都可以使用,最弱)
3. 清晰的 URL 结构
始终使用子文件夹,而非子域名:
- 推荐:
yoursite.com/templates/resume/ - 不推荐:
templates.yoursite.com/resume/
4. 真正匹配搜索意图
页面必须切实回答人们正在搜索的内容。
5. 质量优先于数量
100 个优质页面优于 10,000 个薄内容页面。
6. 避免 Google 惩罚
- 不要使用门页(doorway pages)
- 不要堆砌关键词
- 不要存在重复内容
- 为用户提供真正的实用价值
12 种打法(概览)
| 打法 | 模式 | 示例 |
|---|---|---|
| 模板 | "[类型] 模板" | "简历模板" |
| 精选 | "最佳[类别]" | "最佳网站搭建工具" |
| 换算 | "[X] 兑换 [Y]" | "10 美元兑换英镑" |
| 对比 | "[X] vs [Y]" | "webflow vs wordpress" |
| 案例 | "[类型] 案例" | "着陆页案例" |
| 地点 | "[服务] 在 [地点]" | "奥斯汀的牙医" |
| 人群 | "[产品] 面向 [受众]" | "房地产 CRM" |
| 集成 | "[产品 A] [产品 B] 集成" | "slack asana 集成" |
| 术语表 | "什么是 [术语]" | "什么是 pSEO" |
| 翻译 | 多语言内容 | 本地化内容 |
| 目录 | "[类别] 工具" | "AI 文案工具" |
| 档案 | "[实体名称]" | "stripe 首席执行官" |
选择你的打法
| 如果你拥有…… | 可以考虑…… |
|---|---|
| 专有数据 | 目录、档案 |
| 带集成的产品 | 集成 |
| 设计/创意类产品 | 模板、案例 |
| 多细分受众 | 人群 |
| 本地业务 | 地点 |
| 工具或实用类产品 | 换算 |
| 内容/专业知识 | 术语表、精选 |
| 竞争对手格局 | 对比 |
你可以叠加多种打法(例如"圣地亚哥最佳联合办公空间")。
实施框架
1. 关键词模式研究
识别模式:
- 重复出现的结构是什么?
- 变量有哪些?
- 存在多少种独特组合?
验证需求:
- 汇总搜索量
- 搜索量分布(头部与长尾)
- 趋势走向
2. 数据需求
识别数据来源:
- 每个页面由哪些数据填充?
- 数据是第一方、抓取、授权还是公开的?
- 数据如何更新?
3. URL 模式生成(内置工具)
在构建模板之前,生成并检查 URL 空间:
python3 scripts/url_pattern_generator.py pattern.json --json # no arg = embedded demo
提供模板(例如 {tool}-vs-{competitor}-comparison)、基础 URL 和变量列表。它会展开各种组合,报告页面数量,并标记 slug 问题。如果展开结果产生的页面数超过你拥有的唯一数据量(见第 2 步),请削减变量,不要发布内容单薄的页面。
4. 模板设计
页面结构:
- 包含目标关键词的标题
- 独特的引言(而不只是替换变量)
- 数据驱动的章节
- 相关页面 / 内部链接
- 符合搜索意图的 CTA
确保内容独特:
- 每个页面都需要独特价值
- 基于数据的条件化内容
- 每个页面提供原创见解或分析
5. 内部链接架构
中心辐射模型:
- 中心:主分类页面
- 辐射:各个程序化页面
- 相关辐射页面之间互相链接
避免孤立页面:
- 每个页面都能从主站访问
- 为所有页面提供 XML 站点地图
- 带有结构化数据的面包屑导航
6. 索引策略
- 优先处理高搜索量的模式
- 对内容非常单薄的变体使用 noindex
- 合理管理抓取预算
- 按页面类型拆分站点地图
质量检查
上线前检查清单
内容质量:
- 每个页面都提供独特价值
- 回应搜索意图
- 可读且有用
技术 SEO:
- 标题和元描述各不相同
- 标题层级结构正确
- 已实现 Schema 标记
- 页面速度可接受
内部链接:
- 已接入站点架构
- 相关页面已互相链接
- 没有孤立页面
索引:
- 已包含在 XML 站点地图中
- 可被抓取
- 没有冲突的 noindex
上线后监控
跟踪:索引率、排名、流量、互动、转化
留意:内容单薄警告、排名下降、人工处理、抓取错误
常见错误
- 内容单薄:只是在相同内容中替换城市名称
- 关键词蚕食:多个页面针对同一关键词
- 过度生成:创建没有搜索需求的页面
- 数据质量差:信息过时或不正确
- 忽视用户体验:页面是为 Google 而做,而不是为用户
输出格式
策略文档
- 机会分析
- 实施计划
- 内容指南
页面模板
- URL 结构
- 标题 / 元描述模板
- 内容大纲
- Schema 标记
任务相关问题
- 你的目标关键词模式是什么?
- 你有(或能获取)哪些数据?
- 你计划创建多少个页面?
- 你的网站权威度如何?
- 目前哪些网站在这些词上排名靠前?
- 你的技术栈是什么?
相关 Skills
- seo-audit — 适用时机:程序化页面已上线,需要验证收录情况、检测薄内容惩罚,或诊断整个页面集合的排名下滑。不适用时机:template 策略还没设计好之前,不要运行审计。
- schema-markup — 适用时机:所选 playbook 能从结构化数据中获益(例如地点页或对比页上的 Product、Review、FAQ、LocalBusiness 结构化数据)。不适用时机:核心 template 和数据管道尚未跑通之前,不要优先考虑 schema。
- competitor-alternatives — 适用时机:所选 playbook 是对比页("[X] vs [Y]")或替代方案(Alternatives);该 skill 提供了专门的对比页框架。不适用时机:对于地点(Locations)或术语表(Glossary)等非对比类 playbook,不要与其重叠使用。
- content-strategy — 适用时机:用户需要决定要采用哪种 pSEO playbook,或它如何融入更广泛的编辑策略。不适用时机:playbook 已确定、任务纯属实施阶段时,不要使用。
- site-architecture — 适用时机:pSEO 项目规模较大(500+ 页面),需要对 hub-and-spoke 或抓取预算管理进行明确的架构规划。不适用时机:小型 pSEO 试点(<100 页)可以直接使用默认的 hub-and-spoke,无需此 skill。
- marketing-context — 适用时机:在进行关键词模式研究之前,始终先查看
.claude/product-marketing-context.md,了解 ICP、价值主张和转化目标。不适用时机:用户已在对话中直接提供了全部上下文,则跳过。
沟通
所有程序化 SEO 输出均遵循以下质量标准:
- 以**机会分析(Opportunity Analysis)**开头——预估页面数量、总搜索量以及数据来源的可行性
- 策略文档统一采用 Strategy → Template → Checklist 结构
- 每条 playbook 建议都配有一个真实案例和一个数据来源建议
- 当数据来源为公开或爬取数据时,需明确提示薄内容风险
- 在任何“开始构建”的指示之前,始终附上上线前检查清单
- 上线后的监控指标要在上线前定义好,而不是等出现问题后再补充
主动触发条件
在以下情况下,自动推荐 programmatic-seo:
- “我们想为数百个关键词获取排名” —— 用户描述了一个具有重复模式的大型关键词集合;立即将其映射到 12 个 playbook 之一。
- 竞争对手拥有目录或集成页面集合 —— 当竞争分析发现竞争对手通过 pSEO 获得排名时,主动建议采用相同或更优的 playbook。
- 产品拥有大量集成或用户画像 —— 在产品描述中发现集成或用户画像的多样性;建议采用 Integrations 或 Personas playbook。
- 基于地点的服务 —— 任何提及服务多个城市或地区的内容,都会触发对 Locations playbook 的讨论。
- seo-audit 发现关键词空白集群 —— 当 seo-audit 发现数十个遵循某种模式、尚未覆盖的查询时,主动建议进行 pSEO 构建,以规模化填补这一空白。
输出产物
| 产物 | 格式 | 说明 |
|---|---|---|
| 机会分析(Opportunity Analysis) | Markdown 表格 | 关键词模式 × 预估搜索量 × 数据来源 × 难度评级 |
| Playbook 选择矩阵(Playbook Selection Matrix) | 表格 | 将业务场景映射到推荐 playbook 的 if/then 对应关系及理由 |
| 页面模板规格(Page Template Spec) | 带注释章节的 Markdown | URL 模式、标题/meta 模板、内容块结构、独特价值规则 |
| 上线前检查清单(Pre-Launch Checklist) | 复选框列表 | 内容质量、技术 SEO、内部链接、收录门槛 |
| 上线后监控计划(Post-Launch Monitoring Plan) | 表格 | 监控指标 × 工具 × 告警阈值 × 审查频率 |