MCP Search Console

io.github.Ayo-Fam由 GitHub 账号 Ayo-Fam 发布v0.1.3更新于 Nov 3, 2026

Multi-account Google Search Console MCP: analytics, URL inspection, sitemaps across named accounts.

已验证STDIO仅桌面效率与工作流网页搜索与抓取数据与分析

概览

AI 生成的概览

多账号 Google Search Console MCP 服务器，可按命名账号查询搜索分析、检查网址并管理站点地图。

可以做什么
  • 列出已配置账号、切换默认账号并刷新认证
  • 查看可访问的资源及其权限
  • 查询搜索表现数据，包括时段对比、高级查询和按页面细分
  • 单个或批量检查网址、排查索引问题，并列出或获取站点地图
  • 在启用破坏性操作开关后提交或删除站点地图
适用场景
适合管理多个 Search Console 资源或客户账号、希望在一个助手会话中查询搜索表现与索引数据而无需重启服务器的场景。可用于 SEO 报表、索引问题排查和站点地图维护。
运行要求
以本地 Python 包形式运行，通过 pip 安装（或用 uvx 启动）。需要 accounts 配置文件，路径由环境变量 GSC_ACCOUNTS_CONFIG 指定，默认位于 ~/.config/mcp-search-console/accounts.json，其中按账号保存 Google OAuth 或服务账号凭据。需要访问 Google Search Console API 的网络连接。
安装前请注意
accounts 配置文件保存所有已配置账号的 Google OAuth 或服务账号凭据，需妥善保护。提交和删除站点地图会改动线上 Search Console 数据，仅在 GSC_ALLOW_DESTRUCTIVE 设为 true 时可用。该包为 beta 版本。搜索数据会与 Google API 之间传输。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MCP Search Console，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-search-console

Multi-account Google Search Console MCP server for operators who need one MCP surface across multiple sites or clients without restarting the server.

Release posture: beta package, version 0.1.3 from pyproject.toml.

Choose your path

You are...Start hereThen
Connecting the server to Claude/Codex/Cursordocs/start-here.mdQuick start below
Auditing account routing or destructive guardsdocs/architecture.mdgsc/server.py
Reviewing packaging or registry metadatapyproject.tomlserver.json

Architecture

mermaid
flowchart TD  U[AI operator] --> C[MCP client]  C --> S[FastMCP server]  S --> M[Account manager]  M --> F[Accounts config]  M --> A[OAuth or service-account auth]  S --> R[Retry wrapper]  R --> G[Google Search Console API]  G --> R --> S

Request flow

mermaid
flowchart TD  P[Operator asks for analytics or indexing data] --> T[Selected MCP tool]  T --> A[Resolve named or default account]  A --> B[Build authenticated GSC client]  B --> C[Call Search Console endpoint]  C --> D{API call succeeds?}  D -- yes --> E[Return normalized JSON]  D -- retryable --> F[Backoff and retry]  F --> D  D -- no --> G[Return error payload]

Quick start

  1. Install the package.
bash
python -m pip install mcp-search-console-multi
  1. Create the accounts config.
bash
mkdir -p ~/.config/mcp-search-consolecp accounts.example.json ~/.config/mcp-search-console/accounts.json
  1. Register it in your MCP client.
json
{  "mcpServers": {    "search-console": {      "command": "uvx",      "args": ["mcp-search-console-multi"],      "env": {        "GSC_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-search-console/accounts.json"      }    }  }}

Available tools

Tool groupToolsPurpose
Account routinglist_accounts, set_default_account, reauthenticateInspect accounts, switch defaults, refresh auth
Property inventorylist_properties, get_site_detailsDiscover accessible properties and permissions
Search analyticsget_search_analytics, get_performance_overview, compare_periods, get_advanced_search_analytics, get_search_by_pageQuery search-performance data
Inspection and sitemapsinspect_url, batch_inspect_urls, check_indexing_issues, list_sitemaps, get_sitemap, submit_sitemap, delete_sitemapInspect indexing and manage sitemap submissions

submit_sitemap and delete_sitemap stay behind the destructive flag documented in docs/start-here.md.

Runtime proof

ClaimProof
Package entry point is stablemcp-search-console-multi = "gsc.server:main" in pyproject.toml
Multi-account routing is first-classAccountManager() and _get_manager() in gsc/server.py
Search Console calls are retriedwith_retry() in gsc/server.py and gsc/retry.py
Auth is file-driven per accountaccounts.example.json and gsc/accounts.py

Repo map

PathPurpose
gsc/server.pyFastMCP tool surface and response normalization
gsc/accounts.pyAccount config, auth loading, client construction
gsc/auth/OAuth and service-account auth implementations
gsc/retry.pyRetry behavior for transient API failures
docs/start-here.mdSetup, env, validation, common failures
docs/architecture.mdComponent map and runtime lifecycle

Validation

CheckCommand
Import compilespython -m compileall gsc
Package buildspython -m build
README/docs links stay localrg '\\]\\(([^)]+\\.md)\\)' README.md docs/

License

MIT

Project context for new tasks

Use INDEX.md to find task-specific contracts; consult prompt.md when product direction is relevant. Historical examples do not select the current task.

来源：README.md，提交 624bba9

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分