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

1. Run python3 scripts/fetch-google-trending.py [GEO] [COUNT]
2. Parse and present the results to the user
3. 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.