GSC Connect Skill：讓 Codex 與 AI Agent 讀取 Google Search Console 數據

GSC Connect 把 Agent 問題、使用者授權和 Google 官方數據串成一條可核對的工作流程。

SEO 團隊經常在 Google Search Console 下載 CSV，再把查詢、頁面、裝置和日期資料交給另一個工具整理。這個流程可以工作，但每次換網站、換日期或追問細節，都要重新匯出和清理。

我們開發的 GSC Connect 是一個以 Google Search Console 官方 API 運作的 Codex Plugin。使用者連接自己的 Google 帳戶、選擇有權限的網站後，Codex 就能按問題讀取相關數據，而不是依賴螢幕截圖、爬取後台或一份很快過期的 CSV。

你可以直接下載完整 Codex Plugin，也可以把遠端 MCP 連接到其他相容的 Agent 平台。下文提供完整安裝方式。

GSC Connect 可以做甚麼？

目前的工具全部是唯讀操作，涵蓋四類常見工作：

• 列出 Google 帳戶可存取的 Search Console Property，保留 Google 回傳的完整 siteUrl。
• 查詢 clicks、impressions、CTR、average position，並按 query、page、date、country 或 device 分析。
• 取得網站近期概覽，整理熱門查詢、頁面、國家與裝置。
• 查看已提交 Sitemap 的處理狀態和錯誤資料。
• 使用 URL Inspection API 讀取 Google 已知的索引版本。這是索引資料檢查，不是即時 Live Test。

例如你可以直接問：

列出我可以存取的 GSC 網站，讓我選擇一個。

檢查這個網站最近 28 天表現，找出展示增加但 CTR 偏低的頁面。

查看這個 URL 在 Google 索引中的狀態，並說明應先核對甚麼。

Agent 負責組織問題與解讀結果；網站選擇、日期範圍和最終 SEO 決策仍由使用者確認。

為甚麼堅持使用官方 API？

GSC Connect 不會模擬登入或抓取 Search Console 後台畫面。資料來自 Google 的 Search Console API，搜尋表現使用 Search Analytics 資源，索引資料使用官方 URL Inspection API。

這樣做有三個實際好處：

1. 欄位有明確來源。 clicks、impressions、CTR 和 position 不需要從表格畫面猜測。
2. 權限由 Google 控制。 Plugin 只能看到當前 Google 帳戶本來就能存取的 Property。
3. 查詢可以重複。 同一套日期、維度與篩選條件可以再次執行，方便比較修改前後的變化。

但官方 API 也有邊界。Search Analytics 不保證返回每一條低量查詢；URL Inspection 返回 Google 已知的索引資料，不等於重新抓取網站；API 結果也不能單獨證明某次改動造成排名變化。文章或報告必須把這些限制寫清楚。

使用者用自己的 Google 帳戶授權

GSC Connect 的公開服務使用 Google OAuth。使用者在 Google 頁面登入並授權自己的帳戶，Plugin 不會要求使用者提供 Google 密碼、Client Secret、Access Token 或 Refresh Token。

目前請求的是 Search Console 唯讀範圍。這代表工具可以讀取有權限網站的資料，但不會替使用者新增或刪除 Property、提交 Sitemap、要求索引，亦不會修改網站內容。

正式 MCP 入口為 https://gsc.yusihk.com/mcp，服務說明、私隱政策與使用條款亦放在同一個專用網域。

如何安裝 GSC Connect？

你可以按使用的平台選擇完整 Plugin、遠端 MCP 或獨立 Skill。Codex 使用者建議安裝完整 Plugin，因為它已把 Skill、MCP 連接、圖示和使用提示放在同一個套件內。

方法一：安裝完整 Codex Plugin（推薦）

先下載 GSC Connect Codex Plugin並解壓。下載包是一個本地 Codex marketplace，不含 Google 密碼、OAuth Client Secret、Access Token 或 Refresh Token。

打開 Terminal，把第一條命令的路徑改成解壓後 gsc-connect-codex-plugin 資料夾的實際絕對路徑：

codex plugin marketplace add /absolute/path/to/gsc-connect-codex-plugin
codex plugin add google-search-console@gsc-connect

安裝完成後重新開啟 Codex，選擇 GSC Connect，按連接提示登入自己的 Google 帳戶。首次使用時可以說：「列出我可以存取的所有 GSC 網站，讓我選擇一個。」

方法二：直接連接遠端 MCP

如果平台支援遠端 MCP、Streamable HTTP 和 OAuth，可新增以下服務 URL：

https://gsc.yusihk.com/mcp

連接時會跳到 Google 授權頁面。完成授權後，先呼叫 gsc_list_sites 取得當前帳戶可存取的 Property，再選擇網站進行查詢。不同 Agent 平台的 MCP 設定介面不同，但不應要求你輸入本服務的 Google Client Secret。

方法三：只安裝獨立 Skill

下載 GSC Connect Skill，解壓後把其中的 gsc-connect 資料夾放進 Agent 平台的 Skills 目錄。Codex 的使用者層級預設位置是：

