bingdata

bingdata

bingdata は、ホスト型の HasData Bing MCP サーバーへの小さなローカルブリッジです。Bing の検索結果を JSON として返します。クエリを渡すと、そのクエリの Bing SERP を取得します。SERP には、タイトル、リンク、 スニペット、順位を含むオーガニック検索結果、関連検索、そして — 上流から返されるままの — 広告ブロックと Copilot の回答が含まれます。検索は、自由形式の場所または緯度／経度でローカライズでき、市場、 国、インターフェース言語、セーフサーチレベル、期間 フィルター、デバイスの種類、ページオフセットで調整できます。

このブリッジは検索結果を保存しません。ライブエンドポイントから取得したとおりに、上流 サーバーのツール一覧をローカルで提供し、各 ツール呼び出しを上流に転送して、結果を変更せずに返します。 取得した範囲は、読み取り専用の単一の取得処理です。 書き込み、メッセージング、支払いのツールは含まれていません。

ツール

• hasdata_bing_serp_getSearchResults — Bing SERP を 1 件 取得します。必須：q（検索語）。任意： location（自由形式の検索元。座標に変換されます。 lat と lon の両方が指定された場合は無視され、 lat と lon が優先されます）、mkt（市場）、cc（国）、 setLang（インターフェース言語）、safeSearch （off／moderate／strict）、filters（Bing のフィルター式。過去 1 日／1 週間／1 か月の 期間フィルターを含みます）、deviceType（desktop／mobile／ tablet）、first（ページ送り用の結果オフセット： 1 は 1 ページ目、11 は 2 ページ目、21 は 3 ページ目）。 オーガニック検索結果（タイトル、url、スニペット、 表示 URL、順位）と関連検索を返します。

設定

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

転送の仕組み

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

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

CLI

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

npx @reneturcios/bingdata hasdata_bing_serp_getSearchResults '{"q":"best coffee in san francisco","location":"San Francisco, California","mkt":"en-us","safeSearch":"moderate"}'
npx @reneturcios/bingdata --version

終了コード：成功時は 0、isError の 結果の場合は 1、使用方法のエラーの場合は 2 です。

MCP サーバー

npx -y @reneturcios/bingdata mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

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

ライセンス

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