前言¶
Agent 的知識來自訓練數據，遇到剛發佈的新聞、最新版本的文檔、價格或匯率這類實時信息，就只能憑空回答或拒絕回答。給 Agent 外接一個搜索能力，是這類問題的常規解法。google-search 就是這樣一個 Skill：它把 Google Custom Search Engine 接到 Agent 的 Skill 體系上，讓模型在需要時自己去查網頁。
下面介紹這個 Skill 的來源、能力、安裝方式和注意事項。需要說明的是，SkillHub 頁面與官方 API 地址本次均抓取失敗，以下內容以預抓取的結構化資料爲準；資料中沒有的信息，文中不做推測。
這是什麼¶
google-search 是一個基於通用 SKILL.md 格式的 Agent Skill，由「智創未來」發佈，版本 1.0.0，來源標註爲 enterprise，分類是 knowledge-management。它的定位是網絡搜索：通過 Google Custom Search Engine 搜索網絡，返回實時信息與權威來源，做精準搜索。
一句話概括：這是一個把 Agent 接到 Google 站內搜索上的 Skill，不是瀏覽器自動化工具，也不負責抓取某個具體頁面的正文。
核心功能¶
根據已有資料，它的能力邊界如下：
- 走 Google Custom Search Engine 做搜索，而不是隨便一個爬蟲。Custom Search Engine 本身依賴 Google 的索引，結果質量由該引擎的配置決定。
- 輸出實時信息。搜索結果反映的是查詢時刻網絡上的內容，繞開了模型訓練數據的截止時間。
- 偏向權威來源。簡介中明確寫的是「權威來源」，但具體哪些站點被排除或加權，取決於 Custom Search Engine 的配置，資料裏沒有給出默認配置。
- 需要 API Key。該 Skill 帶 requires_api_key=true 標籤，說明調用前必須準備好 Google Custom Search 的 API Key，否則無法工作。
資料中沒有提到它支持網頁正文抓取、支持自動分頁、支持多語言或多引擎切換。這些能力不能默認擁有。
安裝與啓用¶
本次抓取 SkillHub 頁面（https://www.skillhub.cn/skills/zcwl/google-search）和官方 API 地址（https://api.skillhub.cn/zcwl/google-search）均失敗，資料裏也沒有給出安裝命令或配置片段。因此這裏不提供推測的命令，避免寫出無法覈實的步驟。
啓用前需要確認兩件事：
- 該 Skill 座標爲 @zcwl/google-search，安裝時按這個座標查找。
- requires_api_key=true，所以必須先準備好 Google Custom Search Engine 的 API Key，並把它配置到 Skill 的運行環境裏。
具體的安裝命令、支持的宿主（Cursor / Codex CLI / Claude Code 等）以及配置項名稱，需要在官方頁面恢復後按頁面實際內容操作。這點不要省略：配置字段編造出來會導致調用直接失敗。
典型用法¶
資料裏沒有給出官方的可復現示例，這裏不虛構。從能力描述可以推斷的典型調用方式是：Agent 在回答需要實時信息時，先調用該 Skill 發起搜索，拿到 Google Custom Search Engine 返回的結果列表，再基於結果組織回答。
真正可用的示例應當包含這些要素：API Key 的注入方式、搜索關鍵詞、返回結果的字段結構、以及超時或 Key 失效時的錯誤處理。這些在資料中都沒有出現，寫不出來就是寫不出來。
適用場景與注意¶
適合的場景：
- 時效性強的信息，比如新聞、公告、版本發佈、政策更新。
- 需要交叉驗證來源的場景，可以要求模型優先引用搜索結果中的權威站點。
- 知識管理類工作流，配合分類 knowledge-management 使用，做資料檢索的前置環節。
需要注意的坑：
- Google Custom Search Engine 默認有查詢配額，高頻調用會被限流或產生費用，需要在 Key 的配額設置裏確認。
- 搜索結果返回的是網頁條目，不是網頁全文。要拿正文還得再抓取一次，本 Skill 是否包含這一步資料裏沒說。
- 搜索質量取決於 Custom Search Engine 的配置。如果引擎配置了站點限制，結果就會只在那些站點裏繞，注意確認實際生效的引擎範圍。
- 下載量是 10371，安裝數是 0，評分 100000。這兩個數字看趨勢參考即可，不要當作質量背書。
結尾¶
google-search 做的事情很直接：給 Agent 補上一個 Google 搜索的出口，讓模型能查到訓練數據之外的實時信息。它的價值在於把搜索這件事標準化成一個 Skill，而不是讓每個 Agent 自己去對接 API。前提是你得先有可用的 Custom Search Engine 和對應的 API Key。
官方地址：https://api.skillhub.cn/zcwl/google-search
SkillHub 頁面：https://www.skillhub.cn/skills/zcwl/google-search
