Orkas Orkas
首頁 博客 Google Search Console MCP
產品

Google Search Console MCP:三種設定方式,以及首次健檢

Google 沒有推出 Search Console MCP 伺服器,所以你得在社群伺服器、託管伺服器和內建連接器的應用程式之間做選擇。本文說明每種方式需要什麼、API 缺少哪些資料,以及一次你可以自行核對的首次健檢。

Google Search Console MCP 伺服器能讓 Claude、Claude Code、Codex 或 Cursor 等 AI 智慧代理存取 Search Console API。智慧代理可以取得你的點擊次數、曝光次數、點閱率和平均排名,檢查網頁是否已建立索引,並列出你的 Sitemap。你只要用平常說話的方式提問,例如「哪些網頁排在第一頁卻沒有點擊?」,智慧代理就會執行查詢,並逐列分析傳回的資料。本指南比較三種設定方式,說明 API 缺少哪些資料,並帶你完成一次能自己在 Search Console 中核對的首次健檢。

簡單來說:截至 2026 年 11 月 9 日,Google 沒有官方的 Search Console MCP 伺服器。Google 有為 Google Analytics 推出官方 MCP 伺服器,但 Claude 和 ChatGPT 的目錄中,都沒有 Google、Anthropic 或 OpenAI 提供的 Search Console 連接器。你的選擇有三種:自己執行的免費社群伺服器,需要建立 Google Cloud 專案;用 Google 帳戶登入的託管伺服器;或是內建連接器的應用程式,例如 Orkas,只要按「連線」即可。三者讀取的都是同一個 API,而這個 API 並不會列出所有查詢:Google 會略去匿名查詢,而在 Ahrefs 針對 887,534 個 Search Console 資源所做的研究中,匿名查詢佔了流量的 46.77%。

Search Console MCP 能做與不能做的事

所有 Search Console MCP 伺服器,無論是社群版還是商業版,呼叫的都是同一個免費的 Search Console API。它們能做什麼取決於這個 API,以下根據 Google 的 API 參考文件和用量限制整理。

你想要的資料API限制
依查詢、網頁、國家/地區、裝置、日期或搜尋外觀區分的點擊次數、曝光次數、CTR 和排名Search Analytics16 個月的歷史資料,約延遲 2–3 天;每次要求最多 25,000 列,每種搜尋類型每天 50,000 列
URL 是否已建立索引、上次檢索時間,以及 Google 選定的標準網址URL Inspection每次呼叫一個 URL;每個資源每天 2,000 次
你的 Sitemap 及其錯誤Sitemaps讀取只需唯讀權限;提交或刪除需要完整權限
你能查看的資源Sites新增或移除資源需要完整權限

Search Console 中有些功能沒有 API,因此任何 MCP 伺服器都拿不到:

  • AI 摘要和 AI 模式的資料。Google 已在 2026 年 8 月 31 日向所有網站推出生成式 AI 成效報告,但 API 參考文件中沒有對應的搜尋類型或搜尋外觀。
  • 較新的報表選項。多模態搜尋類型和品牌查詢篩選器,同樣不在 API 參考文件中。
  • 測試線上網頁。網址審查回報的是 Google 索引中的版本。API 文件寫道:「你無法測試線上 URL 是否可以建立索引。」
  • "Request indexing"(要求建立索引)按鈕。這個按鈕只存在於 Search Console 中。有些伺服器會呼叫 Google 另外提供的 Indexing API,但它官方上只適用於徵才資訊和直播網頁。

將 Search Console 連接到 Claude、Claude Code 或 Codex 的三種方式

