使用说明

项目简介

本项目 'mcp-server-bwt' 是一个 MCP (Model Context Protocol) 服务器，旨在将 Bing 站长工具 (Bing Webmaster Tools) 的强大功能桥接到支持 MCP 协议的 AI 助手（如 Claude、Cursor 等）。通过此服务器，用户可以直接在 AI 助手中使用自然语言指令，即可完成 Bing 站长工具的各项操作，例如查询站点数据、提交 URL、分析关键词等，极大地提升了 SEO 工作流的智能化水平。

主要功能点

站点管理: 管理您的 Bing 站长工具账户中的站点，包括列出站点、添加站点、验证站点、删除站点、管理站点角色、站点移动等。
URL 提交: 向 Bing 提交 URL 以进行索引，支持单个 URL、批量 URL、内容提交、Feed 提交等多种方式，并可查询提交配额。
流量分析: 获取网站的搜索查询统计、页面统计、关键词统计、排名和流量统计等，帮助您深入了解网站的 SEO 表现。
抓取管理: 查看网站的抓取统计信息、抓取设置、抓取问题等，优化网站的抓取和索引。
关键词分析: 获取关键词信息和统计数据，发现相关关键词，辅助关键词策略制定。
链接分析: 分析网站的链接情况，包括链接计数、URL 链接、深层链接等，优化网站的内链外链结构。
内容管理: 获取 URL 信息、流量信息、子 URL 信息等，方便内容管理和优化。
内容屏蔽: 管理被屏蔽的 URL 和页面预览块。
区域设置: 管理国家/地区设置。
URL 参数管理: 管理 URL 查询参数。

总而言之，本项目将 Bing 站长工具几乎所有功能都以 MCP 工具的形式暴露出来，用户可以通过 AI 助手方便地调用这些工具，实现各种 SEO 相关任务。

安装步骤

安装 Python 3.13 及以上版本 和 Node.js。请确保您的系统满足这些环境要求。
安装项目依赖: 在项目根目录下，打开终端并运行以下命令：
```
make install
```
这将安装项目所需的 Python 依赖包。

服务器配置

要将 'mcp-server-bwt' 服务器配置到 MCP 客户端（例如 Claude 或 Cursor），您需要在客户端的 MCP 服务器设置中添加如下配置信息。请根据您的实际安装路径进行调整：

{
  "mcpServers": {
    "bwtServer": {  // 服务器名称，可以自定义
      "command": "/PATH/TO/mcp-server-bwt/.venv/bin/python",  // Python 解释器路径，请替换为您的项目虚拟环境中的 Python 路径
      "args": ["/PATH/TO/mcp-server-bwt/mcp_server_bwt/main.py"], // 服务器启动脚本路径，请替换为您的项目 main.py 文件的路径
      "env": {
        "BING_WEBMASTER_API_KEY": "YOUR_API_KEY_HERE"  // Bing 站长工具 API 密钥，请替换为您自己的 API 密钥
      }
    }
  }
}

请务必替换以下占位符：

'/PATH/TO/mcp-server-bwt': 替换为 'mcp-server-bwt' 仓库在您本地的实际路径。
'YOUR_API_KEY_HERE': 替换为您在 Bing 站长工具中获取的 API 密钥。

基本使用方法

启动 MCP 服务器: 在项目根目录下，打开终端并运行以下命令启动服务器：
```
make start
```
服务器默认使用 'stdio' 传输协议，并在后台运行。
在 AI 助手中使用: 在 Claude 或 Cursor 等支持 MCP 协议的 AI 助手中，配置好上述服务器信息后，即可直接使用自然语言指令与 Bing 站长工具进行交互。例如：
- "列出我在 Bing 站长工具中验证的所有站点"
- "提交我的首页进行索引"
- "获取我网站的流量统计数据"
- "检查我的站点是否存在抓取问题"
- "获取关键词 '我的产品' 的统计数据"
AI 助手会自动识别您的指令，并调用 'mcp-server-bwt' 服务器提供的相应 MCP 工具来执行操作并返回结果。

开发者信息

您可以使用 'make test', 'make build', 'make lint', 'make format' 等命令进行开发、测试和代码质量检查。详细信息请参考仓库 README 文档。