SuperAPI AI 工具集

seo-watchlist

营销与增长

查看项目

更新于 10-16 05:45

技能介绍

用途:通过 DataForSEO 的 SERP google/organic/live/advanced 接口,对本地保存的域名与关键词集合进行实时排名检查,并按多次运行记录排名变化。调用成本约每关键词每次 $0.002。

主要能力:维护位于 ~/.claude/skills/seo/output/watchlist.json 的基于文件的观察列表,记录域名、标签、关键词与历史排名。子命令包括:add <domain> <keywords...>(新增或更新域名并立即检查、写入首条历史)、list(表格展示域名、标签、关键词数、上次检查时间、上次平均排名)、check <domain> 或 check all(对已保存关键词重跑排名并追加历史,同时与上次对比显示升降)、remove <domain> 及 remove <domain> <keyword>(移除域名或单个关键词)。输出结尾会给出简短结论:下降 -5 或更严重的关注项、接近前十的机会,以及一条建议动作。

使用方式:运行前必须先执行凭证预检 ~/.claude/skills/seo/scripts/preflight.sh;退出码 0 表示凭证已配置。退出码 2 时会打印 DataForSEO 设置向导,需停下并原样展示给用户,等待其按 login: 与 password: 格式提供凭据,随后写入 ~/.claude/skills/seo/.env(DATAFORSEO_LOGIN、DATAFORSEO_PASSWORD),执行 chmod 600,并运行 ~/.claude/skills/seo/scripts/keyword_research.py volume "test" 验证。若状态为 40104,提示用户在 https://app.dataforseo.com/ 验证账户后回复 continue;其他鉴权错误则提示核对 API 密码(来自 https://app.dataforseo.com/api-access 的长字母数字串,而非账户登录密码)。排名检查调用 ~/.claude/skills/seo/scripts/serp_check.py rank --domain <domain> --keywords <kw...>。

限制:不得回显凭据、不得将其放入工具输出或提交;需要 DataForSEO 账户与 API 凭据;每次检查按关键词计费。未提供的细节暂未说明。