trenddata

trenddata

trenddata は、Google Trends のデータを JSON として返す、ホスト型 HasData Google Trends MCP サーバーへの小規模なローカルブリッジです。1 つ以上の検索語を渡すと、 それらの語について、時間の経過に伴う関心度、地域別の関心度、関連トピック、関連クエリを 取得します。検索対象は、地域、地域の粒度（国、地方、都市圏、または市区町村）、期間、 カテゴリ、タイムゾーンのオフセット、Google プロパティ（デフォルトはウェブ検索。画像、 ニュース、ショッピング、または YouTube も指定可能）で絞り込めます。

このブリッジは、独自のトレンドデータを保存しません。稼働中のエンドポイントから取得した とおりに、上流サーバーのツール一覧をローカルで提供し、各ツール呼び出しを上流に転送して、 結果を変更せずに返します。取得されたインターフェースは読み取り専用のフェッチ機能 1 つだけで、 書き込み、メッセージング、決済のツールは含まれていません。

ツール

• hasdata_google_trends_search_getTrendsData — クエリに対する Google Trends データを取得します。必須：q（検索語）。省略可能：geo（地域コード。未設定または空の場合は全世界）、region（country / region / dma / city。地域別関心度のデータタイプで使用）、dataType（timeseries / geoMap / relatedTopics / relatedQueries）、tz（分単位のタイムゾーンオフセット。デフォルトは 420）、cat（カテゴリコード。すべてのカテゴリを表すデフォルト値は 0）、gprop（images / news / froogle / youtube。未設定の場合はウェブ検索）、date（today 12-m や all などの名前付き期間、または yyyy-mm-dd yyyy-mm-dd 形式のカスタム期間）。時間経過に伴う関心度の系列、地域レベルの内訳、スコアを相対値で示した上昇中および人気の関連トピックとクエリを返します。

設定

• HASDATA_GOOGLE_TRENDS_MCP_URL（省略可能）— 上流エンドポイントを上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=google_trends です。 （この上書き用フックは、この再構築版独自のラベル付き再現です。）
• HASDATA_API_KEY（省略可能）— 設定すると、呼び出し元自身の HasData API キーとして、すべての上流リクエストに x-api-key: <key> ヘッダーが付加されます。未設定の場合、キーのヘッダーは送信されません。（ヘッダー名と環境変数名は、元のレジストリレコードに基づいています。この環境変数からキーを転送する機能はラベル付き再現です。元のインターフェースはキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流サーバーとのストリーム可能な HTTP セッションを開始します。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name trenddata）を送り、次に notifications/initialized 通知を送り、その後、呼び出し元の引数を 変更せずに含めた tools/call リクエストを送信します。上流サーバーが initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、その値は セッションの後続リクエストすべてに含まれ、プロセスが終了するまで同じセッションが 再利用されます。応答はプレーンな JSON またはサーバー送信イベントとして届く場合があり、 どちらも読み取られます。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま渡されます。 JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、完了できないリクエストなどの 失敗は、テキストが trenddata error: で始まる isError 結果として返されます （このエラー表示は、この再構築版独自のラベル付き再現です）。

CLI

このツールは、JSON 引数文字列を 1 つ受け取るサブコマンドとしても実行できます。

npx @reneturcios/trenddata hasdata_google_trends_search_getTrendsData '{"q":"electric vehicles","geo":"US","dataType":"timeseries","date":"today 12-m"}'
npx @reneturcios/trenddata --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/trenddata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "trenddata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/trenddata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/trenddata
docker run --rm ghcr.io/cloudcorprecords/trenddata --version

コンテナのデフォルトコマンドは mcp なので、最初の形式では stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC 上流サーバーに対して実行されます。稼働中のネットワークへの呼び出しはありません。

ライセンス

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