Google Trends

Google Trends MCP サーバー — gtrends-mcp-full

Google Trends 用の完全な MCP サーバーです。 Claude、Cursor、Windsurf、VS Code、Codex、その他の MCP クライアントに、今、人々が何を、どこで、いつ検索しているのか、何が急上昇しているのかを尋ねれば、見づらいグラフではなく分析結果が得られます。

32 個のツール · 実際の検索ボリュームを表示する「急上昇中」 · 関心度の推移、地域別データ、関連検索 · 季節性、勢い、検索シェア · API キー不要、ブラウザー不要、サインイン不要

プロジェクトページ · クイックスタート · ツール · プロンプト · 設定 · ブロックされずに動作し続ける仕組み · FAQ · ドキュメント

---

得られるもの

✅ 完全な情報	Google Trends のウェブサイトに表示されるすべての情報に対応します。「急上昇中」の全リスト（国ごとに数百件のトレンド、検索ボリューム、増加率、開始時刻、カテゴリ、各トレンドに含まれる検索語句付き）、トレンドの背景にあるニュース、分単位の関心度の推移、国・地域・都市・大都市圏別の関心度、関連検索語句とトピック、すべてのカテゴリと地域、ウェブ、YouTube、ニュース、画像、ショッピングの検索に対応します。
🔑 設定不要	API キー、Google Cloud プロジェクト、サインイン、ヘッドレスブラウザーは不要です。インストールして質問するだけです。
🧠 グラフではなく回答	増加しているのか、減少しているのか。ピークはいつで、コンテンツはいつ公開すべきか。検索シェアで優勢なのは誰か。何が突然急上昇し、それはいつか。こうした分析を代わりに行い、AI が推論に使える簡潔な表で返します。
📈 ウェブサイトの制限を超えて	5 つではなく 25 個の検索語句を同じ尺度で比較できます。9 か月分ではなく、何年分もの日次データを取得できます。「急上昇中」の履歴を 1 週間ではなく、好きなだけ保存できます。
🛡️ 動作し続けるように設計	リクエストの間隔調整、永続セッション、連続アクセスではなくバックオフ、そして Google が応答しないときも回答を返し、その旨を伝えるキャッシュを備えています。関連検索とグラフのリクエストは別々に予算管理されるため、片方の制限で他方まで停止することはありません。
🎯 数値を正確に表示	すべての値に内容を明記します。Google の 0～100 の指数であり、検索件数ではありません。期間の一部しか含まれない場合はその旨を示します。失敗時には、理由と次の対処方法を含むエラーを返し、空の結果を返すことはありません。
💸 無料で軽量	MIT ライセンスです。依存関係は 2 つです。お使いのマシンで実行でき、Google 以外にデータを送信しません。Python 3.10～3.13 で Linux、macOS、Windows をテストしています。

対応環境： Claude Desktop · Claude Code · Cursor · Windsurf · VS Code（Copilot エージェントモード）· OpenAI Codex CLI · stdio または HTTP を使う任意の MCP クライアント。

ツール

5 つのグループに分かれた 32 個のツールがあります。自分で呼び出す必要はありません。自然な言葉で尋ねるだけで、AI が適切なツールを選びます。

🗄️ ローカルのデータファイルを使用し、Google へのリクエストは行いません

🔥 現在のトレンド

ツール	わかること	質問例
trending_now	国や地域の「急上昇中」リスト全体：検索数、増加率、開始時刻、現在も継続中か終了したか、カテゴリ、同じ話題で人々が入力している他の検索語句。カテゴリ、ステータス、検索数、テキストで絞り込めます	「過去4時間にドイツで話題になっているのは？」 · 「米国で検索数が10万件を超える、現在も継続中のスポーツ関連トレンドは？」
trend_details	トレンド1件の詳細：トレンドに含まれるすべての検索語句、その背景にあるニュース記事、過去1週間の時間ごとの推移	「『pentobarbital』が話題になっているのはなぜ？」
trending_feed	見出しとリンク付きの、その日の上位トレンド。「今日、あそこで何がニュースになっているか」への最速の回答です	「イランで今日検索数が多い語句を、見出し付きで教えて」
trending_across_countries	複数の国で同時に話題になっているトレンド。タイトルが異なっていてもまとめて表示します	「今、米国と英国の両方で話題になっているのは？」
match_trends	ニュースジャックに活用できる、自分の関心分野、ブランド、製品に関連する現在のトレンド	「今日、電気自動車、Tesla、または充電に関する話題はある？」

🔎 キーワードを調べる

ツール	わかること	質問例
keyword_overview	1回の呼び出しでトレンドページ全体を表示：推移、方向性、人気の場所、急上昇中および人気の関連検索語句	「英国における『heat pump』のGoogleトレンドの状況を教えて」
interest_over_time	最大5つの語句を同じ尺度で比較するメインチャート。1時間から2004年〜現在までの任意の期間、場所、カテゴリ、検索タイプを指定でき、演算子（a + b、a -b、"a b"）にも対応します	「ドイツで過去5年間のteslaとbydを比較して」 · 「今週の『lofi』のYouTube検索への関心度」
interest_by_region	語句への関心が最も高い場所：国、地域、都市、または大都市圏。複数の語句を指定すると、地域ごとにどちらが優勢かがわかります	「米国で『tesla』を最もよく検索している州は？」 · 「bydがteslaを上回っているのはどこ？」
related_queries	ある語句と合わせて人々が検索している内容：人気の検索語句と急上昇中の検索語句。急上昇中のものにはブレイクアウトのマークが付きます	「『solar panels』に関連して急上昇している検索語句は？」
related_topics	ある語句と合わせて検索されている人物、ブランド、事柄と、トピックID	「『tesla』に関連するトピックは？」
compare_periods	1つの語句について、2つの期間を同じ尺度で比較します。今年と去年、今四半期とその前の四半期など	「『sunscreen』は去年の夏より関心が高い？」
compare_locations	1つの語句について、最大5つの国または地域を並べて比較します	「インド、英国、オーストラリアのクリケットへの関心を比較して」

🧠 分析

ツール	内容	質問例
trend_momentum	各用語の判定（急上昇、上昇、安定、下降、新規）に加え、前年比、前四半期比、長期的な傾向、ピークからの差を示します	「この8つの製品アイデアのうち、実際に伸びているのはどれですか？」
seasonality	年間の推移（月ごとの指数、ピークと低迷の月、繰り返しの安定度、年ごとの成長、今後6か月の予測、コンテンツを公開すべき日）を示します	「エアコンはいつ検索されますか？いつ公開すればよいですか？」
content_calendar	最大8つのトピックを対象に、期限が近い順に並べた公開カレンダーを作成します。常緑のトピックは別に表示されます	「これらのトピックのコンテンツカレンダーを作成してください」
share_of_search	最大4社の競合他社に対する自社ブランドの検索シェアを、全体、開始時点、終了時点、およびポイントの変化で示します	「Honda、Ford、Teslaと比較したToyotaの検索シェアはどのくらいですか？」
compare_many	ウェブサイトの上限である5件を超え、6〜25件の用語を単一の尺度で順位付けします	「米国で検索関心度が高い順に、これら20の自動車ブランドを並べてください」
find_spikes	用語の急上昇した時期（各急上昇の開始、ピーク、終了）と、通常の水準の何倍に達したかを示します	「過去5年間で『earthquake』の検索数が急上昇したのはいつですか？」
daily_history	ウェブサイトでは約9か月前までしか確認できない、年単位の日ごとの関心度に加え、曜日ごとの傾向を示します	「2024年と2025年の『pizza delivery』の日ごとの関心度を教えてください。最も高い曜日はいつですか？」
keyword_ideas	最大5つのシードキーワードから、関連する上昇中および上位のクエリをまとめ、重複を除いて急上昇中のものから表示します	「『electric bike』と『e-scooter』に関するキーワード案をください」

🗄️ Googleが保存しない履歴

