Google Search Console MCP

io.github.surendranb由 GitHub 帳號 surendranb 發布v0.10.10更新於 Nov 3, 2026

Google Search Console MCP: search performance analytics, rankings, sitemaps, and indexing health.

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

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理查詢 Google Search Console 搜尋成效資料、管理網站地圖，並使用 SEO 分析手冊。

可以做什麼
  • 列出已驗證的 Search Console 資源及其權限層級
  • 查詢可用維度與指標，再依查詢字詞、頁面、國家、裝置或日期取得點擊、曝光、點閱率與平均排名
  • 列出、提交與刪除該資源的 XML 網站地圖
  • 列出並讀取內建 SEO 分析手冊，取得欄位組合與結果解讀方式
  • 檢查 PyPI 新版本，並以互動方式修復憑證或資源設定錯誤
適用情境
適合讓助理不必離開對話就能取得並解讀自有網站的自然搜尋成效、檢查網站地圖，或依結構化 SEO 手冊進行分析。
執行需求
以本機 Python 套件執行（uvx 或 npx 包裝）。需要 Google Cloud 服務帳戶 JSON 金鑰檔，透過 GOOGLE_APPLICATION_CREDENTIALS 提供絕對路徑，並設定網站網址（GSC_SITE_URL），且該帳戶須有該資源的存取權。需要連線至 Google API 的網路。
安裝前請注意
服務帳戶金鑰檔可存取你的 Search Console 資料，請妥善保管。提交與刪除網站地圖的工具會變更線上資源設定。README 指出此套件會傳送匿名診斷遙測，除非設定 DO_NOT_TRACK 或 MCP_TELEMETRY_OPT_OUT。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

Google Search Console (GSC) MCP Server 🔍

Model Context Protocol (MCP) server for Google Search Console: search performance analytics, keyword rankings, sitemap inspection, and indexing health for AI agents.

[CI] [PyPI version] [npm version] [OpenSSF Scorecard] [License: MIT]

🌐 Live Documentation & Web Portal: https://gsc.builditwithai.xyz

⚡ Quickstart

bash
# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)curl -fsSL "https://gsc.builditwithai.xyz/install" | bash
# Or run directly via your preferred runtime:uvx google-search-console-mcpnpx -y @surendranb/google-search-console-mcp

🤖 Client Setup

A. Claude Code (CLI)

bash
claude mcp add google-search-console -- uvx google-search-console-mcp

B. Cursor & Google Antigravity (mcp.json)

json
{  "mcpServers": {    "google-search-console": {      "command": "uvx",      "args": ["google-search-console-mcp"]    }  }}

C. Claude Desktop (claude_desktop_config.json)

json
{  "mcpServers": {    "google-search-console": {      "command": "uvx",      "args": ["google-search-console-mcp"],      "env": {        "GSC_SITE_URL": "https://example.com/",        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"      }    }  }}

D. VS Code (Cline / Roo Code / Continue)

json
{  "mcpServers": {    "google-search-console": {      "command": "npx",      "args": ["-y", "@surendranb/google-search-console-mcp"]    }  }}

🛠️ Tools & Capabilities

Tool NameParametersDescriptionReturn Type
get_search_analyticssite_url (string), start_date (string), end_date (string), dimensions (list), row_limit (int)Queries organic search clicks, impressions, CTR, and average position grouped by query, page, country, device, and date.JSON / Markdown
list_sites(none)Lists all verified web properties in Google Search Console with permission levels.JSON
inspect_urlsite_url (string), inspection_url (string)Real-time URL inspection for index status, crawl issues, canonicalization, and mobile usability.JSON
list_sitemapssite_url (string)Retrieves all submitted XML sitemaps, last download date, and indexed URL counts.JSON
submit_sitemapsite_url (string), feedpath (string)Submits a new XML sitemap directly to Google Search Console.JSON
delete_sitemapsite_url (string), feedpath (string)Removes an obsolete or incorrect sitemap from Search Console.JSON
skill_readskill_name (string)Loads expert SEO diagnostic playbooks dynamically from GitHub.Markdown
skills_list(none)Lists all available live GSC analytical skills.JSON

🔒 Telemetry & Privacy

This package collects anonymous, non-PII diagnostic telemetry (command executions, latency, error codes) to improve tool reliability. No queries, user credentials, personal data, source code, or environment variables are ever collected or stored.

You can opt out anytime by setting either of the following environment variables:

bash
export DO_NOT_TRACK=1# orexport MCP_TELEMETRY_OPT_OUT=1

📄 License

MIT License. See LICENSE for details.

來源：README.md，提交 96dfd0b

工具

12

list_gsc_sites

List all sites verified in Google Search Console. Returns: List of verified sites with their permission levels.

無需輸入參數。

list_sites

List all sites verified in Google Search Console (alias for list_gsc_sites). Returns: List of verified sites with their permission levels.

無需輸入參數。

list_available_dimensions

List all available GSC dimensions with their descriptions. Returns: List of dimension objects with api_name and description.

無需輸入參數。

list_available_metrics

List all available GSC metrics with their descriptions. Returns: List of metric objects with api_name and description.

無需輸入參數。

skills_list

List available analytical skills (playbooks) for Google Search Console. Use this to learn proven field combinations and how to interpret GSC data for specific SEO tasks. Fetch the full playbook with skill_read.

無需輸入參數。

skill_read

Fetch the full content of one analytical skill (playbook) for Google Search Console. Args: skill_id: The skill id from skills_list (e.g., "brand_visibility.md") Returns: The full skill content with title, description, and playbook steps.

輸入參數skill_id必填

get_search_analytics

Retrieve Google Search Console search analytics data. Args: dimensions: List of dimensions from: country, device, page, query, searchAppearance, date start_date: Start date in YYYY-MM-DD format (defaults to 30 days ago) end_date: End date in YYYY-MM-DD format (defaults to 3 days ago) filters: List of filter objects (e.g., [{"dimension": "country", "operator": "equals", "expression": "usa"}]) search_type: Type of search ('web', 'image', 'video', 'news', 'discover', 'googleNews') row_limit: Maximum number of rows to return (max 25000) start_row: Starting row for pagination (0-based) summary_only: If True, returns only aggregated totals (Token Efficient) intent: Short plain-English description of what the user is trying to learn/accomplish. E.g. "which queries drive clicks to the pricing page", "mobile vs desktop performance last month". Returns: Dictionary containing search analytics data with clicks, impressions, ctr, and position metrics.

輸入參數intentfiltersend_daterow_limitstart_rowdimensionsstart_datesearch_typesummary_only

get_sitemaps

Get all sitemaps for the configured site. Returns: List of sitemaps with their status and details.

無需輸入參數。

submit_sitemap

Submit a sitemap to Google Search Console. Args: sitemap_url: Full URL of the sitemap to submit Returns: Success message or error details.

輸入參數sitemap_url必填

delete_sitemap

Delete a sitemap from Google Search Console. Args: sitemap_url: Full URL of the sitemap to delete Returns: Success message or error details.

輸入參數sitemap_url必填

check_for_updates

Check PyPI for newer versions of this MCP server and get upgrade instructions.

無需輸入參數。

setup_gsc_access

Interactively fix a broken Google Search Console MCP setup (missing or wrong credentials path, missing GSC_SITE_URL, invalid key, or missing property access) by asking the user for the needed value through the client, then re-initializing without a restart. Call this whenever a configuration or authentication error is reported.

無需輸入參數。

版本歷史

1
  1. v0.10.10最新Oct 29, 2026

評分

已滿足適用檢查項的 90%

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

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

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

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分