Google Trending
Fetch the top trending Google searches in the last 24 hours via the Google Trends daily RSS feed. No API key required.
Usage
# Top 20 trending searches in the US (default)
python3 scripts/fetch-google-trending.py
# Specific country (ISO 3166-1 alpha-2 code)
python3 scripts/fetch-google-trending.py FR
python3 scripts/fetch-google-trending.py GB
python3 scripts/fetch-google-trending.py JP
# Custom result count
python3 scripts/fetch-google-trending.py US 10
Arguments
| Position | Default | Description |
|---|---|---|
| 1 | US |
Country code (ISO 3166-1 alpha-2) |
| 2 | 20 |
Number of trending topics to show |
Output
For each trending topic: rank, search term, approximate search volume, publication time, up to 2 related news headlines with source, and a link to the Google Trends page.
Data source
- Feed:
https://trends.google.com/trending/rss?geo={GEO} - Update cadence: refreshed every few hours by Google
- No auth required: uses only public RSS endpoints and Python stdlib (
urllib,xml.etree)
Workflow for the AI agent
- Run
python3 scripts/fetch-google-trending.py [GEO] [COUNT] - Parse and present the results to the user
- If the user asks about a specific trending topic, you can search for more context using WebSearch
Guardrails
- Data comes directly from Google Trends RSS — do not fabricate traffic numbers or topics.
- The feed reflects Google's own editorial/algorithmic choices; surface that to the user if asked why a topic appears.
- If the fetch fails (network error, rate limit), report it clearly and suggest retrying.