关键词与扩展问题地图是做什么的？

第1步（共5步）。生成后续所有技能所需的关键词地图，避免重复陈述。

开始之前

必需：DataForSEO连接器。 没有它就无法获取真实搜索量，本技能只能猜测，这种猜测比无用更糟糕，因为猜测看起来像真实数据。

检查是否有DataForSEO工具。如果没有，停止并说：

本技能需要真实搜索数据。请先连接DataForSEO：自定义 → 连接器 → 添加自定义连接器 → https://mcp.dataforseo.com/mcp → 连接 → 批准。大约需要一分钟，然后重新运行。

另外请从项目中读取site-brief.md。从中获取SEARCH_COUNTRY、SEARCH_LANGUAGE、服务区域、服务列表和竞争对手。如果该文件缺失，请说明情况并建议先运行site-brief-builder。可以在没有该文件的情况下继续，但必须明确询问国家和语言，并警告搜索量仅对提供的值有效。

输入

一个种子关键词，或业务类型加位置，或仅一个主题。如果用户没有提供任何内容，请从简介中的服务列表中提出三个种子关键词。

流程

第1步：扩展

使用DataForSEO连接器。你需要的端点，按API路径：

dataforseo_labs/google/keyword_ideas，主要扩展
dataforseo_labs/google/related_keywords，语义邻居
keywords_data/google_ads/search_volume，搜索量、CPC、竞争度
ai_optimization/ai_keyword_data/keyword_data，AI搜索量，即人们将其输入LLM而非搜索框的频率
serp/google/organic，当前排名（可选，但使报告更完善）

连接器中的工具名称映射到这些路径。通过描述选择匹配的工具，而不是假设确切名称。

始终传递简介中的位置和语言。切勿因为方便而默认为美国。

第2步：过滤和聚类

丢弃：搜索量和AI搜索量均为零的关键词、明显拼写错误以及竞争对手的品牌词。

将剩余的关键词分组为话题聚类。为每个关键词标记一个意图：

informational（信息型），想要理解（“什么是”、“如何”）
commercial（商业型），购买前比较（“最佳”、“对比”、“评测”）
transactional（交易型），准备行动（“附近”、“预订”、“购买”、“价格”）
navigational（导航型），寻找特定品牌

然后为每个关键词分配一个角色：

primary（主要），只有一个。H1主题。
secondary（次要），拥有自己的H2。
support（支持），自然地在正文中使用。
skip（跳过），话题正确但意图不符合本页面。保留可见，以便用户看到它被考虑过但被拒绝，而不是被遗漏。

根据意图匹配而非仅搜索量选择主要关键词。 每月2400次搜索量的信息型关键词不适合作为服务页面的主要关键词，选择它是最常见的关键词研究错误。

第3步：扩展问题

获取AI引擎将本话题扩展出的后续查询：

ai_optimization/llm_mentions，获取与该话题相关的扩展问题
来自SERP端点的“其他人还问”板块
dataforseo_labs/google/related_keywords，以问题形式的结果

保留单个页面能够真正回答的问题。每个问题作为一个H2，下面直接附上两句回答的答案。删除属于其他页面的内容并说明原因。

输出

写入两个文件。

01-keyword-map.csv，列顺序严格如下： cluster,keyword,intent,role,search_volume,ai_search_volume,competition,cpc 按角色排序（主要、次要、支持、跳过），然后按搜索量降序。这是seo-content-writer读取的文件，因此列名很重要。

01-keyword-map.html，填充templates/keyword-map.html.template。

构建data.json并渲染：

python3 scripts/render.py templates/keyword-map.html.template data.json 01-keyword-map.html

data.json结构：

{
  "tokens": { "SUBJECT": "...", "KW_TOTAL": 42, "...": "..." },
  "rows": {
    "KEYWORD_ROW": [{ "ROW_CLUSTER": "...", "ROW_KEYWORD": "...", "...": "..." }],
    "FANOUT_ROW": [{ "ROW_QUESTION": "...", "ROW_QUESTION_NOTE": "..." }],
    "SERP_ROW": [{ "ROW_POSITION": 1, "ROW_DOMAIN": "...", "...": "..." }]
  }
}

关于标记的说明：

ROW_INTENT_CLASS 必须为 info、comm、trans、nav 之一。
如果跳过了SERP检查，将 SERP_TABLE_DISPLAY 设为 none，SERP_EMPTY_DISPLAY 设为 block。否则设为 block 和 none。
DATA_WINDOW 是搜索量窗口，通常为“12个月平均值”。
DATA_NOTES 必须说明使用的位置和语言。这是用户发现错误市场运行的方式。

不要重新样式化模板。不要添加字体、颜色或图表。

诚实规则

永远不要写出未从API获取的搜索量。如果某个关键词没有返回搜索量，显示“无数据”，而不是0或估算值。
AI搜索量比Google搜索量更新且数据更少。如果缺失，说明缺失，而不是暗示零需求。
如果因为利基较小导致关键词总数很少，请说明情况。一份简短但诚实的报告胜过一份填充过的报告。

交接

最后告诉用户：

下一步：运行seo-content-writer。它会自动读取01-keyword-map.csv，因此无需重复关键词。它会问你三个问题，其中只有你能回答。

关键词与扩展问题地图