用途:挖掘内容缺口(content gap),即竞争对手进入前 100 名而你没有排名的关键词,用于规划内容选题。数据来源为 DataForSEO API 的 Labs domain_intersection 端点(target1=竞争对手,target2=你,intersections=false),成本约每个对比竞品 $0.02。
主要能力:支持传入 1–5 个竞品;脚本按竞品分别返回其排名而你未覆盖的关键词;按优先级 = 搜索量 ×(101 − 竞品排名)排序,数值越高代表越值得优先跟进;输出每个竞品的缺口关键词数与 Top 10 机会(含关键词、竞品排名、搜索量、KD、CPC、竞品排名页面类型与 URL);在所有竞品处理完后统计多个竞品共同排名而你缺失的关键词,作为共识缺口;最后给出含目标关键词、工作标题、优先级分数和学习对象(竞品文章)的 5 篇文章内容路线图。
使用方式:首次运行前必须先执行凭据预检脚本 ~/.claude/skills/seo/scripts/preflight.sh。退出码为 0 表示凭据已配置,可静默继续;退出码为 2 时脚本会输出 DataForSEO 配置向导,需停止并向用户原样展示,等待其按“login: 邮箱 / password: API 密码”格式提供凭据,随后写入 ~/.claude/skills/seo/.env(DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD),执行 chmod 600 ~/.claude/skills/seo/.env,并通过 ~/.claude/skills/seo/scripts/keyword_research.py volume "test" 验证。验证成功提示“✅ Credentials verified. Running your command now...”后继续;状态 40104 提示去 https://app.dataforseo.com/ 验证账户后回复 continue 重试;其他鉴权错误提示核对 https://app.dataforseo.com/api-access 上的 API 密码(非账户登录密码)。主命令为 ~/.claude/skills/seo/scripts/domain_overview.py content_gap --you <you> --competitors <c1> <c2> <c3>。
限制:凭据不得回显、写入工具输出或提交到仓库;竞品数量限 1–5 个;使用需有效的 DataForSEO 账户且产生 API 费用;其他平台支持、配额等细节暂未提供。