gtlisted
Install: claude install-skill yan-labs/yan-skills
# gt — Google Trends 查询 + 关键词难度估算 + SEO 选词工作流
三层能力:**基础查询**(五个子命令)、**工作流**(把查询串成决策)、**KD 难度估算**(竞争侧收口)。
## 安装与更新
来源:[Skills.sh](https://skills.sh/yan-labs/yan-skills)
```bash
# 首次全局安装,或更新失败时重新安装
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`。
两层能力:**基础查询**(四个子命令)和**工作流**(把查询串成决策)。用户问单点问题走基础查询;用户给的是模糊方向、要选词选市场时,走工作流。
## 核心概念
选词的完整公式是 **潜在价值 = 需求 × (1 - 竞争)**:
- **需求侧**(Google Trends):谁在搜、搜多少、趋势涨跌、哪些国家热 → `compare` / `region` / `related` / `hot`
- **竞争侧**(KD 难度估算):排上去有多难、前十是谁、要多少外链 → `kd`
两侧都查完才能下"值不值得做"的结论。
## 基础查询
| 用户想要 | 子命令 | 数据源 |
|---|---|---|
| 热度对比 / 趋势曲线 / "XX 和 YY 哪个火" | `compare` | pytrends |
| 地区分布 / "哪个国家搜得多" | `region` | pytrends |
| 相关词 / 飙升查询 / "大家搜 XX 时还搜什么" | `related` | pytrends |
| 今日热搜 / "美国现在在搜什么" | `hot` | opencli |
| 关键词难度 / SERP 盘面 / "这个词能排上去吗" | `kd` | Web.Cafe KD API |
### Trends 查询(compare / region / related / hot)
脚本位于本 skill 目录下的 `scripts/gt.py`(以下示例用 `$GT` 代指,实际执行时替换为 skill 的 base directory + `/scripts/gt.py`):
```bash
python3 $GT <子命令> [关键词...] [选项]
# 热度对比(默认全球、近 12 个月,>30 行自动按月聚合)
python3 $GT compare ChatGPT Claude Gemini
python3 $GT compare "wireless charger" --geo US --time 5y
python3 $GT compare sunscreen --time 2024-01-01:2025-12-31 --geo AU
# 地区分布(不带 --geo 按国家列,带 --geo 按州/省列)
python3 $GT region "remove background" --top 15
# 相关查询(单关键词;rising=飙升词,top=高频词)
python3 $GT related Claude --geo US
# 每日热搜榜(走 open