SuperAPI AI 工具集

openclaw-serper

通用与其它

查看项目

更新于 10-15 23:46

技能介绍

用途:通过 Serper API 调用 Google 搜索,并对每条结果抓取网页正文,用 trafilatura 提取干净全文,而非仅返回摘要。

主要能力:两种模式。default 为全时段网页搜索,返回 5 条结果;current 为过去一周网页搜索(3 条)加 Google News(3 条),适合时效性内容。每条结果附带完整正文,提取失败时回退为搜索摘要。输出为流式 JSON 数组,首元素为元数据,其余为结果,字段含 title、url、source(web/news/knowledge_graph)、content、date。

使用方式:python3 scripts/search.py -q "QUERY" [--mode MODE] [--gl COUNTRY] [--hl LANG]。例如 python3 scripts/search.py -q "how does HTTPS work";时效查询加 --mode current。非英语查询或指定国家/地区时必须设置 --gl 与 --hl,如德语用 --gl de --hl de,法语用 --gl fr --hl fr;默认 world/en 仅适用于英语查询。API 密钥从技能目录的 .env 读取,缺失时脚本会输出配置说明。

限制:该技能已抓取并提取全文,不应再对返回 URL 使用 WebFetch、WebSearch 或浏览器工具。查询应精炼,一次调用通常足够,最多两次(跨两个独立主题时)。部分站点禁止抓取,只能得到摘要;无结果时返回 {"error": "No results found", "query": "..."}。