programmatic-seo

/digital-marketing-pro:programmatic-seo

目的

基于结构化数据源（数据库、API、CSV/JSON 文件）规划和审核大规模生成的 SEO 页面。通过质量门槛防止因内容单薄而受罚、索引膨胀以及违反 Google 的规模化内容滥用政策。

所需输入

用户必须提供（或系统会提示用户提供）：

• URL 或数据源：要审核的现有程序化页面，或用于规划的数据源详情
• 页面类型：正在生成的页面类型（地点、产品、集成、术语表、模板、工具）
• 数据源：CSV/JSON 文件、API 端点、数据库查询，或要分析的现有页面
• 目标规模：将生成的页面数量
• 当前状态：新建，还是审核现有程序化页面

流程

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前启用的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用行业背景信息和合规规则。检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中的品牌指南。
2. 评估数据源：评估为程序化页面提供数据的质量——行数、列的唯一性、缺失值、重复项检测（字段重合度 >80%）、数据新鲜度
3. 规划模板引擎：设计能够生成真正独特页面的模板——变量注入点、内容块（静态与动态）、条件逻辑、补充内容。验证每个页面都通过“独立价值测试”
4. 制定 URL 模式策略：设计 URL 层级结构——小写连字符 slug、逻辑结构、确保唯一性、长度低于 100 个字符、统一使用或不使用尾部斜杠
5. 自动化内部链接：枢纽/辐射模型、相关项目（每页 3-5 个）、带有 BreadcrumbList schema 的面包屑导航、基于共享属性的交叉链接、多样化的锚文本
6. 检查内容单薄防护措施：应用质量门槛（见下文）
7. 制定规范网址策略：自引用规范网址、参数处理、分页策略、手动设置页面优先级
8. 整合站点地图：自动生成条目，每 50K 个 URL 拆分一次，根据实际数据时间戳设置 <lastmod>，排除已设置 noindex 的页面
9. 防止索引膨胀：对低价值页面设置 noindex、处理分页、规范化分面导航、针对 10K+ 个页面监控抓取预算
10. 评分并报告：对每个维度评分，生成按优先级排序的行动计划

质量门槛

规模阈值

指标	阈值	操作
未经内容审核的页面	100+	警告：发布前必须进行内容审核
未提供理由的页面	500+	强制停止：必须获得用户明确批准并进行内容单薄审核
每页独特内容占比	<40%	标记为内容单薄（有受罚风险）
每页独特内容占比	<30%	强制停止：存在规模化内容滥用风险
每页字数	<300	标记以供审核（可能缺乏足够价值）

规模化内容滥用背景（2025-2026）

Google 的规模化内容滥用政策（于 2024 年 3 月推出）在执行方面大幅升级：

• 2025 年 6 月：一波人工处置针对大规模 AI 生成内容展开
• 2025 年 8 月：SpamBrain 更新增强了对 AI 生成链接方案和内容农场的模式检测能力
• 结果：搜索结果中的低质量、非原创内容减少了 45%

针对程序化页面的质量门槛升级：

• 内容差异化：任意两个程序化页面之间至少 30-40% 的内容必须真正独特（不能只是替换城市名或关键词）
• 人工审核：发布前至少抽样审核 5-10% 的生成页面
• 逐步上线：分批发布，每批 50-100 个页面。监测索引和排名 2-4 周后再扩大规模。未经质量审核，切勿一次性发布 500 个以上页面。
• 独立价值测试：每个页面都应通过以下测试：“即使不存在其他类似页面，这个页面也值得发布吗？”
• 网站声誉滥用：在高权威域名（非自有域名）下发布程序化内容，可能触发网站声誉滥用处罚（自 2024 年 11 月起严格执行）

安全与高风险的程序化页面

可安全大规模发布：

• 集成页面（包含真实的设置文档、API 详情和屏幕截图）
• 模板/工具页面（包含可下载内容和使用说明）
• 术语表页面（包含 200 个以上词语的定义、示例和相关术语）
• 产品页面（包含独特的规格、评论和比较数据）
• 数据驱动页面（针对每条记录提供独特统计数据、图表和分析）

大规模发布时存在处罚风险：

• 仅在相同文本中替换城市名的地点页面
• 不提供行业特定价值的“适用于[行业]的最佳[工具]”
• 不含真实比较数据的“[竞争对手]替代方案”
• 未经人工审核且没有独特增值内容的 AI 生成页面
• 模板套话占内容 60% 以上的页面

独特性计算

独特内容百分比 =（此页面独有的词数）/（页面总词数）x 100

与程序化页面集合中的所有其他页面比较。共享的页眉、页脚和导航不计入。模板套话计入。

URL 模式库

常见模式

• /tools/[tool-name]：工具/产品目录页面
• /[city]/[service]：地点 + 服务页面
• /integrations/[platform]：集成着陆页
• /glossary/[term]：定义/参考页面
• /templates/[template-name]：可下载模板页面
• /compare/[product-a]-vs-[product-b]：比较页面

URL 规则

• 使用小写、连字符分隔的标识，由数据生成
• 采用反映网站架构的逻辑层级
• 不得有重复标识 — 在生成时确保唯一性
• URL 长度保持在 100 个字符以内
• 主要内容 URL 不使用查询参数
• 统一使用尾随斜杠（与现有网站模式保持一致）

输出

结构化的程序化 SEO 评估，包含：

程序化 SEO 评分：XX/100

类别	状态	评分
数据质量	评分	/100
模板独特性	评分	/100
URL 结构	评分	/100
内部链接	评分	/100
薄内容风险	评分	/100
索引管理	评分	/100

• 关键问题（立即修复）
• 高优先级（1 周内修复）
• 中优先级（1 个月内修复）
• 建议：改进数据源、修改模板、调整 URL 模式、采取符合质量门槛的措施
• 包含批次规模和监测检查点的逐步上线计划

使用的 Agent

• seo-specialist — 程序化页面分析、质量门槛执行、URL 策略、模板评估
• content-creator — 模板内容设计、独特性优化

使用的脚本

• tech-seo-auditor.py — 检查程序化页面样本中的技术 SEO 问题
• content-scorer.py — 按模板评估内容质量和独特性
• competitor-scraper.py — 分析竞争对手的程序化页面模式