用途:通过 DataForSEO SERP API(google/organic/live/advanced)对指定域名和一组关键词查询实时 Google 自然排名,并结合 Keywords Data google_ads/search_volume 获取搜索量,帮助判断哪些排名值得投入。成本约每关键词 0.002 美元。
主要能力:给定域名与关键词列表,输出每个关键词的位置、搜索量、对应 URL 和行动建议。结果按档位分组:1–3 名(Winning,建议每周监控守护);4–10 名(Page 1,通过内链与页面优化冲前 3);11–30 名(Close,杠杆最大,重优化并建外链);31–100 名(Long-haul,考虑转向或重投);未排名(需决定跟进还是放弃)。最后给出跨关键词的最高杠杆行动。
使用方式:先执行凭据预检脚本 ~/.claude/skills/seo/scripts/preflight.sh,退出码 0 则直接继续;退出码 2 时需按向导将 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD 写入 ~/.claude/skills/seo/.env 并 chmod 600,再用 ~/.claude/skills/seo/scripts/keyword_research.py volume "test" 验证;40104 需先在 app.dataforseo.com 验证账户,其他鉴权错误需核对 API 密码。随后运行 ~/.claude/skills/seo/scripts/serp_check.py rank --domain <domain> --keywords kw1 kw2 kw3 ...,可选参数 --location、--language、--device、--depth。搜索量可用 ~/.claude/skills/seo/scripts/keyword_research.py volume kw1 kw2 ... 单独拉取。
限制:依赖 DataForSEO 账户与有效 API 凭据,需自行承担按关键词计费;资料未提供支持的关键词数量上限、地区覆盖范围、返回时效及其他平台排名的支持情况。