方式設定資料流向費用
自行執行的社群伺服器,例如 mcp-gscGoogle Cloud 專案、API、憑證和一筆設定項目從你的電腦到 Google免費
託管伺服器,例如 mcpsearchconsole.com用 Google 登入,將伺服器 URL 貼到 AI 應用程式中經過供應商的伺服器有免費方案,之後需訂閱
Orkas 內建連接器按「連線」,用 Google 登入從你的電腦到 Google連接器免費
  • 社群伺服器免費,功能也最完整。最熱門的 AminForou/mcp-gsc 在 2026 年 11 月 9 日於 GitHub 上有 2,151 顆星。它的原始碼中有 21 個工具,包括期間比較、一次最多審查 10 個 URL 的批次審查,以及在你允許時提交 Sitemap。代價是設定:你得自己建立 Google 憑證。一位 r/TechSEO 的留言者說,Google Cloud 是「唯一的麻煩」。
  • 要在網頁版 claude.ai 或 ChatGPT 中使用,託管伺服器是最快的方式。它們是遠端伺服器,所以要透過 URL 新增。Claude 說明中心表示,自訂連接器適用於所有方案,但「免費使用者只能使用一個自訂連接器」。mcpsearchconsole.com 的免費方案每月可擷取資料 40 次、適用 3 個資源,之後是每月 €4.99(未含 VAT)。你的 Search Console 資料會經過供應商,所以請先看過它的隱私權條款。
  • 內建連接器省去了 Google Cloud 設定。在 Orkas 中,你用 Google 登入,連接器就在你的電腦上執行。它是唯讀的,只有四個工具,比社群伺服器少。

自行執行社群伺服器

以下步驟依據 mcp-gsc README 0.4.2 版(2026 年 11 月 6 日)。我們撰寫本指南時並未建立 Google Cloud 專案,所以開始前請先查看 README。

  1. 建立 Google 憑證。在 Google Cloud 控制台建立專案,啟用 Search Console API,並建立類型為 Desktop app 的 OAuth 用戶端 ID,然後下載它的 JSON 檔案。如果要自動化,請改為建立服務帳戶,再到 Search Console 的「設定」>「使用者和權限」,以完整權限新增該帳戶的電子郵件地址。
  2. 安裝 uv。README 推薦的方式是用 uvx 執行伺服器,它會幫你處理好 Python。不用 uv 的話,你需要 Python 3.11 以上版本。
  3. 將伺服器加入你的智慧代理。在 Claude Code 中:
    claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
    在 Codex 中:
    codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-console
    我們已在 Claude Code 2.1.311 和 Codex CLI 0.163.0 上確認過這兩個指令。若使用 Claude Desktop 或 Cursor,README 提供的 JSON 設定會寫出 uvx 的完整路徑,因為從 Dock 或「開始」功能表開啟的應用程式,不寫完整路徑可能會找不到它。
  4. 登入一次。第一次使用時,會開啟瀏覽器視窗讓你登入 Google。從 0.4.2 起,除非你設定 GSC_ALLOW_DESTRUCTIVE=true,否則伺服器只會要求唯讀權限。

有一個問題是社群指南沒提到的:根據 Google 的 OAuth 說明文件,如果你的 OAuth 同意畫面設為 External 並停留在 Testing 狀態,更新權杖會在 7 天後失效。也就是說,你每週都得重新登入。要避免這種情況,請將應用程式發布到正式環境,或改用服務帳戶。已發布的應用程式可能會顯示「未經驗證的應用程式」警告;對於使用者少於 100 人的個人用途應用程式,Google 允許直接點過這個警告繼續使用。

在 Orkas 中連接 Search Console

