Google Trends Skill
Fetch real-time trending searches from Google Trends for any country and category.
When to Use This Skill
Trigger when the user:
- Asks "what's trending in [country]?"
- Asks "popular [games/AI/tech/sports/etc.] in [country]"
- Says "Google Trends for [country]"
- Wants to compare trends between countries
- Invokes
/google-trends
Parameters
| Flag | Default | Options |
|---|---|---|
--geo | US | Any 2-letter country code: US, BR, ID, GB, JP, IN, DE, FR, AU, MX,... |
--category | all | all, games, technology, sports, entertainment, business, health, science, food, travel, beauty, politics, shopping |
--hours | 24 | 4, 24, 48, 168 (7 days) |
--top | 20 | Any integer |
--method | auto | rss (fast, no category filter), csv (Selenium, supports categories) |
Auto method logic: Uses rss when --category all, uses csv when a specific category is given.
Country Code Reference
| Country | Code | Country | Code |
|---|---|---|---|
| Brazil | BR | Indonesia | ID |
| USA | US | India | IN |
| UK | GB | Japan | JP |
| Germany | DE | France | FR |
| Australia | AU | Mexico | MX |
| Canada | CA | South Korea | KR |
| Argentina | AR | Nigeria | NG |
| Philippines | PH | Thailand | TH |
Script Execution
CRITICAL: Always use the run.py wrapper. It handles venv setup automatically.
Basic Usage (general trends, fast)
python scripts/run.py --geo BRCategory-specific trends (uses Selenium)
python scripts/run.py --geo BR --category games
python scripts/run.py --geo ID --category technology
python scripts/run.py --geo US --category sports --hours 48Multiple countries (run in parallel)
python scripts/run.py --geo BR --category games &
python scripts/run.py --geo ID --category games &
waitTop N results with longer period
python scripts/run.py --geo JP --category entertainment --hours 168 --top 30Workflow
- Parse user intent → extract country, category, time period
- Map to parameters:
- "Brazil" → --geo BR - "Indonesia" → --geo ID - "games" → --category games - "AI/tech/technology" → --category technology - "past week" / "7 days" → --hours 168
- Inform user: "Fetching [category] trends for [country] (past [N] hours)..."
- Run script and parse JSON output
- Present results as a formatted table with rank, trend name, and search volume
Output Format
Script outputs JSON:
{
"geo": "BR",
"category": "games",
"hours": 24,
"method": "csv",
"count": 20,
"trends": [
{"rank": 1, "trend": "grêmio x internacional", "volume": "500K+", "started": "..."},
{"rank": 2, "trend": "arsenal x chelsea", "volume": "500K+", "started": "..."}
]
}Presenting Results
Format output as a clean markdown table:
## 🔥 Trending in Brazil — Games (past 24h)
| # | Trend | Volume |
|---|-------|--------|
| 1 | grêmio x internacional | 500K+ |
| 2 | arsenal x chelsea | 500K+ |
...Add brief context/insights after the table when relevant (e.g., "Football dominates Brazil's trending games — the Grenal derby between Grêmio and Internacional was the biggest search spike.").
Error Handling
| Error | Action |
|---|---|
BrowserError / timeout | Retry with --method rss (drops category filter) |
InvalidParameterError | Check geo code or category name |
| venv setup failure | Check Python 3.8+ is available |
| No trends returned | Try broader category or different time window |
Troubleshooting
- CSS method slow: normal — Selenium launches Chrome headlessly
- Category filter not working with RSS: RSS doesn't support categories, use
--method csv - Empty results: try
--hours 168for a wider time window - Country not found: run
python scripts/run.py --list-countriesto see all supported codes