keyword-clustering

OpenSEO 关键词聚类

目标

将关键词归入页面级聚类，并确定每个聚类应由哪个现有页面或新页面来覆盖。这是一项关键词映射工作流，而不只是语义分组练习。

必需输入

• projectId
• 关键词列表、已保存的关键词标签、种子主题或目标域名
• 可选的现有 URL／页面，用于映射

如果用户未提供关键词，则对于已保存的关键词集，使用 list_saved_keywords；对于种子词发现，使用 research_keywords；如果用户从目标域名开始，则使用 get_ranked_keywords。

项目背景

项目背景工具免费，并与应用和其他 Agent 共享。

1. 首先调用 get_project_context，并以其中的信息为映射提供依据——已保存的关键页面是聚类应映射到的现有页面，而业务和目标决定了哪些聚类值得定位。
2. 此技能需要关键页面。如果尚未保存任何关键页面，请进行最简的即时设置：询问用户哪些页面最重要，或从网站、审计报告或 Search Console 中提出一个候选列表并请用户确认，然后使用 update_project_context（addKeyPages）将其写回，再继续聚类。不要一开始就进行完整访谈；结束时再建议使用 seo-project-setup 完成其余设置。
3. 花费额度前，检查研究日志。如果过去 30 天内已进行相同研究，则复用该结果并说明原因，而不是再次购买。
4. 完成后，使用 update_project_context 写回具有长期价值的信息——新增或更正 addKeyPages 条目，并注明每个页面现在定位的主题；同时追加一条研究日志：{ appendResearchLog: { summary: "Keyword clustering: <keyword set>. Verdict: <conclusion>" } }。

以报告形式交付

通过 seo-report 技能交付，并使用 skill: "keyword-clustering" 保存。如果该技能不可用，请说明这一点，并在编写 HTML 前停止。

OpenSEO MCP 工具

• list_saved_keywords：获取现有关键词集，可按标签筛选。
• research_keywords：当用户从主题开始时，扩展种子词。
• get_ranked_keywords：当用户从域名或页面开始时，获取确切的排名关键词和 URL。
• get_search_console_performance：连接 Search Console 后，使用 dimensions: ["query","page"] 获取真实查询，将词映射到已获得展示的页面，并发现关键词蚕食（一个查询的点击分散到多个 URL）。
• get_serp_results：通过检查 SERP 重合度和意图，验证关键词是否应放在同一页面上。
• get_local_serp_results：当地图／本地搜索结果意图会影响页面映射时，用于本地 SEO 聚类。
• save_keywords：经用户确认后，可选择为最终聚类添加标签。

工作流

1. 收集候选关键词集。
   • 如果已连接 Search Console，则使用 get_search_console_performance（维度 ["query","page"]），从真实查询及其已有排名页面开始。
   • 使用 get_ranked_keywords，按域名或页面进行聚类。
   • 当地理位置、当地结果包或 Google Business 结果会影响关键词是否应归入位置页面时，使用 search_local_businesses 和 get_local_serp_results。
2. 移除重复、无关，以及明显需要不同产品或受众的关键词。
3. 根据意图和页面类型建立关键词簇：
   • SERP 意图相同且排名页面相似的关键词归为一组。
   • 意图、购买阶段或 SERP 格式不同的关键词应拆分。
   • 词语相似并不意味着应该归入同一关键词簇。
4. 对重要的边界关键词，使用小批量 get_serp_results 检查重合度。
5. 为每个关键词簇分配以下归属：
   • 已提供且合适的现有 URL
   • 如果没有合适的现有页面，则推荐新页面
   • 不应定位／稍后处理的类别（如果关键词较弱或偏离策略）
6. 如果多个页面会针对相同意图，指出关键词蚕食风险。如果已连接 Search Console，则使用真实数据通过 get_search_console_performance（dimensions: ["query","page"]）确认——同一查询为多个 URL 带来展示。
7. 应用关键词簇标签前，先征求确认。

输出格式

h1：网站或关键词集。

如果适用报告模板（见 seo-report），则以其章节和语气取代此列表。

章节按以下顺序排列：

1. 关键词地图 — 开头用一两句话说明关键词簇数量、需要创建和更新的页面数量，以及发现的关键词蚕食情况。
2. 关键词簇 — 使用表格列出关键词簇、主要关键词、意图、目标页面和优先级。次要关键词应放在每个关键词簇的说明中，而不是表格里。
3. 页面说明 — 每个关键词簇列出一项发现：页面类型和搜索者的问题，然后列出要创建或更新的页面。在下方列出必需的章节和内部链接。
4. 关键词蚕食 — 仅在有真实证据时，使用表格列出查询、相互竞争的 URL，以及应保留的 URL。
5. 下一步 — 使用有序列表，包括标签建议，以及应用标签前明确征求确认。
6. 本报告的制作方式 — 首先放置来自 seo-report 的技能链接行，指向 https://openseo.so/docs/skills/keyword-clustering（“OpenSEO Keyword Clustering skill”），然后说明关键词来源，并在未提供 URL 数据时注明目标页面为建议页面。

注意事项

• 不要对数量很少的关键词过度聚类。可用关键词少于 10 个时，生成简单的关键词地图。
• 不要只依赖词汇相似度。以 SERP 意图为准。
• 未经明确确认，不要大范围替换标签。
• 如果缺少现有 URL 数据，请将目标页面标注为建议页面。