返回市场
必应网管MCP服务器

必应网管MCP服务器

作者:isiahw16 星标更新:2025-11-06

项目介绍

技术文档摘要

MCP Server for Bing Webmaster Tools

npm 版本 许可证: MIT Python Node

这是一个 MCP(模型上下文协议)服务器,通过 Claude 和其他兼容 MCP 的 AI 助手提供对 Bing Webmaster Tools 功能的访问。

🚀 快速开始

对于 Claude Code 用户:

# 使用您的 API 密钥添加 MCP 服务器
claude mcp add bing-webmaster -e BING_WEBMASTER_API_KEY=your_api_key_here -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# 启动 Claude Code
claude

对于 Claude Desktop 用户:

在配置中添加(设置 → 开发者 → 编辑配置):

{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

从 Bing Webmaster Tools 获取您的 API 密钥 → 设置 → API 访问

目录

功能

  • 🚀 直接 API 集成: 简单可靠的访问 Bing Webmaster Tools
  • 📊 全面的功能: 网站管理、流量分析、爬取数据等
  • 🛡️ 错误处理: 健壮的错误处理和详细的日志记录
  • 🎯 MCP 兼容性: 完全兼容 Model Context Protocol
  • 📈 丰富的功能: URL 提交、关键词分析、站点地图管理等

安装

先决条件

  • Node.js 16+(用于 npm/npx)
  • Python 3.10+(通过 npm 自动安装)
  • Bing Webmaster API 密钥 (获取您的 API 密钥)

快速开始

最简单的方式是通过 npx 使用此 MCP 服务器(无需安装):

npx @isiahw1/mcp-server-bing-webmaster@latest

全局安装(可选)

npm install -g @isiahw1/mcp-server-bing-webmaster

开发安装

对于贡献者和开发者:

git clone https://github.com/isiahw1/mcp-server-bing-webmaster.git
cd mcp-server-b
uv pip install -e .

配置

1. 获取您的 Bing Webmaster API 密钥

  1. 登录到 Bing Webmaster Tools
  2. 转到 设置 → API 访问
  3. 生成您的 API 密钥

2. 客户端设置说明

<details> <summary><b>Claude Code (命令行)</b></summary>

选项 1: 快速设置(推荐)

# 使用内联 API 密钥添加 MCP 服务器
claude mcp add bing-webmaster -e BING_WEBMASTER_API_KEY=your_api_key_here -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# 启动 Claude Code
claude

选项 2: 使用系统环境变量

# 设置您的 API 密钥
export BING_WEBMASTER_API_KEY="your_api_key_here"

# 添加 MCP 服务器
claude mcp add bing-webmaster -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# 启动 Claude Code
claude

选项 3: 使用环境文件

# 创建 .env 文件
echo "BING_WEBMASTER_API_KEY=your_api_key_here" > .env

# 添加 MCP 服务器
claude mcp add bing-webmaster -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# 启动 Claude Code
claude

故障排除

如果遇到问题,请使用调试模式运行:

claude --mcp-debug
</details> <details> <summary><b>Claude Desktop</b></summary>
  1. 打开 Claude Desktop
  2. 转到 Claude → 设置
  3. 从侧边栏选择 开发者
  4. 点击 编辑配置
  5. 在您的配置中添加以下内容:
{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. 保存文件并重新启动 Claude Desktop

配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
</details> <details> <summary><b>Cursor</b></summary>
  1. 启动 Cursor
  2. 打开 Cursor → 设置 → Cursor 设置
  3. 在左侧边栏选择 MCP
  4. 点击 添加新的全局 MCP 服务器
  5. 粘贴以下配置:
{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. 重启 Cursor
</details> <details> <summary><b>Windsurf</b></summary>
  1. 打开 Windsurf
  2. 导航至 设置 → MCP 配置
  3. 添加以下配置:
{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. 重启 Windsurf
</details> <details> <summary><b>开发环境设置(本地安装)</b></summary>

对于源代码工作的开发者:

# 克隆仓库
git clone https://github.com/isiahw1/mcp-server-bing-webmaster.git
cd mcp-server-bing-webmaster

# 安装 uv(如果尚未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装依赖项
uv pip install -e .

Claude Desktop 开发配置

{
  "mcpServers": {
    "bing-webmaster-dev": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_server_bwt"],
      "cwd": "/path/to/mcp-server-bing-webmaster",
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code 开发配置

# 设置环境变量
export BING_WEBMASTER_API_KEY="your_api_key_here"

# 从项目目录运行
cd /path/to/mcp-server-bing-webmaster
claude mcp add bing-webmaster-dev -- uv run python -m mcp_server_bwt
</details>

3. 验证安装

配置完成后,您应该能够:

  • 在您的 MCP 服务器列表中看到 "bing-webmaster"
  • 使用如 "显示我在 Bing Webmaster Tools 中的所有站点" 等命令
  • 访问所有 Bing Webmaster Tools 功能

故障排除

“无法连接到 MCP 服务器” 错误:

  1. 检查您的 API 密钥是否正确
  2. 确保您有互联网连接
  3. 对于 Claude Desktop: 检查设置 → 开发者 → 打开日志文件夹中的日志
  4. 对于 Claude Code: 使用 claude --mcp-debug 运行

“spawn mcp-server-bing-webmaster ENOENT” 错误:

  • 确保您使用的是 npx 命令,而不是 mcp-server-bing-webmaster
  • 如果您有旧的全局安装,请卸载它:npm uninstall -g @isiahw1/mcp-server-bing-webmaster

可用工具

网站管理

  • get_sites - 列出账户中所有已验证的网站
  • add_site - 将新网站添加到 Bing Webmaster Tools
  • verify_site - 验证网站所有权
  • remove_site - 从账户中移除网站
  • get_site_roles - 获取具有网站访问权限的用户列表
  • add_site_roles - 授予其他用户网站访问权限

流量分析

  • get_query_stats - 获取搜索查询性能数据
  • get_page_stats - 获取页面级别的流量统计信息
  • get_rank_and_traffic_stats - 获取整体排名和流量数据
  • get_query_page_stats - 获取特定查询的详细流量统计信息
  • get_query_page_detail_stats - 获取特定查询-页面组合的统计数据
  • get_url_traffic_info - 获取特定 URL 的流量信息

爬取与索引

  • get_crawl_stats - 查看爬取统计信息和机器人活动
  • get_crawl_issues - 获取爬取错误和问题
  • get_crawl_settings - 获取网站的爬取设置
  • update_crawl_settings - 更新爬取设置(慢/正常/快)
  • get_url_info - 获取特定 URL 的详细索引信息

URL 管理

  • submit_url - 提交单个 URL 以供索引
  • submit_url_batch - 一次性提交多个 URL
  • get_url_submission_quota - 检查您的 URL 提交限制

内容提交

  • submit_content - 直接提交页面内容而无需爬取
  • get_content_submission_quota - 获取内容提交配额信息

站点地图与订阅源

  • submit_sitemap - 提交新的站点地图
  • remove_sitemap - 移除站点地图
  • get_feeds - 获取站点的所有 RSS/Atom 订阅源

关键词分析

  • get_keyword_data - 获取特定关键词的详细数据
  • get_related_keywords - 查找相关的搜索词
  • get_keyword_stats - 获取特定关键词的历史统计数据

链接分析

  • get_link_counts - 获取入站链接统计信息
  • get_url_links - 获取特定站点 URL 的入站链接(需要链接和页面参数)
  • add_connected_page - 添加一个指向您网站的页面

内容屏蔽

  • get_blocked_urls - 查看被屏蔽的 URL
  • add_blocked_url - 屏蔽 URL 不进行爬取
  • remove_blocked_url - 解除 URL 屏蔽

深度链接管理

  • get_deep_link_blocks - 获取被屏蔽的深度链接列表
  • add_deep_link_block - 屏蔽特定 URL 模式的深度链接
  • remove_deep_link_block - 移除深度链接屏蔽

URL 参数

  • get_query_parameters - 获取 URL 规范化参数(可能需要特殊权限)
  • add_query_parameter - 添加 URL 规范化参数
  • remove_query_parameter - 移除 URL 规范化参数

地理设置

  • get_country_region_settings - 获取国家/地区定位设置(可能需要特殊权限)
  • add_country_region_settings - 添加国家/地区定位设置
  • remove_country_region_settings- 移除国家/地区定位设置

页面预览管理

  • add_page_preview_block - 添加页面预览屏蔽以防止富摘要
  • get_active_page_preview_blocks - 获取活跃的页面预览屏蔽列表
  • remove_page_preview_block - 移除页面预览屏蔽

网站迁移

  • get_site_moves - 获取网站移动/迁移历史
  • submit_site_move - 提交网站移动/迁移通知

子 URL 管理

  • get_children_url_info - 获取父 URL 下子 URL 的信息
  • get_children_url_traffic_info - 获取子 URL 的流量信息

使用示例

配置完成后,您可以在 Claude 中使用这些工具:

基本示例

"显示我在 Bing Webmaster Tools 中的所有已验证站点"
"example.com 的顶级搜索查询是什么?"
"提交 https://example.com/new-page 以供索引"
"显示我的网站的爬取错误"
"我的每日 URL 提交限额是多少?"

高级示例

"获取查询 '最佳产品' 在我网站上的详细统计数据"
"直接为此 HTML 内容提交 https://example.com/page"
"显示我前 10 页的流量信息"
"将 user@example.com 添加为我网站的管理员"
"屏蔽匹配 /temp/* 模式的所有 URL"
"获取关键词 'SEO 工具' 的历史数据"
"将爬取速度设置为慢速以供我的网站"
"获取与 '营销' 相关的关键词建议"

开发

设置开发环境

# 克隆仓库
git clone https://github.com/isiahw1/mcp-server-bing-webmaster.git
cd mcp-server-bing-webmaster

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate

# 以开发模式安装
pip install -e .

运行测试

# 设置您的 API 密钥
export BING_WEBMASTER_API_KEY=your_api_key_here

# 运行服务器
python -m mcp_server_bwt

贡献

欢迎贡献!请随时提交 Pull Request。

许可证

MIT 许可证 - 详情见 LICENSE 文件。

支持

有关问题、疑问或贡献,请访问: https://github.com/isiahw1/mcp-server-bing-webmaster