ツール	内容	質問例
snapshot_trending	現在の「Trending Now」リストをローカルファイルに保存します。Googleでは約1週間でトレンドが削除されますが、このツールなら保存できます	「今日の米国、英国、ドイツのトレンドを保存してください」
trending_history 🗄️	保存されたすべての情報を検索し、何がいつトレンドになったか、どのくらいの規模になったか、どのくらい続いたかを確認します	「先月、米国で『iphone』に関するトレンドはありましたか？」
watchlist_add 🗄️	場所ごとにメモを付けて、用語をウォッチリストに追加します	「英国で『heat pump』と『solar panels』を追跡してください」
watchlist_report	現在のウォッチリストを測定し、傾向、前回のレポートからの変化、今日トレンドになっている用語があるかを示します	「ウォッチリストの状況を教えてください」
watchlist_remove 🗄️	用語をウォッチリストから削除します	「『fax machine』の追跡を停止してください」
history_sql 🗄️	保存されたトレンド、スナップショット、ウォッチリスト、測定値を対象とする読み取り専用SQLです	「今月、ドイツで最も多くトレンドになったカテゴリは何ですか？」

🧭 検索とユーティリティ

ツール	内容	質問例
find_location	国、地域、州、都市圏のコード、またはその中に含まれる場所の一覧を取得します	「テヘラン州のGoogle Trendsコードは何ですか？」
find_category	あいまいな単語の意味を絞り込むためのカテゴリIDを取得します	「『jaguar』を車に絞ってください」
find_topic	名前に対応するGoogleのトピックを取得します。対象の言語や表記を問わず、ひとつのIDでカバーします	「単語ではなく、企業のTeslaを指定してください」
get_capabilities 🗄️	設定、セッション状態、キャッシュと履歴の対象範囲、ツールの一覧を確認します	「Trendsサーバーは正しく設定されていますか？」
check_endpoints	各Google Trendsエンドポイントに質問をひとつずつ送り、応答するエンドポイントを報告します	「直近のTrends呼び出しが失敗したのはなぜですか？」
clear_cache 🗄️	保存済みの回答を削除し、必要に応じてセッションをリセットします	「トレンドデータを更新してください」

全パラメーターを網羅したリファレンスはdocs/tools.mdにあります。コードから生成されるため、常に最新です。

プロンプト

クライアントのプロンプトメニューに表示される、すぐに使える4つのワークフローです。複数のツールを連携させ、最終的な回答に含める内容を指定します。

プロンプト	生成される内容
trend_report	1つのキーワードの全体像：動向、季節性、急上昇の背景にある出来事、注目度が高まっているテーマ、取るべき対応
newsjacking_brief	今日のトレンドのうち、指定したテーマに合致するもの、それぞれの背景、狙うべき検索クエリ、切り口、リスクに関する注意点
seasonal_content_plan	トピックのリストを対象とした、12か月分の公開計画
market_comparison	競合ブランドに対する検索シェア、各分野で優勢なブランド、各ブランドの周辺で注目度が高まっているもの

参考ページも2つ、MCP リソースとして公開されています。gtrends://guide（数値、期間、演算子、トピックの読み方）と gtrends://trending-categories です。

クイックスタート

Python 3.10 以降と uv（または pip）が必要です。

1. クライアントに追加する

最初にダウンロードする必要はありません。uvx が PyPI からパッケージを取得して実行します。

Claude Code

claude mcp add gtrends -- uvx gtrends-mcp-full

Claude Desktop、Cursor、Windsurf、VS Code — クライアントの MCP 設定に以下を追加します。

{
  "mcpServers": {
    "gtrends": {
      "command": "uvx",
      "args": ["gtrends-mcp-full"],
      "env": {
        "GTRENDS_GEO": "US",
        "GTRENDS_TIMEZONE": "America/New_York"
      }
    }
  }
}

env の2つの項目はいずれも省略可能です。ほかに設定するものはありません。キーもサインインも不要です。

2. 確認する

uvx gtrends-mcp-full doctor

doctor は Google Trends の各エンドポイントに1つずつ質問し、すべてが OK になるはずです。初回実行時は、チャート用エンドポイントでセッションの検証中と表示される場合があります。1分半ほど経つと成功し、その後は再び発生しません。

3. 質問する

今、米国で何がトレンドになっていますか？そのうち、テクノロジー関連のものはどれですか？ 「ヒートポンプ」は英国で伸びていますか？ピークはいつですか？ ドイツで検索関心度の高い自動車ブランド15社を順位付けしてください。 今年のトヨタの検索シェアは、ホンダやフォードと比べてどのくらいですか？

コマンドラインから

パッケージをインストールした状態（uv tool install gtrends-mcp-full または pip install gtrends-mcp-full）で実行します。

