bingdata

bingdata

bingdata 是一个小型本地桥接程序，可连接托管的 HasData Bing MCP 服务，并以 JSON 返回 Bing 搜索结果。提供查询后，它会获取该查询的 Bing SERP：自然搜索结果及其标题、链接、摘要和排名位置、相关搜索，以及上游返回的广告区块和 Copilot 回答。搜索可按自由文本地点或经纬度进行本地化，也可通过市场、国家/地区、界面语言、安全搜索级别、时间 筛选条件、设备类型和页面偏移量来调整。

该桥接程序不会存储任何搜索结果。它会在本地提供上游服务的工具列表，该列表与从实时端点捕获的内容完全一致；并将每次 工具调用转发到上游，原样返回结果。捕获到的工具集只有一次只读获取操作： 其中没有写入、消息传递或支付工具。

工具

• hasdata_bing_serp_getSearchResults — 获取一份 Bing SERP。必填：q（搜索词）。可选： location（自由文本起始地点，会解析为坐标； 若同时提供 lat 和 lon，则忽略此项， 优先使用 lat 和 lon）、mkt（市场）、cc（国家/地区）、 setLang（界面语言）、safeSearch （off / moderate / strict）、filters（Bing 筛选表达式，包括过去一天/一周/一个月的日期筛选条件）、 deviceType（desktop / mobile / tablet）以及 first（分页的结果偏移量： 1 表示第一页，11 表示第二页，21 表示第三页）。 返回自然搜索结果（标题、url、摘要、显示的 url、排名位置）和相关搜索。

配置

• HASDATA_BING_MCP_URL（可选）— 覆盖 上游端点。默认为 https://mcp.hasdata.com/mcp?apis=bing。（此 覆盖钩子是本次重建自行标注的内容。）
• HASDATA_API_KEY（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，使用调用者自己的 HasData API 密钥。未设置时，不会发送密钥标头。（标头 名称和环境变量名称由原始版本的注册记录固定；从此环境 变量转发密钥是本次重建自行标注的内容——原始工具集是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo 名称为 bingdata），然后发送 notifications/initialized 通知，接着发送携带调用者参数原值的 tools/call 请求。上游在 initialize 响应中返回 Mcp-Session-Id 标头时，该值会附加到 此会话的后续每个请求中，并在进程的整个生命周期内复用。 响应可能是普通 JSON，也可能是服务器发送事件；两种格式都会读取。

上游的成功结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或 无法完成的请求——都会返回一个 isError 结果，其文本以 bingdata error: 开头（此呈现方式是本次重建自行标注的内容）。

CLI

该工具也可作为子命令使用，接收一个 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。