搜尋觀點
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。
這樣做有三個實際好處：
- 欄位有明確來源。 clicks、impressions、CTR 和 position 不需要從表格畫面猜測。
- 權限由 Google 控制。 Plugin 只能看到當前 Google 帳戶本來就能存取的 Property。
- 查詢可以重複。 同一套日期、維度與篩選條件可以再次執行，方便比較修改前後的變化。
但官方 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 根據任務逐步取數。
一個較可靠的流程是：
- 先列出可存取網站，由使用者選擇正確 Property。
- 確認日期、地區、裝置和比較範圍。
- 先讀網站概覽，再針對異常頁面或查詢縮小範圍。
- 如涉及索引問題，再檢查 Sitemap 與代表性 URL。
- 把 API 結果、限制和下一步人工核對項目一起交付。
例如「流量下降」不應直接等同內容品質下降。Agent 應先分開品牌詞與非品牌詞、桌面與手機、主要頁面與長尾頁面，再檢查是否有季節性、網站變更或索引訊號問題。
如果你正在建立固定的 GSC 回看流程，可延伸閲讀 Search Console 與 AI 搜尋成效報告；需要先檢查網站公開技術訊號，可使用 SEO 工具中心。
下載與支援
- 下載 GSC Connect Codex Plugin
- 下載 GSC Connect Skill
- 遠端 MCP：
https://gsc.yusihk.com/mcp - 服務文件：
https://gsc.yusihk.com/docs
遇到安裝、授權或網站 Property 選擇問題，可透過聯絡我們提供使用平台、錯誤訊息和重現步驟。請勿傳送 Google 密碼、OAuth Token 或 Client Secret。