用途:通过 Frevana 的 /service/google-short-videos 端点搜索 Google 短视频结果,并原样返回 SerpAPI 响应,不做改写或重塑,除非用户明确要求转换。
主要能力:必填参数 q;支持 location、uule、google_domain、gl、hl、lr、device、start、tbs、safe、nfpr、filter、no_cache、async、zero_trace 等请求字段。脚本会校验响应为 JSON 并输出到 stdout。
使用方式:需要 query、环境变量中的 FREVANA_TOKEN(或本次运行使用 --token),以及 curl、bash、python3。API 基础地址默认 https://ai-factory.frevana.com,可通过 FREVANA_API_BASE_URL 指向其他主机。
示例命令: bash <skill-path>/scripts/search_google_short_videos.sh --q "coffee recipes" --device "mobile" 保存 JSON: bash <skill-path>/scripts/search_google_short_videos.sh --q "Q" --output "./out/google-short-videos-search.json"
请求体固定形状为 q、location、uule、google_domain、gl、hl、lr、device,未提供的可选字段会被省略。不要传入不支持的字段,也不要传 SerpAPI engine 或 api_key,Frevana 会在服务端设置。使用 --output 可保存到本地文件。
输出:成功时在 stdout 输出校验后的 JSON;使用 --output 时同一 JSON 也会写入指定文件;失败时在 stderr 输出响应体或解析错误,并返回非零退出码。
适用场景:需要获取 Google 短视频搜索结果、进行本地化或语言限制、安全搜索、高级过滤与分页,并希望保留原始 JSON 数据的场景。
限制:必须提供 q 和有效令牌;依赖 curl、bash、python3;不支持自定义 SerpAPI engine 或 api_key;返回数据默认不转换。其他收费、平台或效果信息暂未提供。