博客关键词冲突检测器
发现争夺同一搜索意图的博客页面，并给出合并或区分建议。
技能明确区分本地模式与DataForSEO API模式，说明凭据环境变量、API成本和外部数据流；但未要求调用API前确认费用，未说明凭据最小权限、响应隔离、失败后的回滚或数据保留策略，且建议涉及合并、301、canonical和noindex等外部发布变更，因此扣分。
工作流、输入模式和异常情况有较完整文字说明，并规定了缺少文件、缺少凭据、429和单文件目录的处理；但关键实现未随技能提供，语义聚类依赖未定义的Claude判断，URL收集和API调用复现细节不足。按静态校准限制在10分以内。
触发词、目录参数、默认本地模式和--api边界较清楚，且无需API即可运行本地分析；但没有中文语言支持说明，API固定language_code为en、location_code为2840，可能不适合中文用户和中国搜索环境，非适用范围也未充分声明。
Frontmatter包含名称、描述、可调用标记、参数提示和MIT许可证；文档采用分模式、步骤、输出、建议和错误处理分层，并提供示例。缺少该技能自身的版本、变更记录、维护责任和更新路径，主要治理信息只能由仓库上下文间接支持，因此扣分。
目标、严重性等级、公式、报告字段和MERGE/DIFFERENTIATE/CANONICAL/NO ACTION建议均明确，核心任务在本地模式下看似可完成；但关键词提取和语义判断较粗糙，API结果与报告生成未被该文件中的可执行证据验证，建议仍需人工复核。按静态校准限制在7分以内。
技能提供了可审计的规则、端点、请求示例和错误条件，但没有针对该技能的测试、固定样例输出或第三方执行证据；仓库测试材料主要覆盖通用分析器和交付契约，不能独立证明本技能关键路径。按静态校准限制在5分以内。
- 运行--api前应明确征得用户同意并确认DataForSEO费用、凭据范围及发送的URL；当前文件未定义这些控制。
- 不要将MERGE、301、canonical或noindex建议视为自动执行指令，应由用户或SEO负责人复核并准备可逆发布方案。
- 中文内容和中国搜索场景的适配性未得到证明；固定英文语言和美国位置参数可能导致结果失真。
- 语义相似度、主关键词提取和严重性判断缺少可复现测试，报告应标注不确定性并人工抽查。
这个 Skill 能做什么，适合哪些场景？
这是 claude-blog 中用于检测博客关键词蚕食的独立技能。它读取指定目录中的 Markdown、MDX 和 HTML 文件，从标题、H1、H2、首段及元描述中提取关键词，并按匹配程度聚类竞争页面。默认本地模式免费且无需 API 密钥；可选的 DataForSEO 模式提供搜索结果层面的重叠关键词、排名和搜索量数据。技能会输出严重程度和 MERGE、DIFFERENTIATE、CANONICAL 或 NO ACTION 建议。
扫描目标目录中的 .md、.mdx 和 .html 文件，跳过 node_modules、.git 和 drafts；从标题或 H1、H2、首段及 frontmatter 元描述提取主要和次要关键词；按精确匹配、词干匹配、语义重叠和子集匹配聚类；在本地模式下依据内容信号分级，在 API 模式下调用 DataForSEO 的 Page Intersection 和 Ranked Keywords 接口；生成汇总表、每个聚类的重叠关键词、较强页面判断及合并、区分、规范化或不处理建议。
- 内容团队准备合并相似文章，需要确认哪些页面争夺同一关键词。
- SEO 负责人发现多个页面排名重叠，想获得基于搜索意图的优先级和处理建议。
- 个人博客在发布新文章前，希望用免费本地扫描检查已有内容的关键词冲突。
- 营销机构需要 SERP 层面的共享关键词、搜索量和排名位置数据来审计客户博客。
这个 Skill 有哪些优点和局限？
- 本地模式免费且无需 API 密钥。
- 同时支持 Markdown、MDX 和 HTML 内容。
- 从多个内容信号识别关键词重叠，并提供可执行的处理建议。
- API 模式可补充共享关键词、搜索量和排名位置数据。
- 包含严重程度分级和四类处理动作，便于安排修复优先级。
- SERP 级分析依赖 DataForSEO 账号和凭据，并按调用收费，约为每次 0.01 美元。
- 本地模式没有真实排名、搜索量或 SERP 数据，判断主要基于文件内容。
- 目录至少需要两篇博客文章才能进行蚕食分析。
- 源材料未提供该子技能独立的测试覆盖或准确率数据。
如何安装这个 Skill？
该技能随 AgriciDaniel/claude-blog 公共插件集合安装。Claude Code 1.0.33+ 中执行：
/plugin marketplace add AgriciDaniel/claude-blog
/plugin install claude-blog@agricidaniel-claude-blog
然后重启 Claude Code。源材料未提供仅安装此单个子技能的独立命令。
如何使用这个 Skill？
在包含至少两篇博客文章的项目中运行：
/blog cannibalization [directory]
默认执行本地分析；需要 DataForSEO SERP 数据时使用 --api。API 模式要求设置 DATAFORSEO_LOGIN 和 DATAFORSEO_PASSWORD。未找到博客文件、目录只有一篇文章或 API 凭据缺失时，技能会报告相应问题；凭据缺失会自动回退到本地模式。