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 分