Gsc Bing MCP

gsc兵mcp

MCP（模型上下文协议）服务器，允许AI代理（Claude、Cline）直接访问您的 Google搜索控制台 和 Bing网站管理员工具 搜索性能数据。

Google的零API密钥 --使用您现有的Chrome浏览器会话。\ Bing的30秒设置 --只需从仪表板复制一个免费密钥。

v0.2.1 --总共23个工具（11个GSC+11个Bing+1个实用程序）

______________________________________________________________________

✨ 特性

谷歌搜索控制台工具（11）

Bing网站管理员工具（11）

公用事业（1）

______________________________________________________________________

🔐 身份验证的工作原理

谷歌搜索控制台——零设置

1. Chrome会在您登录谷歌后存储会话Cookie
2. 此服务器使用以下方式读取这些Cookie 菜鸟 （基于Rust的库，超轻量级）
3. 计算a SAPISIDHASH 授权标头(SHA1(timestamp + SAPISID + origin))
4. 向GSC的内部API发出请求-与浏览器使用的端点完全相同

要求： 只需在Chrome浏览器中登录谷歌即可。就是这样。Chrome不需要运行。

多浏览器支持

服务器按优先级顺序自动检测浏览器： 铬→ 勇敢→ Edge

用环境变量覆盖：

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

必应网络管理员工具-免费API密钥

必应从您的帐户提供一个免费的、永不过期的API密钥：

1. 首选 bing.com/网站管理员
2. 点击 设置→ API访问
3. 点击 生成API密钥
4. 复制密钥并将其粘贴到MCP配置中（请参阅下面的设置）

______________________________________________________________________

🚀 安装和设置

先决条件

• 已登录Google帐户的Chrome（或Brave/Edge）浏览器
• Python 3.11+ 或 紫外线 （推荐——不需要Python管理）

______________________________________________________________________

选项A：安装 uvx （推荐--零Python设置）

第一步：安装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/网站管理员 → 设置→ API访问
2. 点击 生成API密钥 并复制它

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

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

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

对于 克劳德桌面 (~/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"
      }
    }
  }
}

第四步：完成！ 重新启动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"
      }
    }
  }
}

______________________________________________________________________

可选环境变量

______________________________________________________________________

💬 你可以问的示例问题

"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?"

______________________________________________________________________

🛠️ 工具参考

谷歌搜索控制台工具

gsc_list_sites

列出GSC帐户中所有已验证的属性，包括属性类型（域与URL前缀）。

• 无需参数

______________________________________________________________________

gsc_performance_trend

每日绩效趋势数据（点击、展示、点击率、位置）。最可靠的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

查询到页面的相关性——显示哪些页面在哪些查询中排名，包括点击、展示、点击率和位置。

• site_url --您的网站
• search_type — "WEB" （默认）， "IMAGE", "VIDEO", "NEWS"
• limit --最大行数（默认值：50，使用 0 为所有人）

______________________________________________________________________

Bing网站管理员工具

bing_list_sites

列出Bing网站管理员帐户中的所有网站/属性。

• 无需参数

______________________________________________________________________

bing_search_analytics

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

• site_url --Bing网站管理员工具中显示的网站URL
• 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

爬网统计信息，包括错误、被阻止的URL、DNS/连接问题。

• site_url

______________________________________________________________________

bing_url_info

有关特定URL的详细信息（爬网日期、HTTP状态、索引状态）。

• site_url --Bing网站管理员工具中的网站
• page_url --要检查的特定URL

______________________________________________________________________

bing_page_stats

展示次数、点击次数和平均点击位置的首页。

• site_url
• limit --最大页数（默认值：100）

______________________________________________________________________

bing_submit_url

向Bing提交一个URL进行索引。先检查配额 bing_url_submission_quota.

• site_url
• url --要提交的页面URL

______________________________________________________________________

bing_submit_url_batch

在单个批处理请求中向Bing提交多个URL。

• site_url
• urls --逗号分隔的URL列表

______________________________________________________________________

bing_crawl_issues

Bing遇到的爬网问题和错误（HTTP错误、DNS、robots.txt块等）。

• site_url

______________________________________________________________________

bing_url_submission_quota

检查您剩余的每日URL提交配额。

• site_url

______________________________________________________________________

bing_link_counts

Bing为您的网站发现的入站链接计数。

• site_url

______________________________________________________________________

效用

refresh_google_session

强制刷新缓存的Chrome Cookie。如果您最近重新登录到Google并且工具出现故障，请使用。

• 无需参数

______________________________________________________________________

⚠️ 故障排除

“未找到Google会话Cookie”

• 确保您已在Chrome浏览器中登录谷歌
• 打开Chrome浏览器，访问google.com，必要时登录
• 呼叫 refresh_google_session，然后重试

“Chrome的cookie数据库已锁定”

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

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

• 授予对终端或IDE的全磁盘访问权限：

- 系统设置→ 隐私和安全→ 全磁盘访问 → 添加终端/VS代码

“未设置BING_API_KEY环境变量”

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

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

• GSC的数据延迟约为2-3天——使用 end_date 过去至少3天
• 验证 site_url 与GSC中显示的完全匹配（包括尾部斜线）

使用Brave还是Edge而不是Chrome？

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

______________________________________________________________________

📦 依赖项

总计：已安装约10MB，运行时约15MB RAM

没有剧作家。没有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 跑。

______________________________________________________________________

📝 许可证

麻省理工学院——个人和商业用途免费。