gtrends-mcp-full doctor                 # configuration and endpoint check
gtrends-mcp-full trending US            # print what is trending now
gtrends-mcp-full snapshot US,GB,DE      # save Trending Now to the local history (for cron)
gtrends-mcp-full --transport streamable-http --port 8000   # serve over HTTP instead of stdio

たとえば6時間ごとにスナップショットを実行するようスケジュールして、トレンドの履歴を保存できます。

0 */6 * * * gtrends-mcp-full snapshot US,GB,DE

数値の読み方

Google Trends が返す値はすべて、検索回数ではなく 0から100までの指数です。ある検索語が全検索に占めた割合を、1回のリクエスト内で最も高い時点が100になるように再スケーリングしたものです。この仕組みから、次の3点が重要になります。各ツールはこれを踏まえて設計されています。

• 比較できるのは、同じリクエスト内の検索語だけです。 compare_many、share_of_search、compare_periods、compare_locations を使うと、1つの尺度で比較できます。
• 地域間の比較は、その地域の検索に占める割合です。 人口の少ない国が、人口の多い国を上回ることもあります。
• 期間の最後の時点は、通常まだ確定していません。 その値には印が付き、平均値の計算から除外されます。

例外は Trending Now で、実際の検索ボリュームが区分形式（「200K+」など）で表示されます。

検索語は文字どおりに照合されます。異なる表記を1つとして数えるには、1つの検索語に + でつなげて入力します（e-mail + email）。ものの名前を調べる場合は、find_topic を使うと、Google が言語や表記の違いを横断して解決するトピック ID を取得できます。

設定

すべての設定は省略可能です。

変数	デフォルト	機能
GTRENDS_GEO	worldwide	ツールの呼び出し時に場所が指定されていない場合のデフォルトの場所コード（US、IR、US-CA）
GTRENDS_HL	en-US	Google が返す名称（場所、カテゴリ、トピック）の言語
GTRENDS_TIMEZONE	このマシンのタイムゾーン	結果の時刻と時間単位のデータに使用する IANA タイムゾーン。例：Asia/Tehran
GTRENDS_PROXY	なし	Google へのリクエストに使用する HTTP(S) プロキシ URL
GTRENDS_MIN_INTERVAL	1.5	Google へのリクエスト間隔（秒）
GTRENDS_CACHE_TTL	3600	チャートの回答を再利用する秒数
GTRENDS_TRENDING_TTL	300	Trending Now の回答を再利用する秒数
GTRENDS_TIME_BUDGET	50	ツール呼び出しが Google の応答を待つ時間の上限（秒）。超過すると結果を返します
GTRENDS_COOKIE / GTRENDS_COOKIES_FILE	なし	Google にログインしたセッション（生の Cookie ヘッダー、または Netscape 形式の cookies.txt）。related_topics にのみ必要です。セキュリティを参照してください
GTRENDS_OFFLINE	オフ	キャッシュのみから回答し、Google には接続しません
GTRENDS_CONFIG_DIR	~/.config/gtrends-mcp-full	データファイルとセッション Cookie の保存場所
GTRENDS_DB_PATH	<config dir>/trends.sqlite	データファイル：キャッシュ、トレンド履歴、ウォッチリスト
GTRENDS_ALLOWED_HOSTS	なし	リバースプロキシ経由で HTTP モードを使用する際に許可するホスト名。HTTP モードには認証がなく、これを設定しないとパブリックアドレスでは起動しません。セキュリティを参照してください

ブロックを回避する仕組み

Google Trends には一般利用向けの公開 API がないため、このサーバーは Trends のウェブサイトと同じエンドポイントに接続します。これらのエンドポイントにはレート制限があり、スクリプトのように振る舞うスクリプトには容赦がありません。サーバーは次のように対処します。

