SuperAPI AI 工具集

google-forums-search

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于通过 Frevana 获取 Google Forums(Google 论坛标签页)的论坛式搜索结果,包括 Reddit、Quora、社区讨论等。

主要能力:接收查询词 q(必填),可选 device、hl、gl、start、start_date、end_date。返回经校验的 JSON 响应,并在每次成功运行时将同一 JSON 保存到本地文件,同时原样输出到 stdout。响应常见字段包括 search_metadata、search_parameters、search_information、organic_results、related_searches、pagination。

使用方式:需在环境变量中提供 FREVANA_TOKEN,或本次运行用 --token 覆盖;依赖 curl、bash、python3。优先使用脚本而非临时 curl 命令。基本用法:bash <skill-path>/scripts/search_google_forums.sh --q "best programming language"。--query 可作为 --q 的别名。可加 --gl us --hl en --device mobile,或用 --start 10 --start-date 20260101 --end-date 20260525 分页与限定日期,用 --output 指定保存路径。日期需为 YYYYMMDD 格式。

限制:仅 q 必填,不要自行编造 device、hl、gl、start、start_date、end_date。当前端点仅支持 q、device、hl、gl、start、start_date、end_date,不支持 engine、api_key、output、no_cache、async、zero_trace 等透传字段,也不支持 location、uule、period_unit、period_value、nfpr、filter、tbs 等字段。device 仅限 desktop、mobile、tablet。非交互或智能体流程中若缺少 token 应快速失败并提示设置 FREVANA_TOKEN 或传 --token。不要将 Bearer token 回显给用户。缺少 curl 或 python3 时应停止并提示安装。不要为保存和总结而重复调用脚本。总结时可包含论坛标题、来源/社区、链接、摘要、评论/回答数、日期、站点链接及后续分页。