用途:该技能通过 Frevana 的 /service/google-ads 端点执行 Google Ads 赞助搜索,并将 SerpAPI 响应原样返回,不做改写或重塑,除非用户明确要求转换。
主要能力:支持本地化广告搜索、安全搜索、禁用自动纠错(no-auto-correct)以及按设备指定搜索。请求字段包括必填的 q(查询)和 location(位置),以及可选的 hl、safe、nfpr、device、no_cache、async、zero_trace。脚本会校验响应是否为 JSON 并输出到 stdout。
使用方式:需要 query 和 location;在环境变量中设置 FREVANA_TOKEN,或通过 --token 为当前运行提供令牌;依赖 curl、bash 和 python3。API 基础 URL 默认为 https://ai-factory.frevana.com,可通过 FREVANA_API_BASE_URL 指向其他主机。
命令示例: bash <skill-path>/scripts/search_google_ads.sh --q "project management software" --location "Austin, Texas, United States"
保存 JSON 到文件: bash <skill-path>/scripts/search_google_ads.sh --q "Q" --location "LOCATION" --output "./out/google-ads-search.json"
限制:不要传入不支持的字段;不要传 SerpAPI 的 engine 或 api_key,Frevana 会在服务端设置。成功时在 stdout 输出校验后的 JSON,使用 --output 时同时写入指定文件;失败时在 stderr 输出响应体或解析错误,并返回非零退出码。适用场景为需要获取 Google Ads 赞助搜索原始数据的查询与保存。