mcp-google-trends-scraper

Google Trends Scraper MCP Server

Apify 上の Mamba Labs Google Trends Scraper アクター用の MCP サーバーです。検索語句の Google Trends データを取得し、語句ごとのサマリー行とフラットな詳細行を返します。

内容

• 機能
• クイックスタート
• 前提条件
• プロンプトの例
• ツール
• 入力
• 料金
• アクターの全ドキュメント
• ライセンス

機能

検索語句を指定します。必要に応じて、地域、期間、カテゴリ、検索対象も指定できます。語句ごとに、サマリー行（平均、最新、ピーク時の関心度、直近の変化、上位地域、上位および急上昇中の検索語句）と、時間の経過に伴う関心度、地域、関連する検索語句のフラットな行が返されます。語句は5件ずつのグループにまとめ、同じ尺度で比較できます。値はグラフを基準とした相対値であり、検索数ではありません。

すべての処理は Apify 上で実行されます。このパッケージは、アクターの実行を開始し、完了を待って、データセットの行を返す薄いクライアントです。

クイックスタート

Node.js 18 以降と、API トークンを持つ Apify アカウントが必要です。

Claude Desktop の設定（claude_desktop_config.json）、Cursor、または任意の MCP クライアントに以下を追加します。

{
  "mcpServers": {
    "mamba-google-trends-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-google-trends-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

クライアントを再起動すると、get_google_trends ツールが表示されます。

前提条件

• Node.js 18 以降。
• console.apify.com/account/integrations で取得した Apify API トークンを APIFY_TOKEN として設定します。サーバーはトークンがなくてもツールを一覧表示しますが、呼び出しにはトークンが必要です。

プロンプトの例

• 「過去12か月で、米国における抹茶への関心はどのように変化しましたか？」
• 「米国の都市圏ごとに、コーヒーと紅茶を比較してください。」
• 「オゼンピックに関連して急上昇している検索語句は何ですか？」

ツール

get_google_trends。ツールは1つです。引数の例：

{
  "terms": [
    "coffee",
    "matcha"
  ],
  "geo": "US",
  "timeframe": "today 12-m"
}

入力

アクターで購入者向けに設定できるすべての入力です。省略された入力には、アクター独自のデフォルト値が適用されます。

入力	型	必須	説明
terms	array	いいえ	検索語句。1回の実行につき最大200件です。/m/0j6n6s8 などの Google トピック ID も使用できます。
geo	string	いいえ	世界全体の場合は空欄にします。または、US、DE、US-CA などの Google 地域コードを指定します。
timeframe	string	いいえ	now 1-H、now 4-H、now 1-d、now 7-d、today 1-m、today 3-m、today 12-m、today 5-y、all、または YYYY-MM-DD YYYY-MM-DD 形式の2つの日付。
category	string	いいえ	Google Trends のカテゴリ番号。0 はすべてのカテゴリです。番号は Trends URL の cat= 部分にあります。
property	string	いいえ	読み取る Google 検索の種類：web、news、images、youtube、shopping。
compare	boolean	いいえ	true：語句を5件ずつのグループにまとめ、共通の尺度でグラフ化します。false：語句ごとに独立したグラフを作成します。どちらの場合も、語句ごとに料金が発生します。
outputs	array	いいえ	interest_over_time、interest_by_region、related_queries、related_topics のいずれかです。デフォルトは最初の3つです。related_topics については「制限事項」を参照してください。
region_resolution	string	いいえ	auto：世界全体では国、国内では地域です。DMA は米国の都市圏です。CITY には geo の指定が必要です。COUNTRY では geo を空欄にする必要があります。
max_charge_usd	string	いいえ	任意です。実行料金がこの金額を超える課金が発生する前に、実行を停止します。サマリー行は常に返されます。
proxy_mode	string	いいえ	auto（デフォルト）：リクエストは Apify のプロキシプール経由で送信され、プールを通過できなかったリクエストは住宅用 IP アドレスで再試行されます。residential：すべてのリクエストに住宅用 IP アドレスを使用します。信頼性に関する設定であり、料金には影響しません。

料金

Apify ではイベントごとに課金され、Apify アカウントに請求されます。価格は USD です。

イベント	無料プラン	Bronze	Silver	Gold
term-report、データがある検索語 1 件、サマリー行と最大 170 件の詳細行	$0.0065	$0.006175	$0.00585	$0.005525
extra-rows、1 件の検索語で最初の 170 件を超える、追加の詳細行 100 件ごと	$0.0035	$0.003325	$0.00315	$0.002975
apify-actor-start、実行開始 1 回あたり	$0.002	$0.002	$0.002	$0.002

データがない検索語、Google が拒否した検索語、拒否された入力は無料です。Apify プロキシの通信料を含め、実行にかかるプラットフォーム費用は Mamba Labs が負担します。

Actor の完全なドキュメント

apify.com/mambalabs/google-trends-scraper

ライセンス

MIT。LICENSE を参照してください。