mcpField
P
programmatic-seo

programmatic-seo

github.com/alirezarezvani营销与增长29.0k618 次安装1 天前更新
代码仓库

关于 programmatic-seo

用于规划和实施规模化程序化 SEO 页面的 Skill,面向营销人员和 SEO 从业者,涵盖策略选择、数据与模板设计、URL 生成及质量检查,并强调避免薄内容。

主要功能

  1. 01涵盖 12 种程序化 SEO 策略
  2. 02评估关键词模式与搜索需求
  3. 03生成 URL 组合并检查 slug
  4. 04提供模板、内链和收录指导
  5. 05上线前后质量检查

适用场景

  1. 01为重复关键词模式选择页面策略
  2. 02生成页面前规划数据与模板
  3. 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. 竞争格局

    • 目前哪些网站在这些关键词上排名?
    • 他们的页面是什么样的?
    • 你是否有能力实际参与竞争?

核心原则

1. 每个页面都要有独特价值
  • 每个页面都必须提供针对该页面的价值
  • 不能只是替换模板中的变量
  • 尽可能增加独特内容,差异化越强越好
2. 专有数据制胜

数据可防御性层级:

  1. 专有数据(由你创建)
  2. 产品衍生数据(来自你的用户)
  3. 用户生成数据(来自你的社区)
  4. 授权数据(独家访问)
  5. 公开数据(任何人都可以使用,最弱)
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 标记

任务相关问题

  1. 你的目标关键词模式是什么?
  2. 你有(或能获取)哪些数据?
  3. 你计划创建多少个页面?
  4. 你的网站权威度如何?
  5. 目前哪些网站在这些词上排名靠前?
  6. 你的技术栈是什么?

相关 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:

  1. “我们想为数百个关键词获取排名” —— 用户描述了一个具有重复模式的大型关键词集合;立即将其映射到 12 个 playbook 之一。
  2. 竞争对手拥有目录或集成页面集合 —— 当竞争分析发现竞争对手通过 pSEO 获得排名时,主动建议采用相同或更优的 playbook。
  3. 产品拥有大量集成或用户画像 —— 在产品描述中发现集成或用户画像的多样性;建议采用 Integrations 或 Personas playbook。
  4. 基于地点的服务 —— 任何提及服务多个城市或地区的内容,都会触发对 Locations playbook 的讨论。
  5. seo-audit 发现关键词空白集群 —— 当 seo-audit 发现数十个遵循某种模式、尚未覆盖的查询时,主动建议进行 pSEO 构建,以规模化填补这一空白。

输出产物

产物格式说明
机会分析(Opportunity Analysis)Markdown 表格关键词模式 × 预估搜索量 × 数据来源 × 难度评级
Playbook 选择矩阵(Playbook Selection Matrix)表格将业务场景映射到推荐 playbook 的 if/then 对应关系及理由
页面模板规格(Page Template Spec)带注释章节的 MarkdownURL 模式、标题/meta 模板、内容块结构、独特价值规则
上线前检查清单(Pre-Launch Checklist)复选框列表内容质量、技术 SEO、内部链接、收录门槛
上线后监控计划(Post-Launch Monitoring Plan)表格监控指标 × 工具 × 告警阈值 × 审查频率

评论

支持 Markdown