GSC & Bing Webmaster MCP — No API Keys for Google

gsc-bing-mcp

一个 MCP（Model Context Protocol）服务，可让 AI Agent（Claude、Cline）直接访问你的 Google Search Console 和 Bing Webmaster Tools 搜索表现数据。

Google 无需 API 密钥——使用你现有的 Chrome 浏览器会话。
Bing 只需 30 秒即可完成设置——从控制台复制一个免费的密钥即可。

v0.2.1——共 23 个工具（11 个 GSC + 11 个 Bing + 1 个实用工具）

---

✨ 功能

Google Search Console 工具（11 个）

工具	说明
gsc_list_sites	列出所有已验证的 GSC 资源
gsc_performance_trend	每日点击量、展示量、CTR 和排名趋势
gsc_top_queries	按点击量排序的热门搜索查询
gsc_top_pages	按点击量排序的热门落地页
gsc_search_analytics	按查询、页面、国家或设备分组的分析数据
gsc_site_summary	覆盖范围和索引概况
gsc_list_sitemaps	已提交的网站地图及其状态和错误数量
gsc_insights	Search Console 通知和提示
gsc_all_queries	从效果页面 HTML 获取的所有查询（绕过分页）
gsc_index_coverage	详细的索引覆盖统计数据
gsc_query_pages	查询与页面的关联数据

Bing Webmaster Tools（11 个）

工具	说明
bing_list_sites	列出所有 Bing Webmaster 资源
bing_search_analytics	每日展示量、点击量和排名
bing_keyword_stats	按点击量排序的热门关键词
bing_crawl_stats	抓取统计数据、错误和被屏蔽的 URL
bing_url_info	URL 的抓取日期、HTTP 状态和索引信息
bing_page_stats	展示量和点击量最高的页面
bing_submit_url	向 Bing 提交单个 URL 以供索引
bing_submit_url_batch	一次批量向 Bing 提交多个 URL
bing_crawl_issues	Bing 遇到的抓取错误和问题
bing_url_submission_quota	每日剩余的 URL 提交配额
bing_link_counts	Bing 发现的入站链接数量

实用工具（1 个）

工具	说明
refresh_google_session	强制刷新缓存的 Chrome Cookie

---

🔐 身份验证机制

Google Search Console——无需设置

此服务会直接从磁盘读取 Chrome 浏览器的 Cookie，原理与 yt-dlp 和 ytmusicapi 等工具相同。

1. 登录 Google 后，Chrome 会保存会话 Cookie
2. 此服务使用 rookiepy（一个基于 Rust、极其轻量的库）读取这些 Cookie
3. 计算 SAPISIDHASH 授权标头（SHA1(timestamp + SAPISID + origin)）
4. 向 GSC 的内部 API 发送请求——使用的端点与你的浏览器完全相同

**要求：**只需在 Chrome 中登录 Google。就这么简单。Chrome 无需保持运行。

多浏览器支持

服务会按以下优先级自动检测浏览器：Chrome → Brave → Edge

可通过环境变量覆盖：

BROWSER=brave           # force a specific browser
CHROME_PROFILE=/path    # override the profile directory path

Bing Webmaster Tools——免费 API 密钥

Bing 会在你的账户中提供一个免费且永不过期的 API 密钥：

1. 前往 bing.com/webmasters
2. 点击 Settings → API Access
3. 点击 Generate API Key
4. 复制密钥并将其粘贴到 MCP 配置中（见下方设置说明）

---

🚀 安装与设置

先决条件

• 已登录 Google 账户的 Chrome（或 Brave/Edge）浏览器
• Python 3.11+ 或 uv（推荐——无需管理 Python）

---

选项 A：使用 uvx 安装（推荐 — 无需配置 Python）

步骤 1：安装 uv（一次性操作，约 10 秒）

# macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

步骤 2：获取 Bing API 密钥（2 分钟）

1. 前往 bing.com/webmasters → Settings → API Access
2. 点击 Generate API Key 并复制密钥

步骤 3：添加到 MCP 配置中（30 秒）

对于 Cline（VS Code），打开 MCP 设置并添加：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "uvx",
      "args": ["gsc-bing-mcp"],
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

对于 Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "uvx",
      "args": ["gsc-bing-mcp"],
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

**步骤 4：完成！**重启 Cline/Claude Desktop，然后开始提问。

