將 Search Console 連接至任何 MCP 客戶端

端點

伺服器位於應用程式網域下的 /mcp，並以協定版本 2025-06-18 使用 Streamable HTTP。客戶端會 POST JSON-RPC，傳送 initialize 請求，接著傳送 tools/list。無需安裝任何東西，路徑中也沒有本地代理伺服器。

• Authorization: Bearer，金鑰格式為 apk_live_ 加上 32 個十六進位字元
• 金鑰僅在建立時顯示一次，僅以 SHA-256 雜湊值儲存
• 每次呼叫都會更新金鑰的上次使用時間與請求計數

工具

依功能分組，名稱清楚，方便模型選對工具。唯讀金鑰無法使用會寫入或消耗研究額度的工具。

• 探索：list_properties、search_analytics
• 成效：top_queries、top_pages、top_countries、compare_periods
• 診斷：content_decay、cannibalization、ctr_benchmark、page_poaching、rank_changes、new_lost_rankings
• 索引：url_inspection、sitemaps
• 時間軸：annotations，以及使用寫入金鑰的 create_annotation
• 分析：ga4_overview、ga4_breakdown、ga4_key_events
• 研究：關鍵字、搜尋結果頁、反向連結、排名追蹤與網站稽核，會消耗研究額度
• 內容引擎：content_list_tasks、content_claim、content_get_brief、content_submit、content_publish 與封面工具，用於依佇列撰寫內容

日期為選填

若在任何工具中省略日期範圍，伺服器會使用最近 28 天已穩定的資料（已考量 Search Console 的報告延遲），比較區間則預設為前一個相同長度的期間。客戶端完全不需要知道今天的日期，也能提出合理的查詢。

權限範圍與速率限制

金鑰分為唯讀或讀寫兩種。唯讀金鑰完全無法存取寫入工具，而寫入金鑰的每次變更都會記錄稽核日誌。

• 每組金鑰每分鐘 60 次請求，每個帳號每小時 1,000 次請求
• 超過限制會回傳 HTTP 429，並附上以秒為單位的 Retry-After
• 可單獨撤銷一組金鑰，不影響帳號中的其他金鑰

若你偏好使用 REST

Search Console 與 GA4 工具也以 GET 與 POST 路由開放於 /v1 之下，並附有位於 /v1/openapi.json 的自動產生 OpenAPI 3.1 文件，亦可作為函式呼叫規格。金鑰、權限範圍與限制皆相同。