• 長期間維持するセッションを1つ使用します。 Google はセッション Cookie がない場合、チャートのエンドポイントへのアクセスを拒否します。また、発行されてからまだ1分半しか経っていない Cookie も受け付けません。サーバーは起動時に Cookie を取得し、バックグラウンドで有効になるのを待ってから保存し、以降の実行でも再利用します。Cookie なしで動作するエンドポイント（Trending Now、フィード、検索）は、その Cookie を待ちません。
• リクエストの間隔を調整します。 リクエストの間隔はデフォルトで1.5秒、チャートでは2秒、特に繊細なエンドポイントである関連検索のリクエスト同士では6秒です。拒否された場合は、5分間、間隔をさらに広げます。
• 再試行してから、しばらく停止します。 実際にレート制限が発生した場合は、待ち時間を延ばしながら数回再試行します。それでも解消しない場合は、ブロックを悪化させないよう、そのエンドポイントグループへのリクエストを数分間停止します。他のグループは引き続き動作します。
• フォールバック付きのキャッシュを使用します。 すべての回答を保存します。同じ質問を2回しても、リクエストは1回だけです。Google に拒否された場合は、古い回答をその経過時間とともに表示します。
• 設計段階からリクエストを減らしています。 1回のチャートリクエストで5つの語句を扱えます。同じ質問に対する2回目のチャートでは、1回目のトークンを再利用します。
• 時間の上限を設けています。 クライアントを待たせ続けるのではなく、取得済みの情報と不足している情報を示して、時間の上限内にツール呼び出しの結果を返します。

check_endpoints（または gtrends-mcp-full doctor）を実行すると、各エンドポイントが応答するか、また、失敗がレート制限、エンドポイントの変更、ネットワークのどれによるものかをいつでも確認できます。

FAQ

これは Google Trends の公式 API ですか？ いいえ。Google は 2025 年に公式 API を発表しましたが、承認されたテスター向けのクローズドアルファ版です。このサーバーは Trends のウェブサイトの背後で使われているエンドポイントを使用しており、キーは不要です。これらのエンドポイントは文書化されておらず、変更されることがあります。変更があった場合は、check_endpoints がどのエンドポイントかを示し、パッケージを更新すれば修正されます。

Google アカウントは必要ですか？ いいえ。1 つのツールである related_topics は、匿名セッションでは空のリストを返します。Google がこの情報を提供しないためです。その旨も通知します。ログイン済みの Cookie を指定すると利用できるようになりますが、それ以外はすべて指定なしで動作します。

検索ボリュームを取得できますか？ Trending Now では、2K+、200K+ のような区分で実際のボリュームを確認できます。それ以外はすべて相対的な関心度を示す 0～100 の指数です。これを偽って示すツールはありません。

同じ内容を 2 回尋ねたら、数値が 1 ポイント変わりました。 Google Trends は検索のサンプルから算出されるため、リクエストを繰り返すとわずかに異なる場合があります。キャッシュの有効期間内は、同じ回答が返されます。

ツールに Google によるレート制限中だと表示されます。 数分お待ちください。キャッシュされた回答は引き続き利用できます。頻繁に発生する場合は、キーワードごとに 1 回ずつ呼び出すのではなく、複数のキーワードを 1 回の呼び出しで指定するか、GTRENDS_MIN_INTERVAL の値を大きくするか、GTRENDS_PROXY を設定してください。

ツールにセッションの検証中だと表示されます。 初回起動後の最初の 90 秒間はその状態になります。その間も Trending ツールは動作し、この状態が再び発生することはありません。セッションは保存されるためです。

人口の少ない国が人口の多い国より上位になるのはなぜですか？ 指数はその場所での検索数ではなく、その場所における全検索に占める割合だからです。

データはどこに保存されますか？ お使いのマシン上の 1 つの SQLite ファイル（~/.config/gtrends-mcp-full/trends.sqlite）に保存されます。保存されるのは、キャッシュされた回答、保存した Trending Now のスナップショット、ウォッチリストです。Google Trends へのリクエスト以外に、データが外部へ送信されることはありません。

開発

uv venv && uv pip install -e ".[dev]"
uv run pytest              # no network needed: the tools run against a fake Google Trends
uv run ruff check src tests
python scripts/gen_tools_doc.py   # after changing a tool's signature or docstring
python scripts/record_fixtures.py # re-record the real answers the contract tests replay (about 15 requests to Google)

CONTRIBUTING.md と CHANGELOG.md をご覧ください。

関連項目

• gsc-mcp-full — Google Search Console 用の関連 MCP サーバーです。37 個のツール、すべての API エンドポイント、1 時間単位のデータ、16 か月を超える期間の履歴を利用できます。

ライセンス

MIT。Google との提携関係はなく、Google による承認も受けていません。Google Trends は Google LLC の商標です。Google Trends のデータの使用には、Google の利用規約が適用されます。