/ 目錄 / 演練場 / mcp-gsc
● 社群 AminForou ⚡ 即開即用

mcp-gsc

作者 AminForou · AminForou/mcp-gsc

將 Google Search Console 資料引入 Claude — 20 個搜尋分析、URL 檢查、Sitemap 工具。完美適合 SEO 診斷和報告。

mcp-gsc (AminForou) 把 Google Search Console 連接到 AI 助手。20 個工具涵蓋屬性管理、搜尋分析(含篩選/比較)、URL 檢查(索引狀態)和 Sitemap 提交/監控。透過 OAuth(個人)或服務帳戶(團隊)認證。

為什麼要用

核心特性

即時演示

實際使用效果

gsc.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gsc",
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "gsc": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-gsc"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add gsc -- uvx mcp-gsc

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: mcp-gsc

用 mcp-gsc 產生週報 SEO 報告

👤 SEO 經理、內容團隊 ⏱ ~15 min beginner

何時使用: 週一早上 — 你想在站會前看到上週的效能摘要。

前置條件
  • Google Search Console 存取權限 — search.google.com/search-console
  • OAuth 憑證或服務帳戶 — console.cloud.google.com — 啟用 Search Console API
步驟
  1. 拉取熱搜關鍵字 + 變化幅度
    針對 acme.com,上週與前週的前 20 個關鍵字。顯示點擊次數、CTR、排名變化幅度。✓ 已複製
    → 變化幅度表格
  2. 拉取最佳著陸頁面變動
    點擊次數變化最大(上升或下降)的前 10 個頁面。✓ 已複製
    → 贏家 + 落敗者清單
  3. 起草摘要
    為團隊會議撰寫 5 點摘要,針對最大落敗者提出行動項目。✓ 已複製
    → 可直接貼上的報告

結果: 10 分鐘內完成週一報告。

搭配使用: google-sheets

稽核你網站的索引問題

👤 技術 SEO ⏱ ~30 min intermediate

何時使用: 流量下降,你想知道 Google 是否還在索引應有的內容。

步驟
  1. 抽樣頂級頁面
    從上月前 50 個著陸頁面,透過 inspect_url_enhanced 檢查每個 URL 的索引狀態。✓ 已複製
    → 每個 URL 的狀態:已索引/已爬蟲但未索引/已排除
  2. 問題分類
    按問題類型分類。對於「已爬蟲但未索引」,常見模式是什麼?✓ 已複製
    → 按群集診斷

結果: 與真實 GSC 判定相關聯的優先修正清單。

驗證 Sitemap 健康狀態和提交狀況

👤 任何發佈新頁面的人 ⏱ ~10 min beginner

何時使用: 你剛發佈新頁面 — 檢查 Google 是否已挑選 Sitemap。

步驟
  1. 列出 Sitemap
    acme.com 的 get_sitemaps。顯示最後讀取日期和錯誤計數。✓ 已複製
    → Sitemap 健康清單
  2. 重新提交過時的
    7 天內未被讀取的 Sitemap,重新提交。✓ 已複製
    → 已提交

結果: 確信 Google 看到新內容。

從 GSC 挖掘排名機會

👤 成長階段 SEO ⏱ ~40 min intermediate

何時使用: 你想要排名 11-20 且接近首頁的查詢。

步驟
  1. 找到接近成功的查詢
    過去 90 天內,平均排名介於 11-20 之間且超過 100 次展示的查詢。返回與著陸頁面。✓ 已複製
    → 目標清單
  2. 按努力優先排序
    針對前 20 名,檢查著陸頁面 — 它是否已針對查詢進行優化?如果沒有,建議頁面內優化。✓ 已複製
    → 努力加權的機會清單

結果: 基於你真實 GSC 資料的優先 SEO 待辦事項。

搭配使用: firecrawl

組合

與其他 MCP 搭配,撬動十倍槓桿

自動化週報 SEO 報告直接放入共享工作表

每個週一,執行我的週報 SEO 報告,並附加到「SEO Weekly」工作表。✓ 已複製
gsc + firecrawl

爬蟲排名在你目標查詢中的競爭對手頁面

針對 GSC 中每個接近成功的查詢,找到頂級 SERP 頁面(透過 firecrawl),並總結為什麼他們的排名比我高。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
list_properties 發現你有權限存取哪些內容 1 個 API 呼叫
get_search_analytics site, start_date, end_date, dimensions[], filters?, row_limit? 主力查詢工具 1 個 API 呼叫
inspect_url_enhanced site, url 逐 URL 索引除錯 1 個 API 呼叫
get_sitemaps site Sitemap 健康狀態 1 個 API 呼叫
submit_sitemap site, feedpath 促使 Google 重新爬蟲 1 個 API 呼叫

成本與限制

運行它的成本

API 配額
GSC API:每個專案 1200 QPM、每個網站 6000 QPD
每次呼叫 Token 數
分析結果每次呼叫最多 25k 行 — 傾倒前分塊
費用
免費
提示
使用 row_limit 和篩選;傾倒前 10k 個查詢會毀掉代理的上下文

安全

權限、密鑰、影響範圍

最小權限: https://www.googleapis.com/auth/webmasters.readonly
憑證儲存: 環境變數中的 GSC_OAUTH_CLIENT_SECRETS_FILE 或 GSC_CREDENTIALS_PATH
資料出站: searchconsole.googleapis.com
切勿授予: webmasters(完整存取)

故障排查

常見錯誤與修復

403 使用者沒有權限

OAuth 帳戶或服務帳戶必須是該屬性在 GSC 中的驗證使用者。在「設定」→「使用者」中新增

空的分析回應

GSC 有 2-3 天的資料延遲;end_date > 今天 - 3 可能是空的。另外:「Web」與「Discover」搜尋類型不同

OAuth 流程循環

client_secrets.json 中的重新導向 URI 必須完全相符(包括 http://localhost 連接埠)

替代方案

mcp-gsc 對比其他方案

替代方案何時用它替代權衡
GSC 網路介面臨時手動工作無自動化、無報告循環
Ahrefs/SEMrush APIs你想要第三方排名追蹤,而不是 Google 自己的資料付費;資料集不同

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills