Google Search Console
English ↗

GSC CONNECT · 唯讀 MCP

你的搜尋數據，
交給熟悉的 Agent。

把 Google Search Console 帶進日常 Agent 工作。連接你自己的 Google 帳戶，以官方數據查閱查詢字詞、頁面表現與索引狀態。

Google OAuthGoogle 官方 API5 個唯讀工具

選擇連接方式

從你正在用的客戶端開始。

相容客戶端可使用同一個 MCP 地址；新增服務、瀏覽器授權與工具載入方式由各客戶端處理。

Codex

Codex

原生 MCP + 插件

透過原生 MCP 與 OAuth 連接，或安裝內附 GSC Skill 的完整 Codex 插件。

查看連接步驟
Claude Code

Claude Code

遠端 HTTP + OAuth

使用 Claude Code 的 HTTP MCP 連接，再從 /mcp 完成 Google 授權。

查看連接步驟
DeepSeek Harness

DeepSeek Harness

需要 OAuth 客戶端

使用支援 OAuth 的 MCP 客戶端或適配器。只有 URL 和 Headers 的設定，不能完成本服務的 Google 登入。

查看連接步驟

客戶端名稱及標識用於辨識相關產品，不代表其擁有者為本服務背書。

下載 · 0.2.2

連接器、Skill，按需要選擇。

Codex Plugin · 0.2.2

Codex 連接器套件

本地 marketplace 內含遠端 MCP 設定、GSC Skill、圖示，以及英文和繁體中文使用說明。

下載插件 ZIP ↓
Agent Skill · 0.2.2

獨立 GSC Skill

為支援 Skills 的 Agent 加入 GSC 操作與重連指引。讀取私人資料仍需支援 OAuth 的 MCP 連接。

下載 Skill ZIP ↓

下載包不含憑據或服務端原始碼。沿用此端點的現有安裝，亦可使用遠端服務更新。

完整安裝與升級說明 ↗SHA-256 檢查碼 ↗

使用方法

連接、選擇網站，再提出問題。

連接類型選 Remote HTTP 或 Streamable HTTP。Bearer Token、自訂 Headers、OAuth Client ID、Client Secret 及 Resource 保持空白，讓客戶端完成 OAuth 流程。

Server URLhttps://gsc.yusihk.com/mcp
01

在 Codex 連接服務

使用套件時，解壓並保留隱藏的 .agents 資料夾，在桌面 Codex 開啟解壓後的資料夾，從 GSC Connect 本地來源安裝 Google Search Console Connect。完成連接後開一個新聊天。

亦可在支援以下命令的 Codex CLI 新增遠端服務：

codex mcp add google-search-console --url https://gsc.yusihk.com/mcp
codex mcp login google-search-console

按提示完成 Google 登入。若已設定這個服務，使用它的「重新連接」功能即可，毋須重複新增。

客戶端官方說明 ↗
02

在 Claude Code 連接服務

新增遠端 HTTP 服務後，在 Claude Code 輸入 /mcp，按瀏覽器提示完成授權。

claude mcp add --transport http google-search-console https://gsc.yusihk.com/mcp

/mcp

選擇已有 Search Console 網站權限的 Google 帳戶。這些命令適用於 Claude Code；其他 Claude 客戶端有各自的連接器介面。

客戶端官方說明 ↗
03

在 DeepSeek Harness 連接服務

先選用支援瀏覽器 OAuth、PKCE 及客戶端註冊的 MCP 客戶端插件。下方官方 bridge 文件列出的 URL 與 Headers 設定，本身不能完成此服務的 OAuth 登入。

  1. 在支援 OAuth 的 MCP 客戶端新增遠端 HTTP 服務，名稱填 google-search-console。
  2. 伺服器網址填 https://gsc.yusihk.com/mcp，認證選 OAuth／瀏覽器授權。
  3. 完成 Google 授權、啟用工具，再要求列出可存取的 Search Console 網站。

可先核對官方 MCP bridge 文件，或自行評估 dsh-mcp-manager 等社群 OAuth 客戶端。社群插件與本站提供的 Codex ZIP 是不同套件。

官方 MCP bridge ↗社群 OAuth 客戶端 ↗

五個工具，清楚的使用界線。

gsc_list_sites

列出網站資源與權限級別。

gsc_site_overview

按網站與日期範圍總結搜尋成效。

gsc_query_search_analytics

查閱查詢字詞、頁面、裝置、國家或地區及日期。

gsc_list_sitemaps

讀取已提交 Sitemap 的處理狀態。

gsc_inspect_url

查閱 Google 已知的索引版本，並非即時網址測試。

接下來可以這樣問。

自己的帳戶，唯讀的權限。

Google 授權範圍為 webmasters.readonly。服務不能修改網站資源、提交或刪除 Sitemap、要求索引、轉移擁有權或取得 Google 密碼。Search Analytics 可能只傳回熱門資料列，並省略部分低量查詢。

連接需要處理時。

身份驗證過期？

一般令牌過期會先嘗試刷新。Google 拒絕已儲存的授權時，使用這個 MCP 服務的「重新連接」，完成 Google 授權後再要求列出網站清單；提示時機由客戶端決定。

已連接，但沒有工具？

查看客戶端的 MCP 狀態；若它需要新聊天才能載入剛連接的工具，請建立新聊天。安裝插件、Google 授權及成功讀取資料是不同步驟。

找不到某個網站？

使用本身已有該 Search Console 網站權限的 Google 帳戶。重複授權不會自動取得新的網站權限。

網絡錯誤或限流？

待連接恢復或重試間隔過後再試。服務端設定錯誤及暫時故障，不能靠反覆 Google 授權解決。