Google Search Console MCP

io.scalably由 scalably.io 發布v1.0.1更新於 Oct 24, 2026

Read-only Google Search Console MCP: Search Analytics, sitemaps, URL inspection. 5 tools.

已驗證STDIO僅桌面網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

在本機執行的唯讀 MCP 伺服器，讓助理查詢 Google Search Console 的資源、搜尋分析、網站地圖和網址索引狀態。

可以做什麼
列出服務帳戶可讀取的 Search Console 資源，並列出某資源的網站地圖或讀取單一網站地圖。依篩選條件查詢搜尋分析資料，支援每小時資料與超過 25,000 列上限的自動分頁。檢查單一網址的索引狀態，或以用戶端限流方式批次檢查多個網址。所有工具都回傳含狀態、摘要、結果、佐證與警告的結構化 JSON，部分結果會指出續查位置。
適用情境
適合 SEO 與網站營運情境，讓助理直接取得 Google Search Console 的搜尋成效、網站地圖與索引資料，不必手動匯出。適用於唯讀的報表與診斷，而非在 Search Console 中進行修改。
執行需求
透過 stdio 在本機執行，可用 uvx 從 PyPI 套件安裝，或使用 Claude Desktop 的 .mcpb 套件。需要一個已啟用 Search Console API 的 Google Cloud 專案與服務帳戶 JSON 金鑰，其路徑由 GOOGLE_APPLICATION_CREDENTIALS 指定。每個要查詢的 Search Console 資源都須共用給該服務帳戶電子郵件。選用變數可設定記錄層級、重試退避與 API 基礎網址。
安裝前請注意
需要 Google 服務帳戶私密金鑰檔案，應妥善保護，正常使用時切勿設定僅供測試的 GSC_TEST_ACCESS_TOKEN。存取為唯讀，但將資源共用給服務帳戶即代表該資源資料可被助理讀取。網址檢查有配額限制（每資源每分鐘 600 次、每天 2,000 次），且伺服器不跨呼叫統計每日用量，須自行計數。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Google Search Console MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Google Search Console MCP

Read-only MCP server for Google Search Console. Five tools cover the read surface: properties, Search Analytics (filters, auto-pagination past the 25,000-row cap, hourly data), sitemaps, URL inspection, batch inspection with throttling. We run this server in production for every SEO client.

Install

Claude Code:

bash
claude mcp add gsc -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json -- uvx scalably-gsc-mcp

Codex:

bash
codex mcp add gsc --env GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json -- uvx scalably-gsc-mcp

Claude Desktop: download gsc-mcp.mcpb from the latest GitHub release and open it.

Setup

  1. In Google Cloud, create or pick a project and enable the Google Search Console API on it (APIs and Services, Library).
  2. Create a service account in that project and download its JSON key.
  3. Add the service account's email as a user on each Search Console property you want to query (Settings, Users and permissions). Full or restricted permission both work for reading.

No OAuth consent screen is needed; the server authenticates as the service account with the webmasters.readonly scope.

Tools (5)

ToolWhat it does
gsc_list_sitesList the Search Console properties the service account can read
gsc_query_search_analyticsQuery Search Analytics with filters, auto-pagination and hourly data
gsc_list_sitemapsList sitemaps for a property or read one sitemap
gsc_inspect_urlInspect one URL's index status
gsc_batch_inspect_urlsInspect many URLs with client-side throttling

Configuration

VariableRequiredPurpose
GOOGLE_APPLICATION_CREDENTIALSyesPath to a Google service-account JSON file with the Search Console read-only scope; share each property with the service account email
GSC_LOG_LEVELnoINFO (default) or DEBUG
GSC_RETRY_BASE_SECONDSnoBase delay in seconds for the retry backoff on transient API errors (default 1)
GSC_WEBMASTERS_BASE, GSC_SEARCHCONSOLE_BASEnoOverride the two Google API base URLs (used by the test suite to point at a local fake; leave unset in normal use)
GSC_TEST_ACCESS_TOKENnoTest-suite only: a literal bearer token that bypasses the service account. Never set it in normal use

Reply shape

Every tool returns JSON with status (succeeded, partial, no_op), operation, summary, target, result, proof, warnings, recovery. Failures surface as a tool error whose text is <code>: <message> <hint>. A partial status with proof.nextStartRow means: continue from that row.

Limits

25,000 rows per Search Analytics call (the server auto-paginates past it up to max_rows). URL inspection: Google allows 600 per minute and 2,000 per day per property. The server paces batch inspection client-side (default 8 requests per second) and warns when a batch exceeds the daily quota; it does not track daily usage across calls, so keep your own count.

Verify

Each release lists the package version, the .mcpb sha256 and the production commit it was derived from in CHANGELOG.md. CI runs the tests and a clean install of the built wheel on every push.

Privacy Policy

This server runs locally, on your machine, under your own credentials. It collects no personal data, contains no telemetry, stores nothing persistently, and talks only to the vendor API it wraps. No third party, including Scalably, receives your data. Contact: [email protected]. Canonical copy: https://scalably.io/connector-privacy.html

License

MIT. Copyright Scalably.

來源：README.md，提交 357b2eb

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分