mcpField
G
google-trends

google-trends

github.com/j-star-films-studiosMarketing & growth26160 installsUpdated 2w ago
Repository

About google-trends

google-trends is a command-line skill for researching Google Trends without a browser. It helps topic researchers inspect related and rising queries and interest over time across several Google properties.

Key features

  1. 01Search YouTube, Web, Images, News, and Shopping trends
  2. 02Choose keywords, time ranges, and categories
  3. 03View top and rising related queries
  4. 04Export results as table, JSON, or Markdown

Use cases

  1. 01Validate a video topic using YouTube search trends
  2. 02Check whether interest in a topic is rising over time
  3. 03Compare trend signals for alternate keywords

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/j-star-films-studios/vibecode-protocol-suite --skill google-trends

After installing, type/google-trendsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

scripts/
package.json
pnpm-lock.yaml
search.js

Details

From the project README

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
ValueWhat It Searches
youtubeYouTube Search trends
webGoogle Web Search trends
imagesGoogle Images trends
newsGoogle News trends
froogleGoogle Shopping trends
Time Options
ValuePeriod
now 7-dLast 7 days
now 1-mLast 30 days
today 3-mLast 90 days
today 12-mLast 12 months
Category IDs (Common)
IDCategory
5Computers & Electronics (Tech)
13Arts & Entertainment
174Sports
3Business & 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

  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.

Comments

Markdown supported