{
  "markdown": "# google-trends-mcp\n\n> Free Google Trends data inside any MCP-compatible AI client. No API key required.\n\n[![CI](https://github.com/purahmanian/google-trends-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/purahmanian/google-trends-mcp/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/google-trends-mcp)](https://www.npmjs.com/package/google-trends-mcp)\n\n---\n\n> **UNOFFICIAL ENDPOINT DISCLAIMER**\n>\n> This server communicates with the same internal endpoints that the\n> [trends.google.com](https://trends.google.com) frontend uses. These endpoints are\n> undocumented and unofficial. Google can change, rate-limit, or remove them at any time\n> without notice. This project is not affiliated with, endorsed by, or sponsored by\n> Google LLC. \"Google Trends\" is a trademark of Google LLC.\n>\n> If requests start failing, open an issue. The fix is usually a URL or parameter tweak.\n\n---\n\n## What it does\n\n| Tool | Description | Example prompt |\n|------|-------------|----------------|\n| `interest_over_time` | Weekly interest scores (0-100) for up to 5 terms | \"Show me interest in 'matcha latte' over the past year in the US\" |\n| `compare_terms` | Normalized comparison of 2-5 terms with winner callout | \"Compare 'coffee', 'tea', and 'matcha' in Canada\" |\n| `related_queries` | Top and rising related search queries for a term | \"What related queries are rising for 'cold plunge'?\" |\n| `trending_now` | Today's daily trending searches for a country | \"What's trending on Google in the UK right now?\" |\n| `interest_by_region` | Regional breakdown of interest (country or sub-region) | \"Which US states search for 'pickleball' most?\" |\n\n---\n\n## Quick start\n\nNo API key is needed. Install and run via `npx`.\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`\n(macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"google-trends\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"google-trends-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add google-trends -- npx -y google-trends-mcp\n```\n\n### OpenAI Codex CLI\n\nAdd to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.google-trends]\ncommand = \"npx\"\nargs = [\"-y\", \"google-trends-mcp\"]\n```\n\n---\n\n## Example conversations\n\n**Spotting seasonality:**\n> \"Use Google Trends to show me interest in 'pumpkin spice' over the past 5 years worldwide.\"\n>\n> The model calls `interest_over_time` with `terms=[\"pumpkin spice\"]`, `timeframe=\"today 5-y\"` and\n> narrates the clear September-October spikes each year.\n\n**Keyword competition:**\n> \"Compare search interest in 'Notion', 'Obsidian', and 'Roam Research' in the US this year.\"\n>\n> The model calls `compare_terms`, reads the averages, and identifies the winner with supporting\n> time-series data.\n\n**Opportunity discovery:**\n> \"What are the fastest-rising related queries for 'sourdough bread' right now?\"\n>\n> The model calls `related_queries` and surfaces the rising queries, often revealing adjacent\n> niches and trending subtopics.\n\n---\n\n## Development\n\n```bash\n# Clone and install\ngit clone https://github.com/purahmanian/google-trends-mcp.git\ncd google-trends-mcp\nnpm install\n\n# Run tests (no network calls; all HTTP is mocked)\nnpm test\n\n# Build TypeScript to dist/\nnpm run build\n\n# Run the server locally (stdio mode)\nnode dist/index.js\n```\n\n### Rate limits and blocking\n\nGoogle does not publish a rate limit for these endpoints. In practice, a few requests\nper minute works reliably. If you hit HTTP 429 or get blocked, the server returns a\ndescriptive error message. Waiting 2-5 minutes usually resolves it.\n\n---\n\n## Built by\n\nBuilt by **Puya Ventures LLC**. I build custom MCP servers and AI integrations for\nproduct teams and researchers. Get in touch:\n[purahmanian@gmail.com](mailto:purahmanian@gmail.com) |\nPortfolio: [puyarahmanian.com](https://puyarahmanian.com)\n\nPart of the **Product-Research MCP Suite**:\n[keepa-mcp](https://github.com/purahmanian/keepa-mcp) ·\n[google-trends-mcp](https://github.com/purahmanian/google-trends-mcp) ·\n[junglescout-mcp](https://github.com/purahmanian/junglescout-mcp)\n\n---\n\n## Privacy\n\nThis server runs entirely on your machine. It collects no telemetry and stores\nno data. The only network calls it makes are to Google Trends endpoints\n(trends.google.com), sending the search terms and region codes you ask about.\nNo account or API key is involved. See Google's privacy policy:\nhttps://policies.google.com/privacy\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n",
  "bytes": 4515,
  "sha": "05f4c178f594f742a6a3fdc4dd1c7ec92226726be59f5611ccb565af4bd22be6",
  "repo_slug": "purahmanian/google-trends-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_purahmanian_google_trends_mcp_a15796bc/readme"
}