google-trends

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Trends Skill

Google Trends 技能工具

Automate Google Trends research without a browser. Query related topics, rising queries, and interest over time for any keyword across YouTube, Web, Images, or News.
无需浏览器即可自动化完成Google Trends调研。可针对任意关键词,在YouTube、网页、图片或新闻平台查询相关主题、上升查询词及随时间变化的关注度。

Prerequisites

前置要求

Node.js 18+ and PNPM required.
powershell
undefined
需安装Node.js 18+和PNPM。
powershell
undefined

Check Node

检查Node版本

node --version
node --version

Install dependencies (first-time only)

安装依赖(仅首次运行时需执行)

cd ~/.gemini/antigravity/skills/google-trends/scripts pnpm install

---
cd ~/.gemini/antigravity/skills/google-trends/scripts pnpm install

---

Quick Start

快速开始

powershell
undefined
powershell
undefined

Basic search (YouTube, Last 7 Days, Tech category)

基础搜索(YouTube平台,最近7天,科技分类)

node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "Claude AI"
node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "Claude AI"

Search Web instead of YouTube

切换至网页平台搜索

node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "AI agents" -p web
node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "AI agents" -p web

Extended time range (1 month)

扩展时间范围(1个月)

node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "VibeCoding" -t "now 1-m"
node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "VibeCoding" -t "now 1-m"

Output as JSON for piping

以JSON格式输出以便管道传输

node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "Cursor IDE" -o json

---
node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "Cursor IDE" -o json

---

CLI Reference

CLI 参考文档

Usage: search.js [options]

Options:
  -k, --keyword <string>    Topic to search (required)
  -p, --property <string>   youtube | web | images | news | froogle (default: youtube)
  -t, --time <string>       now 7-d | now 1-m | today 3-m | today 12-m (default: now 7-d)
  -c, --category <number>   Google Trends category ID (default: 5 = Tech)
  -o, --output <string>     table | json | markdown (default: table)
  -f, --file <path>         Save output to file (optional)
  --interest                Include interest-over-time data (default: false)
  -h, --help                Show help
Usage: search.js [options]

Options:
  -k, --keyword <string>    要搜索的主题(必填)
  -p, --property <string>   youtube | web | images | news | froogle(默认值:youtube)
  -t, --time <string>       now 7-d | now 1-m | today 3-m | today 12-m(默认值:now 7-d)
  -c, --category <number>   Google Trends分类ID(默认值:5 = 科技)
  -o, --output <string>     table | json | markdown(默认值:table)
  -f, --file <path>         将输出保存至文件(可选)
  --interest                包含随时间变化的关注度数据(默认值:false)
  -h, --help                显示帮助信息

Property Options

平台选项

ValueWhat It Searches
youtube
YouTube Search trends
web
Google Web Search trends
images
Google Images trends
news
Google News trends
froogle
Google Shopping trends
取值搜索范围
youtube
YouTube搜索趋势
web
Google网页搜索趋势
images
Google图片搜索趋势
news
Google新闻搜索趋势
froogle
Google购物搜索趋势

Time Options

时间范围选项

ValuePeriod
now 7-d
Last 7 days
now 1-m
Last 30 days
today 3-m
Last 90 days
today 12-m
Last 12 months
取值时间周期
now 7-d
最近7天
now 1-m
最近30天
today 3-m
最近90天
today 12-m
最近12个月

Category IDs (Common)

常用分类ID

IDCategory
5Computers & Electronics (Tech)
13Arts & Entertainment
174Sports
3Business & Industrial

ID分类名称
5计算机与电子(科技)
13艺术与娱乐
174体育
3商业与工业
完整分类列表:Google Trends Categories

Example Workflows

示例工作流

YouTube Phase 1 Research

YouTube 第一阶段调研

Use this skill during
/youtube-phase1-strategy
to validate topics:
powershell
undefined
/youtube-phase1-strategy
流程中使用此工具验证主题:
powershell
undefined

Check if "Claude Cowork" is rising on YouTube

查看“Claude Cowork”是否在YouTube上呈上升趋势

node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "Claude Cowork" -p youtube -t "now 7-d"

**Signal:** Look for `BREAKOUT` or values > 100 in related queries.
node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "Claude Cowork" -p youtube -t "now 7-d"

**信号提示:** 关注相关查询词中的`BREAKOUT`标识或数值>100的条目。

General Topic Validation

通用主题验证

powershell
undefined
powershell
undefined

Is "RAG" still trending in AI?

“RAG”在AI领域是否仍具热度?

node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "RAG AI" -p web -t "today 3-m" --interest

**Signal:** Check if interest-over-time is increasing or peaked.

---
node ~/.gemini/antigravity/skills/google-trends/scripts/search.js -k "RAG AI" -p web -t "today 3-m" --interest

**信号提示:** 查看随时间变化的关注度是呈上升趋势还是已达峰值。

---

Output Formats

输出格式

Table (Default)

表格(默认)

[TrendProbe] Searching: "Claude AI" on YouTube (Last 7 days)

--- Related Queries (Top) ---
1. claude ai assistant (100)
2. anthropic claude (81)
3. claude vs chatgpt (45)

--- Related Queries (Rising) ---
1. anthropic (BREAKOUT)
2. claude code (450%)
[TrendProbe] Searching: "Claude AI" on YouTube (Last 7 days)

--- Related Queries (Top) ---
1. claude ai assistant (100)
2. anthropic claude (81)
3. claude vs chatgpt (45)

--- Related Queries (Rising) ---
1. anthropic (BREAKOUT)
2. claude code (450%)

JSON

JSON

json
{
  "keyword": "Claude AI",
  "property": "youtube",
  "time": "now 7-d",
  "top": [...],
  "rising": [...]
}
json
{
  "keyword": "Claude AI",
  "property": "youtube",
  "time": "now 7-d",
  "top": [...],
  "rising": [...]
}

Markdown

Markdown

markdown
undefined
markdown
undefined

Claude AI (YouTube, 7 days)

Claude AI (YouTube, 7 days)

Top Queries

Top Queries

  1. claude ai assistant (100) ...

---
  1. claude ai assistant (100) ...

---

Tips

小贴士

  1. BREAKOUT = Gold. A "BREAKOUT" query has grown > 5000% — this is a proven opportunity.
  2. Cross-validate. Use with YouTube Studio Trends and Competitor VidIQ for 3-source validation.
  3. Try multiple keywords. "Claude AI" vs "Claude Cowork" vs "Anthropic Claude" may reveal different signals.
  4. Category matters. Category 5 (Tech) gives tech-focused results; omit
    -c
    for broader trends.
  1. BREAKOUT = 黄金机会。 带有“BREAKOUT”标识的查询词增长率超过5000%,这是经过验证的优质机会。
  2. 交叉验证。 结合YouTube Studio趋势和竞争对手的VidIQ工具,实现三方数据源验证。
  3. 尝试多个关键词。 “Claude AI”、“Claude Cowork”和“Anthropic Claude”可能会呈现不同的信号。
  4. 分类很重要。 分类5(科技)会返回聚焦科技领域的结果;若省略
    -c
    参数则会返回更广泛的趋势数据。