trendspyg is the maintained Google Trends library that showed up in this session at PyPI 1.6.x with a CLI and trendspyg-mcp. Docs live at flack0x.github.io/trendspyg. Paths are RSS (fast, no browser), CSV (Chrome, trending list), and Explore (Chrome, interest over time). The project is explicit: Google's side of the wire is not covered by semver. Trends API is the hosted exit. Modes are on the API reference.

Three paths, one website

RSS wraps the public Google feed. That is the same XML the RSS alternative page describes. Good for "what is trending now." Useless for a 12-month keyword series.

CSV needs Chrome and returns a large trending list. Explore needs Chrome and returns interest over time, related queries, and region rows. Comparison of 2-5 keywords is a dedicated function. gprop can switch YouTube, News, Images, or Shopping search interest. That is still Google Trends, not the YouTube live board.

Honest about 429s

The readme's Explore note is the stop. Fresh Chrome sessions in a short burst can earn Google's hard block page. Recovery is measured in tens of minutes or longer. RateLimitError means stop, not retry. Disk cache and cookie reuse reduce repeats. They do not add source=amazon.

Trends API Explore-equivalent is get_time_series with source google search. No Chrome on the caller. Google rate limits still exist on the vendor side. The caller does not drive a browser.

{
  "mode": "get_time_series",
  "source": "google search",
  "keyword": "bitcoin"
}

Parse the body string. value is 0-100. A local archive of RSS snapshots is not this series.

MCP without a Trends API key

pip install trendspyg[mcp] exposes eight local tools. No hosted key. The agent still hits Google from that machine. Trends API's MCP server is a different process: it calls the hosted POST. Do not confuse trendspyg-mcp with Trends API MCP.

When a local archive is not a source

Keep trendspyg when a researcher wants RSS watch, a CLI, and an honest 429 story. Leave when the service cannot install Chrome, cannot absorb a 35-minute ban, or must join Google to TikTok. The other Python client is trendspy. The shopping list is pytrends modern replacements.