Google Trends MCP
Google Trends MCP
ローカルで動作する MCP サーバーで、Claude(または任意の MCP クライアント)が Google Trends を直接クエリできるようにします。検索関心の時系列、関連クエリとトピック、地域別の内訳、リアルタイムのトレンド検索を、trends.google.com にタブを切り替えてスクリーンショットを貼り付ける代わりに、会話の中でマーケットリサーチできます。
個人・自己利用向けのマーケットリサーチのために作られています。API キーは不要です — Google Trends には公式のパブリック API がないため、この MCP サーバーは標準的な非公式 Python クライアントである pytrends をラップしています。
ツール
特に記載がない限り、すべてのツールは geo="IN"(インド) をデフォルトにします。全世界を対象にするには geo="" を渡し、または任意の ISO 国コード("US"、"GB" など)を渡します。timeframe は pytrends の形式で指定します。例: "today 12-m"、"today 5-y"、"now 7-d"、または明示的な範囲 "2024-01-01 2024-06-01"。
interest_over_time(keywords, timeframe="today 12-m", geo="IN")
最大5キーワードの相対的な検索関心度(0〜100)を時間経過で並べて比較します。最初の5件を超えるキーワードは黙って無視されます。各レコードには isPartial が含まれます。最新のデータポイントで true の場合、その期間はまだ終了しておらず、値は暫定的だという意味です。そのポイントでの下落を実際のトレンド変化として読み取らないでください。
related_queries(keyword, timeframe="today 12-m", geo="IN")
単一キーワードのトップおよび急上昇中の関連検索クエリを返します。返り値は {"top": [...], "rising": [...]} で、各要素は {"query": ..., "value": ...} というレコードです。top の値は 0–100 の相対関心度です。rising の値はパーセント増加率です — ただし 5000% という値を除きます。これはほぼゼロのベースラインから急激な成長を表す Google の「Breakout」マーカーであり、文字どおりのパーセンテージではありません。
related_topics(keyword, timeframe="today 12-m", geo="IN")
related_queries と同じですが、生のクエリ文字列ではなくトピッククラスター(Google 独自のトピックグループ)を返します。レコードには value に加えて topic_title と topic_type が含まれます。rising にも同じ Breakout の規約が適用されます。
interest_by_region(keyword, timeframe="today 12-m", geo="IN")
指定された geo 内の州・地域別にキーワードの検索関心を集計します。{"geoName": ..., "<keyword>": 0-100} のレコードを地域ごとに1件ずつ返します。
trending_now(geo="india")
ある国での今日の急上昇トレンド検索を返します。ここでは geo の形式が異なることに注意してください — 他の4つのツールのようなISOコードではなく、小文字の国名全体("india"、"united_states")を使います。これは Google 側のエンドポイントが実際に不整合であるからであり、バグではありません。
既知の制限: 本稿執筆時点では、
trending_nowは HTTP 404 で失敗します。Google は pytrends のトレンド検索メソッドが依存しているレガシーエンドポイント(hottrends/dailytrends/realtimetrends)を廃止したようです。pytrends が提供する3つのバリアントをすべてテストして確認しました。これは上流側の問題であり、このコードベースでは修正できません。クラッシュするのではなく、読みやすいエラー文字列で失敗します。他の4つのツールは別の、まだ機能するエンドポイント群を使っており、影響を受けません。Google がこのエンドポイントを復旧するか、pytrends が回避策を実装すれば、このコードを変更しなくても再び動くようになるはずです。
全ツールは失敗(レート制限、ネットワークエラー、上記の既知の限界など)をキャッチして、クラッシュせず純粋なエラー文字列を返します。Google Trends はスクレイピング対象のエンドポイントで安定した API ではないため、これは例外的ではなく予期された動作です。
Related MCP server: Google Trends MCP Server
セットアップ
Python 3.10+ と uv が必要です。
git clone https://github.com/jain-eshan/google-trends-mcp.git
cd google-trends-mcp
uv syncClaude Code に登録する
claude mcp add google-trends -- uv run --directory /absolute/path/to/google-trends-mcp server.py接続を確認します:
claude mcp listgoogle-trends が ✔ Connected として表示されるはずです。登録後は 新しく Claude Code の会話を開始してください。すでに実行中のセッションでは、追加した新しいサーバーは認識されません。
使い方
登録後は、Claude にごく人工、使うよう依頼するだけです。例:
「google-trends MCP を使って、インドでの「lab grown diamonds」 vs 「diamond jewellery」の関心を過去12ヶ月で比較し、関連クエリを表示してください。」
オプション: /trends スキル
このリポジトリには、.claude/skills/trends/SKILL.md にある Claude Code スキルが含まれています。これは生のツール群をリサーチと総括のワークフローにまとめ、トピックに関連するツールを選び、生の JSON をそのまま出力する代わりに平易な言葉での要約を生成します。Claude Code を使っている場合は、このスキルはこのリポジトリから自動で認識されます。次のように実行するだけです:
/trends <your topic>設計メモ
データのみ。サーバーで分析は行わない。 各ツールは生の構造化データを返します。解釈(このトレンドは本物か、この Breakout マーカーは何を意味するか、何に注目する価値があるか)は呼び出し側の会話で行われ、サーバーには組み込まれません。これによりサーバーはシンプルになり、呼び出し側(Claude や他の MCP クライアント)が独自の判断を下せます。
依存関係は
mcp[cli]とpytrendsのみ。 データベースも、設定ファイルも、APIキーもありません。本格的なテストスイートはない。 これはスクレイプされたサードパーティのエンドポイントをラップしているため、テストスイートはほとんど pytrends と Google の現在のレスポンス形状をテストすることになり、このコード自体をテストするものではありません。代わりに、開発中に各ツールを実際の Google Trends データで検証しました。
ライセンス
MIT — LICENSE を参照してください。
Available Tools
11 toolsapp_store_appsA
Existing iPhone/iPad apps matching a query, from Apple's public iTunes Search API - who already serves this need, and how many people rate them (rating count is a rough proxy for user base). No setup needed.
Args: query: search terms, e.g. "meal planner" or "invoice". country: ISO country code for the store, e.g. "US" (default), "IN", "GB". limit: max apps, capped at 50.
Returns: A list in App Store relevance order, each with "name", "developer", "rating", "rating_count", "price", "genre", "released", "last_updated", "url".
Inputs: query (required), limit, country.
builder_activityA
Are people actually building and shipping in this space? Hacker News stories
(launches, Show HNs, debates) plus GitHub repositories - a builder signal, as opposed
to search interest or community chatter. Works with no setup; a GITHUB_TOKEN saved via
/gutcheck setup raises GitHub's limit from 10 to 30 searches a minute.
For Product Hunt launches, use web search restricted to producthunt.com instead - Product Hunt's API has no search endpoint.
Args: query: search terms, e.g. a product category ("habit tracker") or problem.
Returns: {"hn": {"total": int, "stories": [...]}, "github": {"total": int, "repos": [...]}}. Each story: title, points, num_comments, url, created_at. Each repo (top 10 by stars): name, description, stars, last_push, url.
Inputs: query (required).
company_registrationA
Company registration lookup via OpenCorporates - registration facts only (incorporation date, status, company number). Does NOT cover funding, valuation, or traction data - no free API exists for that (see README for why).
Requires a free OpenCorporates API token: as of 2026 OpenCorporates requires a
token on every request, even on the free tier (roughly 50 requests/day, 200/month).
Register at https://opencorporates.com/api_accounts/new and save it as
OPENCORPORATES_API_TOKEN via /gutcheck setup.
Args: name: company name to search for. jurisdiction: optional OpenCorporates jurisdiction code (e.g. "in", "us_de") to narrow results.
Returns: A list of up to 5 matches, each containing "company_name", "jurisdiction_code", "incorporation_date", "company_number", "current_status", "opencorporates_url". Empty list if no matches. A setup-instructions string if OPENCORPORATES_API_TOKEN is unset, or OpenCorporates' own rejection message if the token is invalid/expired.
Inputs: name (required), jurisdiction.
interest_by_regionA
Search interest for a keyword broken down by state/region within a country, or by country when geo is "" (worldwide).
Args: keyword: a single search term. timeframe: pytrends timeframe string, e.g. "today 12-m". geo: ISO country code (e.g. "US", "IN"), or "" for worldwide (default). response_format: "concise" (default) returns only the top 10 regions by interest, rounded to whole numbers. "full" returns every region, unrounded.
Returns: A list of records, one per state/region within the specified geo, each containing: - "geoName": the state/region name (e.g. "California"), or the country name when worldwide - A column with the keyword name as the key: relative search interest (0-100 scale) for that region. Higher values indicate higher relative interest in that region compared to others in the same country. This is Google Trends' standard region-relative scale.
Inputs: keyword (required), geo, timeframe, response_format.
interest_over_timeA
Relative Google search interest (0-100) over time for up to 5 keywords, compared side by side.
Args: keywords: 1-5 search terms to compare. Only the first 5 are used; additional keywords are silently dropped. timeframe: pytrends timeframe string, e.g. "today 12-m", "today 5-y", "now 7-d", or "YYYY-MM-DD YYYY-MM-DD". geo: ISO country code (e.g. "US", "IN", "GB"), or "" for worldwide (default). response_format: "concise" (default) covers the whole requested timeframe, thinned to about 26 evenly spaced points (first and last always kept) and rounded to whole numbers, so the shape of the window is intact at a low token cost. "full" returns every point unrounded - use it when you need week-by-week detail.
Returns: A list of records, one per date, each containing: - "date": ISO date string - "isPartial": present and true only when the period is incomplete (most recent point) - omitted when false in "concise" mode, since false is the common case. - One numeric key per keyword (0-100 relative interest value)
Inputs: keywords (required), geo, timeframe, response_format.
news_coverageA
Recent news coverage from Google News - is the press writing about this, and what angle are they taking? Useful for spotting funding rounds, regulation, launches, and whether a topic is getting more or less attention. No setup needed.
Args:
query: search terms.
geo: ISO country code for the news edition, e.g. "US" (default), "IN", "GB".
recent: how far back - "7d", "1m", "1y" (default). Uses Google News' own when: filter.
limit: max headlines to return (Google returns up to ~100; "total" counts all of them).
Returns: {"total": int, "last_30_days": int, "headlines": [{"title", "source", "published", "url"}]}, newest first. "total" and "last_30_days" are counts within Google's capped result set, so treat them as a rough attention gauge, not an exact article count.
Inputs: query (required), geo, limit, recent.
reddit_signalA
What real people on Reddit are saying, asking, or complaining about - qualitative community signal, as opposed to Trends/Wikipedia's passive search/reading numbers.
Works with no setup via Reddit's public search feed (which returns post text but not
scores, and rate-limits after a burst of requests). If REDDIT_CLIENT_ID and
REDDIT_CLIENT_SECRET are saved via /gutcheck setup, uses the official API instead,
which adds score and comment counts.
Args: query: search terms. subreddits: optional subreddit names to restrict the search to (e.g. ["startups", "SaaS"]). limit: max results, capped at 100. time_filter: "week", "month", "year" (default), or "all".
Keep the query short (2-4 words) and pass subreddits when obvious communities exist.
Reddit's keyless search matches loosely on long questions, so results that share no
meaningful word with the query are dropped and the rest are ranked by how many query
words they match.
Returns: A list of records with "title", "subreddit", "snippet" (first ~300 chars of the post body), "url", "created". "score" and "num_comments" are included only in API mode.
Inputs: query (required), limit, subreddits, time_filter.
wikipedia_pageviewsA
Monthly Wikipedia pageview counts for an article - a free, no-auth reference/reading interest signal that complements Google Trends' search-interest signal. The two diverging (e.g. a term trending in search but flat on Wikipedia) can itself be a signal worth flagging.
Args: article: an English Wikipedia article title, e.g. "Artificial_intelligence" or "Machine learning" (spaces are handled automatically). timeframe: how far back to request, as a simple duration - "P1Y" (1 year, default), "P6M" (6 months), "P90D" (90 days). Only whole Y/M/D forms are supported. response_format: "concise" (default) returns only the most recent 12 months. "full" returns the entire requested timeframe.
Returns: A list of records, one per month, each containing: - "month": "YYYY-MM" - "views": total pageviews that month (all access methods, human traffic only - bot traffic is excluded by Wikimedia's "user" agent filter)
Inputs: article (required), timeframe, response_format.
youtube_videosA
YouTube videos matching a query, with view and comment counts - shows how much people watch content about a topic (tutorials, reviews, "I tried X" videos), which is often a stronger consumer-interest signal than search volume.
Requires a free YOUTUBE_API_KEY (Google Cloud, YouTube Data API v3), saved via
/gutcheck setup. Each call uses about 101 of the free 10,000 daily quota units.
Args: query: search terms. limit: max videos, capped at 25. published_after_days: only videos from the last N days; omit for any time.
Returns: A list in YouTube relevance order, each with "title", "channel", "published", "views", "likes", "comments", "url". A setup-instructions string if no key is saved.
Inputs: query (required), limit, published_after_days. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct data source or dimension: Google Trends topics, queries, time series, regional breakdown, plus Wikipedia, OpenCorporates, Reddit, HN/GitHub, Google News, App Store, and YouTube. Even within Trends, related_topics vs related_queries are clearly separated by content type. No ambiguity.
All tool names follow a consistent snake_case noun phrase pattern (e.g., interest_over_time, reddit_signal, builder_activity). No mixing of conventions or verb styles, making the set predictable and easy to navigate.
With 11 tools covering a wide but focused range of market research signals, the count is well-scoped. Each tool contributes a unique data source, and none feel redundant or missing for the server's stated purpose.
The surface covers search interest, related topics/queries, regional data, reference interest (Wikipedia), community chatter (Reddit), builder activity (HN/GitHub), news coverage, app ecosystem, and YouTube viewership. Minor gaps exist (e.g., no global 'trending now' without a keyword, no multi-keyword regional comparison), but core workflows are well supported.
Maintenance
Related MCP Connectors
Google Trends: Search, Images, News, Shopping over time, growth metrics. Free key at trendsmcp.ai
Google Trends for agents: interest over time, by region, rising queries, Trending Now. No API key.
Google Trends realtime & entities
Bulk Google Trends: interest over time, regions, rising queries and plain-English trend summaries.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides access to Google Trends data including status, trending questions, and trending topics via MCP tools.2335 npm36MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access Google Trends data for comparing keywords, discovering trending searches, and analyzing regional interest through natural language.2MIT
- AlicenseAqualityDmaintenanceProvides free Google Trends data (interest over time, term comparison, related queries, trending now, regional breakdown) to MCP-compatible AI clients without needing an API key.5134 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query Google Trends data, including search interest over time, regional breakdowns, trending searches, and keyword ideas.MIT