Orkas 是適用於 macOS 和 Windows 的桌面應用程式,可以讓多個 AI 智慧代理在同一個對話中一起工作。它內建 Google Search Console 連接器,所以你不需要 Google Cloud 專案。

  1. 安裝 Orkas 並登入。下載 macOS 或 Windows 版。新帳戶可獲得 500 免費點數,用於 Orkas 內建模型,因此不需要 API 金鑰就能開始。
  2. 開啟連接器。點選側邊欄的連接器,找到 Google Search Console。用資料篩選器或搜尋框都能很快找到。
  3. 按「連線」並用 Google 登入。按下連線,選擇能查看你資源的 Google 帳戶,並允許唯讀存取。卡片會移到已連線。
  4. 說出你的需求。在對話中輸入 @ 並選擇 Google Search Console 連接器,或直接描述任務。智慧代理會先列出你的資源,再查詢你指定的那一個。
  • 它是唯讀的。Orkas 只向 Google 要求 webmasters.readonly 範圍。四個工具分別用來列出資源、查詢成效資料、列出 Sitemap 和審查 URL。因為只會讀取,Orkas 執行它們時不會每次都要你核准。它們無法提交 Sitemap 或要求建立索引,而且每次查詢最多傳回 25,000 列。
  • 查詢直接送往 Google。連接器在你的電腦上執行,直接呼叫 Search Console API。只有 Google 登入和權杖更新會經過 Orkas 的伺服器,該伺服器保存著這個應用程式的 Google 憑證。
  • SeoGeoAgent 和你的程式設計智慧代理都能使用。SeoGeoAgent 是 Orkas 內建的 SEO 智慧代理,連接 Search Console 後,會在健檢中使用你真實的點擊次數、曝光次數和排名。如果你已安裝 Claude Code、Codex、OpenCode、Hermes 或 OpenClaw 並在 Orkas 中接入,它會透過 Orkas 的工具橋接使用這個連接器,不需要自己另外設定 MCP。
  • 需要寫入?在連接器頁面使用新增 MCP 伺服器,將社群伺服器新增為本機命令。Orkas 也有 Bing Webmaster Tools 連接器。

一次可以核對的首次健檢

第一個要求最好是請智慧代理提供一分鐘內就能和 Search Console 比對的數字,並說清楚資料沒有涵蓋什麼。請將資源和兩個 URL 換成你自己的:

使用 Google Search Console 連接器查詢 sc-domain:example.com。以最近 28 天的完整資料提供:1) 依日期列出的總點擊次數和曝光次數,以及查詢資料列涵蓋的比例;2) 排名在 5 到 15 之間、曝光次數至少 100 且點閱率低於 2% 的網頁,依曝光次數排序;3) https://example.com/new-page/ 和 https://example.com/old-page/ 的索引狀態。每個表格都要標明日期範圍,資料中沒有顯示的內容不要估算。

我們在 2026 年 11 月 9 日用 Orkas 中的 Claude Code 執行了這個要求,連接器的四個工具都正常運作。我們不公開自家網站的 Search Console 數字,所以以下結果是合成的範例資料:為 example.com 上一家虛構商店編造的數字,用來示範嚴謹的回答應該是什麼樣子,以及如何逐項核對。

  • 依日期的總數(合成資料):3,480 次點擊、151,200 次曝光。整個網站的數字應以這組總數為準。要核對你自己的資料,請開啟成效報告,選擇相同的自訂日期和搜尋類型,然後比較總數。兩者應該相當接近。如果差距很大,通常是智慧代理改成加總了查詢資料列或網頁資料列。
  • 查詢資料列(合成資料):642 列,涵蓋 1,670 次點擊,佔總數的 48%。其餘來自 Google 匿名處理的查詢,這些查詢在報告和 API 中都沒有資料列。這樣的比例很正常:Ahrefs 的研究發現,2025 年 4 月匿名查詢佔了流量的 46.77%,在許多網站上比例還更高。如果智慧代理把查詢資料列加總起來就當作你的流量,誤差可能高達一半。
  • 低 CTR 網頁(合成資料):有 9 個網頁排名在 5 到 15 之間、曝光次數至少 100 且 CTR 低於 2%。其中曝光次數最多的 /blog/linen-care/ 有 2,140 次曝光,平均排名 6.8,點擊 21 次,CTR 為 1.0%。這些網頁的標題和說明最該優先檢查。如果你的網站用結尾為 ?lang= 的網址提供不同語言版本,每個版本都會各自成為一列網頁資料,所以請要求分組彙整。
  • 網址審查(合成資料):舊網頁已建立索引,新網頁還沒有。9 月發布的 https://example.com/old-page/ 狀態是 "Submitted and indexed",上次檢索時間為 10 月 3 日。在檢查前兩天才發布的 https://example.com/new-page/ 則是 "Discovered - currently not indexed"。要核對的話,將同一個 URL 貼到 Search Console 頂端的審查框中。

