gt 是一款围绕 Google Trends 查询与 SEO 选词的工具，来源为 yan-labs/yan-skills，安装与使用通过 Skills.sh 完成。
一、用途定位
gt 用于回答选词类问题：某个关键词热不热、哪些地区搜得多、相关词有哪些、关键词难度多大、是否值得做站。它把需求侧数据（Google Trends）与竞争侧数据（关键词难度估算）结合，用「潜在价值 = 需求 × (1 - 竞争)」的思路辅助决策：只查需求不查竞争，或只查竞争不查需求，都无法下结论。
二、主要能力
gt 分三层能力：基础查询、工作流、KD 难度估算。
基础查询包含四个子命令（对应 Trends）和一个 KD 子命令：
- compare：热度对比与趋势曲线，查询多个关键词哪个更火。
- region：地区热度分布，查询哪个国家搜得多。
- related：相关词与飙升查询，查询大家搜某词时还搜什么。
- hot：每日热搜榜，查询某地区当前在搜什么。
- kd：关键词难度与 SERP 盘面分析，判断某词能否排上去。
Trends 查询脚本位于 skill 目录下的 scripts/gt.py，基本用法为 python3 $GT <子命令> [关键词...] [选项]。常用选项包括 --geo（国家码，留空为全球）、--time（1m/3m/12m/5y/all 或起止日期）、--raw（compare 不聚合）、--top N，hot 专属选项 --region/--limit。
KD 脚本位于 scripts/kd.py，用法为 python3 $KD <keyword> [--gl US] [--force] [--format markdown|json|raw]。KD 输出包含难度分（0-100）及中文等级、月搜索量、品牌词/通用词识别、中文判断原因、链接预算、前十盘面、新站信号、上升期信号，并自动计算 KDROI 与外链成本阶梯定价。
三、使用方式
首次全局安装或更新失败时重新安装：
npx skills add yan-labs/yan-skills --skill gt -g -y
将已安装的全局 Skill 更新到最新版：
npx skills update gt -g -y
若使用项目级安装，去掉 -g；项目级更新使用 npx skills update gt -p -y。
首次运行 compare/region/related 会自动创建 venv（~/.cache/gt-skill/venv），约需 30 秒。hot 依赖 opencli，未安装则此命令不可用，其余三个不受影响。KD 的令牌存在脚本默认值中，也可通过 --token 或 KD_TOKEN 环境变量覆盖，令牌获取/重置地址为 https://seo.web.cafe/kd。
四、适用场景
gt 提供三套工作流：
W1 小语种/小国市场竞争力探测：输入一个产品关键词，通过全球扫描、趋势健康度、语言决策、挖本地搜法、竞争侧收口等步骤，产出值得做的市场清单、内容语言决策与各市场难度评估。
W2 模糊关键词到可做站的 SEO 词：输入模糊词或产品方向，先多角度扩词（可调用 brainstorming、marketing-psychology、marketing-ideas、ai-seo 等 skill），再用 Trends 验证趋势，用 KD 验证难度，最后交付决策表，包含词簇、代表词、趋势、月搜索量、KD 难度、KDROI、新站信号、链接预算与建议。建议逻辑为 KDROI > 100% 且 KD < 60（或有新站信号）则做；KDROI 正但 KD 偏高则视情况；KDROI < 0 或 KD > 70 无新站信号或月搜索量 < 500 则不做。
W3 新兴趋势捕捉：以 related 的 rising 列表为信号源，用 compare 判断持续性，用 kd 确认时机，hot 仅用于时效性话题而不作为选词依据。
五、限制与注意事项
Trends 侧：数值为 0-100 归一化相对值，100 表示所选范围内峰值，不代表绝对搜索量；关键词语言需匹配地区；compare 一次最多 5 个词；hot 不支持 CN，建议使用 TW/HK；连续查询过快会触发 429 限流，需间隔几秒，被限则等 1-2 分钟；太冷门的词在小国可能返回空数据。
KD 侧：每日额度 100 次（Web.Cafe 登录用户，网页/MCP/API 三端共用），VIP 为 500 次；每分钟 ≤10 次，批量查询间隔 ≥6 秒；有 7 天缓存，重复查询仍计额度，强制重算需 --force；仅支持英文关键词，查非英语市场用 --gl 切换国家但词仍为英文；结果为选词参考，不构成排名保证。
其余未在资料中明确的信息暂未提供。