SuperAPI AI 工具集

google-search

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于通过 Frevana 获取常规 Google 搜索结果,适合需要自然结果、相关问题、相关搜索、知识图谱、答案框等数据的场景。

主要能力:接收查询词 q(必填),可选 location、gl、hl、num、start、safe、device 参数;返回经过校验的 JSON 响应,并在每次成功运行时将同一份 JSON 保存到本地文件。响应常见字段包括 search_metadata、search_parameters、search_information、organic_results、related_questions、related_searches、knowledge_graph、answer_box、pagination。

使用方式:优先使用脚本而非临时 curl 命令。基本用法为 bash <skill-path>/scripts/search_google.sh --q "coffee",--query 可作为 --q 的别名。可附加 --location、--gl、--hl、--num、--start、--safe、--device 等参数,也可用 --output 指定保存路径,或用 --token 覆盖当前运行的令牌。脚本先读取环境变量 FREVANA_TOKEN;交互式场景下缺失时可能提示输入,非交互或智能体工作流中缺失则快速失败并提示设置 FREVANA_TOKEN 或显式传入 --token。

限制:仅 q 为必填,不要自行编造 location、gl、hl、num、start、safe、device 的值。Frevana 端点当前仅支持 q、location、gl、hl、num、start、safe、device,不要传入 engine、api_key、output、no_cache、async、zero_trace 等不支持的字段。num 仅支持 1 到 100,safe 仅支持 active 或 off,device 仅支持 desktop、mobile 或 tablet。依赖 curl、bash、python3,缺失时需先安装。不要将 Bearer 令牌回显给用户。脚本始终保存并打印同一份 JSON,无需为保存和总结重复调用。除非用户要求完整数据,否则应总结其关心的搜索结果而非直接输出原始 JSON。