Google Trends Skill

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.

Prerequisites

Node.js 18+ and PNPM required.

Check Node

node --version

Install dependencies (first-time only)

cd .agent/skills/google-trends/scripts pnpm install

Quick Start

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

node .agent/skills/google-trends/scripts/search.js -k "Claude AI"

Search Web instead of YouTube

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

Extended time range (1 month)

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

Output as JSON for piping

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

CLI Reference

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

Property Options

Value What It Searches

youtube

YouTube Search trends

web

Google Web Search trends

images

Google Images trends

news

Google News trends

froogle

Google Shopping trends

Time Options

Value Period

now 7-d

Last 7 days

now 1-m

Last 30 days

today 3-m

Last 90 days

today 12-m

Last 12 months

Category IDs (Common)

ID Category

5 Computers & Electronics (Tech)

13 Arts & Entertainment

174 Sports

3 Business & Industrial

Full list: Google Trends Categories

Example Workflows

YouTube Phase 1 Research

Use this skill during /youtube-phase1-strategy to validate topics:

Check if "Claude Cowork" is rising on YouTube

node .agent/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.

General Topic Validation

Is "RAG" still trending in AI?

node .agent/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.

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%)

JSON

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

Markdown

Claude AI (YouTube, 7 days)

Top Queries

1. claude ai assistant (100) ...

Tips

• BREAKOUT = Gold. A "BREAKOUT" query has grown > 5000% — this is a proven opportunity.

• Cross-validate. Use with YouTube Studio Trends and Competitor VidIQ for 3-source validation.

• Try multiple keywords. "Claude AI" vs "Claude Cowork" vs "Anthropic Claude" may reveal different signals.

• Category matters. Category 5 (Tech) gives tech-focused results; omit -c for broader trends.