SuperAPI AI 工具集

serper-search

通用与其它

查看项目

更新于 10-25 04:53

技能介绍

Serper Search 是一个用于外部网页搜索的 Agent 技能,基于 Serper 提供的搜索接口,适合在智能体需要当前信息或一般网络来源时调用。按照技能说明,当本地文件和项目 API 已经包含所需信息时,应优先使用本地资源,而不是进行外部搜索。

主要能力与规则:该技能要求不使用内置 WebSearch 工具,改为调用 Serper;不得在回答、日志、已提交的测试数据或浏览器与客户端代码中暴露 API 密钥;返回结果中优先采用权威来源和一手来源;当对时效性、日期、公司、产品或来源类型有要求时,应细化查询。

使用方式:接口为 POST https://google.serper.dev/search,认证头为 X-API-KEY: $SERPER_API_KEY,内容类型为 application/json,请求体至少包含 {"q":"query text"}。资料给出的 curl 示例为:curl -s --location "https://google.serper.dev/search" --header "X-API-KEY: $SERPER_API_KEY" --header "Content-Type: application/json" --data '{"q":"apple inc"}'。

结果使用:普通搜索回答优先采用自然搜索结果;可用 searchParameters 确认实际发送的查询;credits 应视为用量计量;重要结论应结合链接来源核实,不应把摘要视为完整证据;总结时应包含来源标题和链接,不大量复制摘要或页面段落。

失败处理:DNS 或网络失败应报告为环境或网络问题,仅在外部网络可用时重试;认证失败应报告 SERPER_API_KEY 缺失或无效,但不打印其值;结果不相关时,用名称、日期、地点或来源域名细化查询。

适用场景:需要获取当前信息、一般网络来源,或需要检索内置工具未覆盖的 URL 的智能体任务。限制:该技能依赖 Serper API 与有效的 SERPER_API_KEY;资料未提供具体收费标准、调用配额、响应字段的完整定义以及除搜索接口之外的其他端点信息,这些内容暂未提供。