About google-trends
google-trends is a skill that retrieves Google Trends data with a bundled script for tasks involving search trends. Its commands cover trending topics, keyword exploration, regional interest, and related queries, with results returned as JSON.
Key features
- 01Retrieve daily trending topics
- 02Query real-time trends
- 03Get keyword autocomplete suggestions
- 04Explore keyword trend data
- 05View search interest by region
- 06Find related topics and queries
Use cases
- 01Review daily trending topics for a region
- 02Track recent trends for a keyword
- 03Compare regional search interest
- 04Find related topics and search queries
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/google-trendsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
reference.mdREADME.mdscripts/trends.mjsDetails
From the project READMEGoogle Trends
Fetch Google Trends data using the bundled script. No API key required.
Quick start
Run the script from the skill directory:
node scripts/trends.mjs <command> [options]
Available commands
| Command | Description |
|---|---|
daily-trends | Get daily trending search topics |
realtime-trends | Get real-time trending topics |
autocomplete | Get autocomplete suggestions for a keyword |
explore | Explore trend data for a keyword |
interest-by-region | Get search interest breakdown by region |
related-topics | Get topics related to a keyword |
related-queries | Get queries related to a keyword |
Usage examples
Daily trending topics in the US:
node scripts/trends.mjs daily-trends --geo US
Real-time trends (last 4 hours):
node scripts/trends.mjs realtime-trends --geo US --hours 4
Autocomplete suggestions:
node scripts/trends.mjs autocomplete "artificial intelligence"
Explore a keyword:
node scripts/trends.mjs explore "machine learning" --geo US --time "now 7-d"
Interest by region:
node scripts/trends.mjs interest-by-region "bitcoin" --geo US --resolution REGION
Related topics:
node scripts/trends.mjs related-topics "python programming" --geo US
Related queries:
node scripts/trends.mjs related-queries "python programming" --geo US
Options reference
For full option details per command, see reference.md.
Output
All commands output JSON to stdout. Parse the output to extract relevant data for the user. Present results in a readable format (tables, lists, summaries) based on context.
Error handling
If Google rate-limits the request, the script retries with exponential backoff (up to 3 retries). If it still fails, inform the user and suggest waiting before retrying.