最容易踩雷的五件事

  • 把查詢資料列當作總流量。Google 的成效資料指南指出,匿名查詢沒有資料列,「如果把所有資料列的點擊次數加總,得到的點擊次數會和圖表總數不同。」要取得總數,請要求依日期、不加查詢篩選條件的資料。
  • 拿網頁總數和網站總數比較。依網頁分組時,搜尋結果中出現的每個 URL 都會分開計算。依資源分組時,一則搜尋結果對整個網站只算一次。因此,網頁資料列的曝光次數加總起來,可能比網站總數還多。
  • 忘了資料延遲。資料「通常會在 2 到 3 天後提供」。除非要求最新資料,否則 API 傳回的是已定案的資料,因此「最近 7 天」會在今天的幾天前就結束。
  • 用錯資源名稱。網域資源寫成 sc-domain:example.com。網址前置字元資源則是包含結尾斜線的完整網址,例如 https://example.com/。先讓智慧代理列出你的資源,再複製它傳回的名稱。
  • 一次要求太多。每次要求最多傳回 25,000 列,若要 16 個月的查詢加網頁明細,很快就會達到上限。請要求摘要、加上篩選條件或縮短日期範圍,並讓智慧代理自行處理這些資料列,而不是全部貼進對話中。

該選哪一種方式?

你的情況建議
在瀏覽器中使用 claude.ai 或 ChatGPT託管伺服器,透過 URL 新增
想要所有工具(包括提交 Sitemap),也不介意使用 Google Cloud社群伺服器,例如 mcp-gsc
想讓 Claude Code、Codex 和 SEO 智慧代理讀取 Search Console,又不想碰 Google CloudOrkas 內建連接器
網站太大,每次要求 25,000 列不夠用Search Console 的 BigQuery 大量資料匯出(不透過 MCP)

常見問題

Google 有官方的 Search Console MCP 伺服器嗎?

沒有,截至 2026 年 11 月 9 日都沒有。Search Console 不在 Google 的官方 MCP 伺服器清單中,也不在 Google Cloud 的 MCP 清單裡。Google 有推出 Google Analytics 的 MCP 伺服器,但其中不包含 Search Console 資料。

Search Console MCP 是免費的嗎?

Search Console API 免費,mcp-gsc 等社群伺服器和 Orkas 的連接器也都免費。託管伺服器通常有每月限量的免費方案和付費方案。不過,你連接的 AI 智慧代理本身仍有費用,例如 Claude 方案或 Orkas 點數。

MCP 伺服器可以提交 Sitemap 或要求建立索引嗎?

只要擁有 Search Console 的完整權限,就可以提交或刪除 Sitemap,部分社群伺服器提供這項功能。Search Console API 沒有 Request indexing(要求建立索引)功能,因此對一般網頁來說,任何伺服器都做不到。Orkas 的連接器是唯讀的,兩者都不會做。

為什麼 MCP 的數字和 Search Console 對不上?

通常是因為智慧代理加總了查詢資料列,而這些資料列不包含匿名查詢;或是把依網頁的總數和依資源的總數混在一起。請要求依日期、不加查詢篩選條件的總數,並使用與報告相同的日期和搜尋類型。這樣得出的總數應該會相當接近。

可以搭配 Claude Code 和 Codex 使用嗎?

可以。用 claude mcp add 或 codex mcp add 新增社群伺服器,或透過 URL 新增託管伺服器。在 Orkas 中,Claude Code 和 Codex 會透過 Orkas 的工具橋接使用內建的 Search Console 連接器,兩個工具都不需要另外設定。

什麼是 Agentic SEO?一文介紹了更完整的全貌:由智慧代理根據即時資料執行 SEO 工作,再由人核准要上線的內容。

Claude SEO skill →

在智慧代理的對話中使用 Search Console 只要連接 Search Console 一次,就能讓 Claude Code、Codex 或 SeoGeoAgent 讀取資料。 Orkas 在 macOS 和 Windows 上免費。新帳戶可獲得 500 點數,用於內建的 Orkas 模型。
免費下載 Orkas