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

Auto method logic: Uses rss when --category all, uses csv when a specific category is given.

Country Code Reference

Script Execution

CRITICAL: Always use the run.py wrapper. It handles venv setup automatically.

Basic Usage (general trends, fast)

python scripts/run.py --geo BR

Category-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 48

Multiple countries (run in parallel)

python scripts/run.py --geo BR --category games &
python scripts/run.py --geo ID --category games &
wait

Top N results with longer period

python scripts/run.py --geo JP --category entertainment --hours 168 --top 30

Workflow

1. Parse user intent → extract country, category, time period
2. Map to parameters:
   • "Brazil" → --geo BR
   • "Indonesia" → --geo ID
   • "games" → --category games
   • "AI/tech/technology" → --category technology
   • "past week" / "7 days" → --hours 168
3. Inform user: "Fetching [category] trends for [country] (past [N] hours)..."
4. Run script and parse JSON output
5. 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

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 168 for a wider time window
• Country not found: run python scripts/run.py --list-countries to see all supported codes