---

选项 B：使用 pip 安装

pip install gsc-bing-mcp

然后在 MCP 配置中添加：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "gsc-bing-mcp",
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

---

选项 C：从源代码运行（开发者）

git clone https://github.com/codermillat/gsc-bing-mcp
cd gsc-bing-mcp
pip install -e .

MCP 配置：

{
  "mcpServers": {
    "gsc-bing-mcp": {
      "command": "python",
      "args": ["-m", "gsc_bing_mcp.server"],
      "env": {
        "BING_API_KEY": "paste-your-bing-key-here"
      }
    }
  }
}

---

可选环境变量

变量	描述
BING_API_KEY	你的 Bing Webmaster API 密钥（Bing 工具所必需）
BROWSER	指定浏览器：chrome、brave 或 edge
CHROME_PROFILE	覆盖 Chrome 配置文件目录路径

---

💬 可提问示例

"What are my top 10 search queries in GSC for the last 30 days?"
"Show me the daily click trend for my site this month"
"Which pages are getting the most impressions on Google?"
"What's my average position for 'python tutorial' in Search Console?"
"List all my verified sites in Google Search Console"
"Give me all search queries for my site — not just the top 25"
"Show index coverage issues — how many pages are excluded?"
"Are there any sitemap errors on my site?"
"What are my top Bing keywords this month?"
"Show me Bing crawl errors for my site"
"Submit https://example.com/new-post to Bing for indexing"
"How many inbound links has Bing found for my site?"
"Compare my GSC vs Bing clicks for site:example.com"
"Which queries are sending traffic to which pages on my site?"

---

🛠️ 工具参考

Google Search Console 工具

gsc_list_sites

列出 GSC 账户中所有已验证的网站资源，包括资源类型（Domain 或 URL prefix）。

• 无需参数

---

gsc_performance_trend

每日效果趋势数据（点击次数、展示次数、CTR、排名）。这是最可靠的 GSC 工具，可返回清晰、结构化的每日数据。

• site_url — 例如，"https://example.com/" 或 "sc-domain:example.com"
• search_type — "WEB"（默认）、"IMAGE"、"VIDEO"、"NEWS"
• start_date （可选） — "YYYY-MM-DD"（默认：约 17 天前）
• end_date （可选） — "YYYY-MM-DD"（默认：约 3 天前，因 GSC 数据延迟）

---

gsc_top_queries

按点击次数列出热门查询。设置 limit=0 可返回所有可用查询。

• site_url — 你的网站
• limit — 查询数量（默认：25，使用 0 可返回全部）
• search_type — "WEB"（默认）、"IMAGE"、"VIDEO"、"NEWS"
• start_date、end_date （可选） — 日期范围

---

gsc_top_pages

按点击次数列出热门页面。设置 limit=0 可返回所有页面。

• 参数与 gsc_top_queries 相同

---

gsc_search_analytics

按单个维度分组的搜索分析数据。

• site_url — 你的网站
• dimension — "query"（默认）、"page"、"country" 或 "device"
• search_type — "WEB"（默认）、"IMAGE"、"VIDEO"、"NEWS"
• start_date、end_date （可选） — 日期范围

---

gsc_site_summary

GSC 网站资源的覆盖率和索引摘要（已编入索引的页面、错误、警告、已排除的 URL）。

• site_url — 你的网站

---

gsc_list_sitemaps

列出所有已提交的网站地图，以及其状态、提交数量、已编入索引的数量和错误数量。

• site_url — 你的网站

---

gsc_insights

Search Console 洞察和通知（品牌查询趋势、筛选器提醒、提示信息）。

• site_url — 你的网站

---

gsc_all_queries

通过抓取效果页面 HTML，从 GSC 提取所有搜索查询。绕过 RPC 分页限制，可返回比 gsc_top_queries 多得多的查询。

• site_url — 你的网站
• search_type — "WEB"（默认）、"IMAGE"、"VIDEO"、"NEWS"

---

gsc_index_coverage

详细的索引覆盖率统计（已编入索引的页面、错误、警告，以及按类别划分的已排除 URL）。

• site_url — 你的网站

---

gsc_query_pages

查询与页面的关联数据 — 显示哪些页面针对哪些查询排名，以及点击次数、展示次数、CTR 和排名。

