mcpField
G
Google Trends Scraper

Google Trends Scraper

Remote
apify.comData & Analytics0Updated 3w ago

About Google Trends Scraper

Google Trends Scraper retrieves Google Trends data for Python users and MCP clients. It compares more than 10 keywords on a shared scale and returns time series, regional interest, related queries, and trend metrics.

Key features

  1. 01Interest over time and by region
  2. 02Top and rising related queries
  3. 03Trend and peak metrics
  4. 04Compare many keywords on one scale
  5. 05CSV and chart examples

Use cases

  1. 01Compare search interest across terms
  2. 02Identify rising related queries
  3. 03Review regional keyword interest

MCP support

Provides a hosted MCP server URL that lets MCP clients look up Google Trends data. Authentication uses Apify sign-in or an API token, and runs are billed to the Apify account.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://mcp.apify.com/?tools=ralfij/google-trends-scraper
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

All endpoints
Streamable HTTPhttps://mcp.apify.com/?tools=ralfij/google-trends-scraperAuth required

Tools

Details

From the project README

Google Trends API for Python (a pytrends alternative)

Get Google Trends data into Python: interest over time, interest by region, top and rising related searches, and simple trend metrics. You can also compare 10, 50 or 100+ keywords on one scale. The Google Trends website stops at 8 (5 in classic Explore).

pytrends was archived in April 2025 and often fails with 429 Too Many Requests. Google announced an official Trends API in July 2025, but it is an alpha with limited, application-based access. These examples use a hosted scraper instead, the Google Trends Scraper on Apify, which deals with Google's session cookies and rate limits for you.

Tutorial: Google Trends in Python without pytrends, and how to compare more keywords than Google allows. It covers the two endpoints behind the website, the trick for linking comparisons, and what the data looks like.

Google searches for programming languages over 5 years

Example output: search interest in the Programming category fell 40-68% for most languages between 2021 and 2026. Made with examples/compare_keywords.py and matplotlib.

Quick start

  1. Create a free Apify account. The free plan includes $5 of credit every month, which covers about 2,500 keywords. No credit card needed.
  2. Copy your API token from Settings > API & Integrations in Apify Console.
  3. Run an example:
pip install -r requirements.txt
export APIFY_TOKEN=your-token        # Windows: set APIFY_TOKEN=your-token
python examples/compare_keywords.py
keyword       share %  average  trend
java             29.4     63.7  falling (-48.8%)
c++              23.8     51.6  stable (-7.1%)
python           15.8     34.3  falling (-43.7%)
...

Examples

FileWhat it does
examples/compare_keywords.pyCompares 10 keywords on one shared scale, prints share of search and trend, and saves a CSV
examples/keyword_report.pyTrend, peak, busiest month, top regions and rising searches per keyword
examples/plot_trends.pyPlots interest over time for several keywords with matplotlib
examples/raw_endpoints.pyThe two JSON endpoints behind trends.google.com, with no library at all. Good for a few keywords.

sample-output/programming-languages-5y.csv shows the CSV from compare_keywords.py.

What you get per keyword

  • interestOverTime: the full time series (0-100), with the unfinished last week or day marked partial
  • interestByRegion: countries, states or regions where the keyword is most popular
  • relatedQueriesTop and relatedQueriesRising, including breakouts
  • averageInterest, latestInterest, peakInterest, peakDate
  • trend (rising, falling or stable) and trendChangePercent: the last quarter of the period against the first quarter
  • busiestMonth for periods of about a year or longer
  • shareOfSearch when you compare keywords on one shared scale

How comparing many keywords works

Google's Trends API compares at most 5 keywords per request (the website shows up to 8) and scales each request so its highest point is 100. To compare more, the scraper:

  1. requests the keywords in groups of 5;
  2. compares the most searched keyword of each group (the group "leader") with the other leaders, 5 at a time with one leader of overlap, so any number of groups can be chained;
  3. rescales every group through its leader, then rescales everything so the highest point overall is 100.

Google rounds to whole numbers, so a tiny keyword next to a huge one can still show as 0. Compare keywords of a similar size for the best precision.

Use it from AI assistants (MCP)

To let Claude, Cursor, VS Code or another MCP client look up Google Trends for you, add this MCP server URL: https://mcp.apify.com/?tools=ralfij/google-trends-scraper. Sign in to Apify when the client asks, or send your Apify API token as Authorization: Bearer <token>. Runs are billed to your own Apify account.

Notes

  • I built the Google Trends Scraper used in these examples, so keep that in mind. raw_endpoints.py shows how to do it yourself.
  • Pricing is per keyword with no subscription; see the actor page. More ready-made searches are on its example tasks.
  • Not affiliated with, endorsed by or sponsored by Google. Google Trends is a trademark of Google LLC.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.