seo-programmatic

程序化 SEO 分析与规划

基于结构化数据源，批量生成并审核 SEO 页面。 设置质量门槛，避免因内容单薄而受到处罚，并防止索引膨胀。

数据源评估

评估为程序化页面提供支持的数据：

• CSV/JSON 文件：行数、列唯一性、缺失值
• API 端点：响应结构、数据时效性、速率限制
• 数据库查询：记录数、字段完整性、更新频率
• 数据质量检查：
  • 每条记录都必须包含足够的独特属性，以生成有差异的内容
  • 标记重复或近似重复的记录（字段重叠度 >80%）
  • 验证数据时效性；过时的数据会生成过时的页面

模板引擎规划

设计能够生成独特、有价值页面的模板：

• 变量注入点：标题、H1、正文部分、元描述、架构标记
• 内容块：静态（多个页面共享）与动态（每个页面独有）
• 条件逻辑：根据数据是否可用来显示或隐藏部分内容
• 补充内容：相关条目、上下文提示、用户生成内容
• 模板审核清单：
  • 每个页面都必须能作为独立且有价值的资源来阅读
  • 不得使用“填空式”模式（只是在相同文本中替换城市或产品名称）
  • 动态部分必须提供真实信息，而不只是替换关键词

URL 模式策略

常见模式

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

URL 规则

• 使用小写字母，以连字符分隔，并根据数据生成 slug
• 采用反映网站架构的逻辑层级
• 不得有重复 slug；生成时强制确保唯一性
• URL 长度不得超过 100 个字符
• 主要内容 URL 不得包含查询参数
• 统一使用或不使用尾部斜杠（与现有网站模式一致）

内部链接自动化

• 中心/辐射模型：由类别中心页链接到各个程序化页面
• 相关条目：根据数据属性自动链接到 3-5 个相关页面
• 面包屑：根据 URL 层级生成 BreadcrumbList 架构标记
• 交叉链接：在共享属性（相同类别、相同城市、相同功能）的程序化页面之间建立链接
• 锚文本：使用具有描述性且多样化的锚文本。避免重复使用完全匹配的关键词
• 链接密度：每 1000 个词添加 3-5 个内部链接（与 seo-content 指南保持一致）

内容单薄防护措施

质量门槛

指标	阈值	操作
未经内容审核的页面	100+	⚠️ 警告：发布前必须进行内容审核
缺少合理依据的页面	500+	🛑 强制停止：必须获得用户明确批准并进行内容单薄审核
每页独特内容占比	<40%	❌ 标记为内容单薄（可能有处罚风险）
每页字数	<300	⚠️ 标记以供审核（可能缺乏足够价值）

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

Google 的规模化内容滥用政策（于 2024 年 3 月推出）在 2025 年显著加强了执法：

• **2025 年 6 月：**第三方报告称，针对大规模发布 AI 生成内容的网站出现了一波人工处置（Google 未发布公告）
• **2025 年 8 月：**第三方和 SEO 社区的报告称，SpamBrain 对 AI 生成的链接方案和内容农场加强了检测
• **结果：**Google 报告称，自 2024 年 3 月加强执法后，搜索结果中的低质量、非原创内容减少了 45%

针对程序化页面的增强质量门槛：

• **内容差异化：**任意两个程序化页面之间，至少有 30-40% 的内容必须真正独特（不能只替换城市名或关键词）
• **人工审核：**发布前至少抽样审核 5-10% 的生成页面
• **逐步推出：**分批发布，每批 50-100 个页面。监测 2-4 周的收录和排名情况，再扩大规模。未经明确的质量审核，切勿同时发布 500 个以上的程序化页面。
• **独立价值测试：**每个页面都应通过以下测试：“即使不存在其他类似页面，这个页面是否仍值得发布？”
• **网站声誉滥用：**Google 于 2024-11-19 澄清了网站声誉滥用相关表述；应将第三方/托管的程序化内容视为政策风险。自 2026-08-30 起（于 2026-08-28 宣布），执法方式取决于搜索者：欧洲经济区（EEA）以外适用人工处置，而对 EEA 用户，第三方内容板块可能会与主域名分开归类。应向两类受众都报告这一风险。

建议：<40% unique content 时触发 WARNING 门槛仍然合适。可考虑在 <30% unique content 时触发 HARD STOP，以防范规模化内容滥用风险。

安全的程序化页面（可大规模发布）

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

惩罚风险（避免大规模发布）

❌ 仅在完全相同的文本中替换城市名的地点页面 ❌ 没有行业专属价值的“适用于[行业]的最佳[工具]” ❌ 没有真实对比数据的“[竞争对手]替代方案” ❌ 未经人工审核且没有独特附加价值的 AI 生成页面 ❌ 超过 60% 内容为共用模板套话的页面

独特性计算

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

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

**元数据单独评分。**此计算仅涵盖正文，因此，即使一组页面通过了此项检查，也仍可能在每个 URL 上使用同一种生成式标题/描述结构。对整个页面集合运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run metadata_template.py --pairs-file <file> --json（启发式、确定性的字符串比较），并将 site_risk 为 high 视为门槛检查失败，无论正文独特性如何。

规范网址策略

• 每个程序化页面都必须包含指向自身的 canonical 标签
• 对重复或价值较低的参数变体（排序、筛选），将 canonical 指向基础 URL
• 分页系列：内容不同的分页页面使用指向自身的 canonical；保留可抓取的链接
• 如果程序化页面与人工编写的页面重叠，则以人工编写的页面为 canonical
• 除非有意设置跨域方案，否则不要将 canonical 指向其他域名

站点地图集成

• 为所有程序化生成的页面自动生成站点地图条目
• 每个站点地图文件达到 50,000 个 URL 或未压缩大小达到 50 MB 时拆分，以先达到者为准（协议限制）
• 需要多个站点地图文件时，使用站点地图索引
• <lastmod> 反映实际数据更新时间戳（而非生成时间）
• 将设置了 noindex 的程序化页面排除在站点地图之外
• 在 robots.txt 中登记站点地图
• 随着数据源添加新记录，动态更新站点地图

防止索引膨胀

• 对低价值页面设置 noindex：未达到质量门槛的页面
• 分页：仅对真正的重复内容或低价值筛选视图使用 noindex/规范网址整合
• 分面导航：仅对真正的重复内容或低价值筛选视图使用 noindex/指向基础类别的规范网址
• 抓取预算：对于拥有 10k+ 程序化页面的网站，在 Search Console 中监控抓取统计信息
• 整合内容单薄的页面：将数据不足的记录合并到聚合页面中
• 定期审查：每月检查已编入索引的页面数量与预期数量是否一致

输出

程序化 SEO 评分：XX/100

评估摘要

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

严重问题（立即修复）

高优先级（1 周内修复）

中优先级（1 个月内修复）

低优先级（列入待办）

建议

• 改进数据源
• 修改模板
• 调整 URL 模式
• 采取措施确保符合质量门槛

错误处理

情况	操作
URL 无法访问	报告连接错误及状态码。建议确认 URL 可访问，并检查是否需要身份验证。
未检测到程序化页面	告知用户未发现由模板生成或由数据驱动的页面模式。建议检查页面是否使用客户端渲染，或 URL 是否指向正确的版块。
超出内容单薄阈值	触发质量门槛警告。报告独特内容占比，并标记独特性低于 40% 的页面。继续前要求用户确认。
违反质量门槛	在 HARD STOP 阈值处停止分析（500+ 个页面且无正当理由，或独特内容低于 30%）。呈现调查结果，并要求用户明确批准后再继续。