Skip to content
Back to search

google-trends-mcp

MCP server for Google Trends (interest over time, by region, related queries, trending now)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ruimiguelcosta--google-trends-mcp/badge.svg)](/listings/ruimiguelcosta--google-trends-mcp)

HTML

<a href="/listings/ruimiguelcosta--google-trends-mcp"><img src="/api/listings/ruimiguelcosta--google-trends-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

"google-trends": {
  "type": "stdio",
  "command": "uv",
  "args": ["run", "--script", "/path/to/google-trends-mcp/server.py"],
  "env": { "TRENDS_DEFAULT_GEO": "PT", "TRENDS_HL": "pt-PT" }
}

Env: `TRENDS_DEFAULT_GEO` (default `PT`), `TRENDS_HL` (UI language, default `pt-PT`), `TRENDS_TZ` (minutes offset, default `0`).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 40 lines
  1. # google-trends-mcp
  2. MCP server for Google Trends. Single-file `uv` script, no API key: it uses the same
  3. web endpoints as trends.google.com (unofficial, so Google can change or rate-limit them).
  4. ## Tools
  5. | Tool | What it returns |
  6. |---|---|
  7. | `interest_over_time` | 0–100 interest over time for up to 5 keywords (or topic mids `/m/...`), with averages |
  8. | `interest_by_region` | Interest per region/city, or per country when `geo=""` |
  9. | `related_queries` | Top and rising related searches (`Breakout` = >5000% growth) |
  10. | `trending_now` | What is trending in a country in the last ~24h, with traffic and news links |
  11. | `suggestions` | Autocomplete: keywords and topics with their `mid` |
  12. Common parameters: `geo` (`PT`, `PT-11`, `""` = worldwide), `timeframe`
  13. (`now 7-d`, `today 3-m`, `today 12-m`, `today 5-y`, `all`, `2025-01-01 2025-06-30`),
  14. `category` (numeric Trends category id), `property` (`web|images|news|youtube|shopping`).
  15. Related *topics* is not exposed: Google tags these requests as `USER_TYPE_SCRAPER`
  16. and always returns an empty topic list for them.
  17. ## Setup
  18. ```json
  19. "google-trends": {
  20. "type": "stdio",
  21. "command": "uv",
  22. "args": ["run", "--script", "/path/to/google-trends-mcp/server.py"],
  23. "env": { "TRENDS_DEFAULT_GEO": "PT", "TRENDS_HL": "pt-PT" }
  24. }
  25. ```
  26. Env: `TRENDS_DEFAULT_GEO` (default `PT`), `TRENDS_HL` (UI language, default `pt-PT`),
  27. `TRENDS_TZ` (minutes offset, default `0`).
  28. ## Limits
  29. Google answers 429 when hit too often; the server retries with backoff (up to ~30 s)
  30. and caches explore results for 10 minutes. Values are relative (0–100), not search volumes.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.