google-search:给 Agent 接上 Google 搜索的 Skill

前言

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)均失败,资料里也没有给出安装命令或配置片段。因此这里不提供推测的命令,避免写出无法核实的步骤。

启用前需要确认两件事:

  1. 该 Skill 坐标为 @zcwl/google-search,安装时按这个坐标查找。
  2. 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