bing-webmaster-mcp

bing-webmaster-mcp 为 AI 代理提供对 Bing 所掌握的关于你的网站的信息的只读访问——流量、索引、抓取问题、入站链接、关键词——并为那些会改变的变更操作提供一条经过检审、分两步走的路径。

它附带了一个针对 JSON Bing Webmaster Tools API 的 Python 3.12+ CLI 和 MCP 服务器，并提供了协议正确的 IndexNow 提交支持。SOAP 与 POX 被刻意排除在外。

为什么写入路径分成两步

读取工具会立即执行。每次变更 Bing 状态的操作都会先创建一个持久的计划：

$ bing-wm plan submit-url example.com https://example.com/new-page --json
{
  "plan_id": "…",
  "summary": "submit url https://example.com/new-page for https://example.com",
  "apply_with": "bing-wm plan apply …"
}
$ bing-wm plan apply PLAN_ID
Apply this plan? [y/N]: y

在 MCP 上刻意不提供 apply 工具：一个代理能发送的确认，提示注入同样可以发送。一个同时也具有 shell 访问权限的 MCP 客户端依然可以调用 CLI；相应的补偿控制包括可读的托管计划、只能追加的审计跟踪、一次性执行、过期时间、站点拒绝名单，以及重启后依然有效的本地限额。

Related MCP server: bing-seo-mcp

安装

python -m pip install bing-webmaster-mcp

受支持的版本矩阵是 Python 3.12、3.13 和 3.14。开发与镜像均使用 constraints.txt 中的精确版本；发布后的依赖项保持兼容地基（版本下限）。

在 Bing Webmaster Tools 的“设置 → API 访问”中创建一个 API 密钥，并通过环境变量提供：

export BING_WM_API_KEY='…'
bing-wm sites list

切勿在仓库中放置真实密钥。所有设置请参阅配置。

MCP 客户端配置

使用 bing-webmaster-mcp 运行 stdio 服务器。把 MCP 客户端指向该可执行文件，并通过受保护的环境配置传入 BING_WM_API_KEY。该服务器暴露 34 个读取工具、针对每个受支持写入操作的规划工具，以及计划检查功能。它不暴露任何计划应用或拒绝工具。

此外还提供一个可选的 Streamable HTTP 入口：

export BING_WM_HTTP_BEARER_TOKEN='a-random-token-of-at-least-32-characters'
bing-webmaster-mcp-http

该入口拒绝非回环绑定地址和未认证请求。

常见问题

如何检查 Bing 是否定期收录了我的页面？

bing-wm index url example.com https://example.com/page

如何从命令行向 Bing 提交 URL？

从一个 URL 或一个以换行符分隔的文件创建计划，审查后执行：

bing-wm plan submit-url example.com https://example.com/page
bing-wm plan submit-urls example.com --file PATH
bing-wm plan show PLAN_ID
bing-wm plan apply PLAN_ID

规划器调用的是 GetUrlSubmissionQuota；没有硬编码任何配额数字。Bing 的方法文档还限制每次 SubmitUrlBatch 调用最多包含 500 个 URL。

IndexNow 对 Google 有效吗？

Google 不参与 IndexNow。实时的 IndexNow 注册表目前列出了 Bing、Yandex、Seznam、Naver、Yep、Internet Archive 和 Amazonbot。通过 api.indexnow.org 提交，会被推广到所有参与提交的引擎以及参与这些引擎的全网。

生成一个密钥，托管显示的 UTF-8 密钥文件，然后规划一次提交：

bing-wm indexnow key example.com
bing-wm plan indexnow example.com --file PATH --key KEY
bing-wm plan apply PLAN_ID

应用步骤在发送批次前，会检查密钥文件是否可以公开访问且包含该密钥。超过 10,000 个 URL 的批次，或位于授权主机或密钥子路径之外的 URL，都会在本地被拒绝。这里刻意没有未经验证的 2,048 个字符限制。

输出安全

锚文本、抓取问题 URL、标题、消息和查询字符串都可能被陌生人操控。共享的操作层会移除控制字符和双向格式化字符，提取极大的值进行截断，并以 {"value": "…", "untrusted": true} 形式返回这些值（而不是这些字段），并在开头补充了“untrusted”。消费方必须把它们当作数据，绝不能当作指令。

覆盖范围与参考

• CLI 命令、MCP 工具和写入操作

• 微软 62 个方法的完整转录

• 产品边界

• 配置

Microsoft 接口另有 3 个过时方法被刻意排除：这里支持其中 59 个；keyword 研究是独立提供的，因为其公开 API 签名不含站点参数；内容提交被包含，是因为它依旧存在于 Microsoft 当前接口中，账户侧的可用性只能由 Bing 针对具体账户确认。

License

MIT.