用途：把主题、域名、竞品或关键词列表转化为结构化、按优先级排序的关键词地图，供 seo-team-the-writer、seo-team-the-doctor、seo-team-the-general 等下游技能使用。
前置条件：需要 DataForSEO 账号与 API key，所有数据来自 DataForSEO API，通过 seocli 调用。
流程：CHECK STATE → SEED → EXPAND → ENRICH → CLUSTER → PRIORITIZE → MAP。先检查 workspace/seo/ 下已有数据，避免重复研究；再按输入类型选择种子路径：主题走 LLM 头脑风暴，域名走 Domain API，竞品走竞品排名关键词，用户已给关键词则跳过种子直接扩展或丰富。
主要能力：生成 30–100 个种子词并扩展至 200–1,000 个候选；补充搜索量、CPC、关键词难度、意图、漏斗阶段、趋势与零点击风险；按 SERP 相似度聚类，输出支柱词、支持词、内容格式与完整度评分；用机会分公式与分层（Quick Wins、Growth、Long-term Bets、Low Priority）排序；标记 AI Overview、视频、精选摘要、PAA、购物、季节性、上升、缺口等标志；输出关键词地图、关键词全集、聚类架构、机会简报、竞品缺口报告与内容日历建议。
使用方式：所有 seocli 命令需带 --location-code 与 --language-code，dataforseo-labs 命令还需 --location-name 与 --language-name。示例：seocli keywords-data google-ads keywords-for-site live --target example.com --sort-by search_volume --limit 200；seocli dataforseo-labs google bulk-keyword-difficulty --keywords "kw1" --keywords "kw2"。结果持久化到 workspace/seo/ 下的 config.yaml、keyword-map.json、keyword-universe.json、clusters.json、research-runs/ 与 competitor-gaps/。
适用场景：需要系统化关键词调研、竞品缺口分析、内容集群规划与优先级排序的 SEO 工作流。
限制：依赖 DataForSEO API 与 seocli，需自行配置账号与密钥；典型运行约 50–100 次 API 调用，成本随规模上升；DataForSEO 的 KD 数值高于 Ahrefs/Semrush；位置与语言需受支持；关键词超过 2,000 条会提示成本并建议先筛选；SERP 为空时回退到文本相似度聚类。具体价格与配额暂未提供。