Google Trends Skill for Claude Code

Fetch real-time trending searches from Google Trends directly inside Claude Code — for any country and category.

Install

npx skills add ezcat207/google-trends-skill@google-trends

Usage

Just ask Claude naturally:

"What's trending in Brazil?"
"Popular games in Indonesia right now"
"Top technology searches in Japan past 7 days"
"Trending sports in India"

Or use explicit parameters:

/google-trends --geo BR --category games
/google-trends --geo ID --category technology --hours 168
/google-trends --geo US --top 30

How It Works

Two fetch methods are used automatically:

Method	When	Speed
RSS	No category filter (--category all)	~1s — simple HTTP request
CSV	Category specified (games, tech, sports…)	~5s — headless Chrome via Selenium

The skill auto-selects the fastest method for your query.

Supported Options

Countries (125+): US, BR, ID, GB, JP, IN, DE, FR, AU, MX, CA, KR, AR, NG, PH, TH …

Categories: all, games, technology, sports, entertainment, business, health, science, food, travel, beauty, politics, shopping

Time periods: 4 (4h), 24 (24h, default), 48 (48h), 168 (7 days)

# List all supported country codes
python scripts/run.py --list-countries

# List all categories
python scripts/run.py --list-categories

Requirements

• Python 3.8+
• Google Chrome (for category-filtered CSV queries)
• Dependencies installed automatically on first run: trendspyg, selenium

Powered by trendspyg

This skill is built on trendspyg — a free, open-source Python library for real-time Google Trends data.

License

MIT