~/.agents/skills/gsc-connect

獨立 Skill 提供問題拆解、工具選擇和唯讀安全規則；它本身不是資料連接器。若要讀取私人 GSC 數據，平台仍需連接上面的 MCP URL，並支援 OAuth。

其他 Agent 平台可以使用嗎？

可以，但要分清楚 Skill 和 MCP 連接 是兩層能力。

平台能力	可以使用的部分	實際限制
支援 Codex Plugin	Skill 指令、MCP 工具與 OAuth	可使用完整 GSC Connect 工作流程
支援遠端 MCP、Streamable HTTP 與 OAuth	MCP 工具與 Google 授權	需要平台正確完成 MCP 與 OAuth 設定
只支援 SKILL.md／Agent Skill	問題拆解、工具選擇與安全規則	沒有 MCP 客戶端時不能直接讀取 GSC 數據
一般聊天模型，不支援工具或連接器	可參考公開使用方法	不能代表使用者登入或存取私人 Search Console

MCP 的 Streamable HTTP 傳輸與授權機制有公開規格，其他平台若按 Model Context Protocol transport specification 實作相容客戶端，便有機會直接連接同一個服務。平台仍需支援 OAuth 流程、受保護資源發現與相關安全要求；只看得懂 Skill 文字並不代表已取得資料權限。

Codex Plugin 如何協助日常 SEO？

Plugin 的價值不是把所有數據一次倒進對話，而是讓 Agent 根據任務逐步取數。

一個較可靠的流程是：

1. 先列出可存取網站，由使用者選擇正確 Property。
2. 確認日期、地區、裝置和比較範圍。
3. 先讀網站概覽，再針對異常頁面或查詢縮小範圍。
4. 如涉及索引問題，再檢查 Sitemap 與代表性 URL。
5. 把 API 結果、限制和下一步人工核對項目一起交付。

例如「流量下降」不應直接等同內容品質下降。Agent 應先分開品牌詞與非品牌詞、桌面與手機、主要頁面與長尾頁面，再檢查是否有季節性、網站變更或索引訊號問題。

如果你正在建立固定的 GSC 回看流程，下方的 2026 更新小節會補充生成式 AI 報告的使用邊界；需要先檢查網站公開技術訊號，可使用 SEO 工具中心。

2026 年 6 月後：怎樣把生成式 AI 報告放進 Agent 工作流？

2026 年 6 月 3 日，Google Search Central 宣佈 Search Console 會把生成式 AI 的流量拆成獨立報告。Google Search Console Help 目前寫明，Search 報告涵蓋的是 AI Overviews 與 AI Mode impression，屬於逐步開放，不是每個網站都一定看得到。

這代表兩件事：第一，看不到報告不等於網站完全沒有 AI 搜尋曝光；第二，即使你看得到，也不應把這份報告當成「AI SEO 總分」。它回答的是 AI 搜尋曝光，不是詢盤品質，也不是內容修改已經成功的證明。

可用時，較穩妥的做法是：

1. 先在 Search Console 介面確認是否真的看到這份 Search report，並記錄日期範圍與 Property。
2. 把生成式 AI 報告與一般 Search performance report 分開看；前者回答 AI 搜尋曝光，後者回答整體自然搜尋。
3. 用最近 28 個完整日對比前一個 28 日，只看一個主要假設，例如某頁 FAQ 更新後是否增加相關曝光。
4. 再把 landing page 行為、表單、WhatsApp 或 CRM disposition 接回來，避免把 impression 誤當成查詢品質。
5. 若目前沒有報告，要分清是功能仍未向該網站開放、曝光樣本不足，還是 Agent 端尚未支援專用查詢。

你可以直接把這份限制交給 Agent，例如：

如果這個 Property 可見生成式 AI 搜尋報告，先比較最近 28 個完整日和前一個 28 日的 pages、countries、devices；若不可見，明確標示是報告不可用，並退回一般 Search performance report。

若你要把 AI 搜尋曝光、網站行為和查詢品質放回同一條決策鏈，可改看 Tag Gateway、Data Manager 與第一方數據量度邊界 這篇分工指南，而不是假設 Search Console 一份報表就能回答所有商業問題。

下載與支援

• 下載 GSC Connect Codex Plugin
• 下載 GSC Connect Skill
• 遠端 MCP：https://gsc.yusihk.com/mcp
• 服務文件：https://gsc.yusihk.com/docs

遇到安裝、授權或網站 Property 選擇問題，可透過聯絡我們提供使用平台、錯誤訊息和重現步驟。請勿傳送 Google 密碼、OAuth Token 或 Client Secret。

官方參考資料

• Google Search Console API
• Google URL Inspection API
• Google Search Central Blog：Introducing AI features performance reports in Search Console
• Search Console Help：Generative AI performance report (Search)
• Model Context Protocol：Transports

延伸閲讀

• GSC Connect 繁體中文服務文件