• site_url — 你的网站
• search_type — "WEB"（默认）、"IMAGE"、"VIDEO"、"NEWS"
• limit — 最大行数（默认：50，使用 0 可返回全部）

---

Bing Webmaster Tools

bing_list_sites

列出 Bing Webmaster 账户中的所有网站/资源。

• 无需参数

---

bing_search_analytics

Bing 每日搜索表现（展示次数、点击次数、平均点击位置）。

• site_url — 网站在 Bing Webmaster Tools 中显示的网址
• start_date — "YYYY-MM-DD"
• end_date — "YYYY-MM-DD"
• limit — 最大行数（默认：100）

---

bing_keyword_stats

来自 Bing 的流量主要关键词，按点击次数排序。

• site_url、start_date、end_date、limit

---

bing_crawl_stats

抓取统计信息，包括错误、被阻止的网址、DNS／连接问题。

• site_url

---

bing_url_info

特定网址的详细信息（抓取日期、HTTP 状态、是否已编入索引）。

• site_url — Bing Webmaster Tools 中的网站
• page_url — 要检查的具体网址

---

bing_page_stats

展示次数、点击次数和平均点击位置排名靠前的网页。

• site_url
• limit — 最大网页数（默认：100）

---

bing_submit_url

向 Bing 提交单个网址以供编入索引。请先使用 bing_url_submission_quota 检查配额。

• site_url
• url — 要提交的网页网址

---

bing_submit_url_batch

通过单个批量请求向 Bing 提交多个网址。

• site_url
• urls — 以逗号分隔的网址列表

---

bing_crawl_issues

Bing 遇到的抓取问题和错误（HTTP 错误、DNS、robots.txt 阻止等）。

• site_url

---

bing_url_submission_quota

查看每日剩余网址提交配额。

• site_url

---

bing_link_counts

Bing 发现的指向你网站的入站链接数量。

• site_url

---

实用工具

refresh_google_session

强制刷新缓存的 Chrome Cookie。如果你最近重新登录了 Google，且工具无法正常工作，请使用此工具。

• 无需参数

---

⚠️ 故障排除

“未找到 Google 会话 Cookie”

• 确保你已在 Chrome 中登录 Google
• 打开 Chrome，访问 google.com，如有需要请登录
• 调用 refresh_google_session，然后重试

“Chrome 的 Cookie 数据库已锁定”

• Chrome 可能正在写入数据库。请等待几秒后重试。
• 在 macOS 上，这种情况有时会在 Chrome 刚打开或关闭后发生。

“读取 Chrome Cookie 时权限被拒绝”（macOS）

• 为终端或 IDE 授予“完全磁盘访问权限”：
  • 系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加 Terminal / VS Code

“未设置 BING_API_KEY 环境变量”

• 将 "BING_API_KEY" 添加到 MCP 配置的 env 部分
• 更新配置后，重启 Cline/Claude Desktop

GSC 数据显示“未找到数据”

• GSC 数据通常延迟约 2–3 天 — 请将 end_date 设为至少 3 天前
• 确认 site_url 与 GSC 中显示的网址完全一致（包括末尾的斜杠）

使用 Brave 或 Edge，而不是 Chrome？

• 在 MCP 配置的 env 部分设置 BROWSER=brave 或 BROWSER=edge

---

📦 依赖项

软件包	用途	大小
mcp	MCP 协议服务（FastMCP）	~5MB
rookiepy	Chrome/Brave/Edge Cookie 读取器（基于 Rust）	~2MB
httpx	异步 HTTP 客户端	~3MB

安装后总计：约 10MB，运行时 RAM 占用约 15MB

不使用 Playwright。不需要 Chrome 二进制文件。不进行浏览器自动化。

---

🔒 隐私与安全

• 所有数据均保留在本地 — 此服务在你的机器上运行，并直接从你的计算机发起 API 调用
• 不会向任何第三方发送数据 — 你的 Cookie 和搜索数据绝不会离开你的机器
• Cookie 只读 — 此服务只读取 Cookie，不会修改它们
• 不记录敏感数据 — 绝不会记录 Cookie 值

---

📡 如何发布更新（开发者）

# Edit version in pyproject.toml and gsc_bing_mcp/__init__.py, then:
pip install build twine
python -m build
twine upload dist/*

用户下次运行 uvx 时会自动获取更新。

---

📝 许可证

MIT — 可免费用于个人和商业用途。