SuperAPI AI 工具集

google-maps-reviews

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能调用 Frevana 的 /service/google-maps-reviews 端点,用于按 Google Maps 的 data ID 或 place ID 获取评论数据,并原样返回 SerpAPI 响应,不做改写或重塑,除非用户明确要求转换。

主要能力与请求字段:必填项为 data_id 或 place_id 之一;可选字段包括 hl、sort_by、topic_id、query、num、next_page_token、no_cache、async、zero_trace。脚本会校验响应是否为 JSON 并输出到 stdout。

使用方式:需准备 data ID 或 place ID,在环境变量中设置 FREVANA_TOKEN,或在本次运行使用 --token;依赖 curl、bash 和 python3。API 基础地址默认为 https://ai-factory.frevana.com,可通过 FREVANA_API_BASE_URL 指向其他主机。

示例命令: bash <skill-path>/scripts/get_google_maps_reviews.sh --place-id "ChIJIQBpAG2ahYAR_6128GcTUEo" bash <skill-path>/scripts/get_google_maps_reviews.sh --data-id "0x123" --query "service" --num "20" bash <skill-path>/scripts/get_google_maps_reviews.sh --data-id "DATA_ID" --output "./out/google-maps-reviews.json"

输出与限制:成功时在 stdout 输出校验后的 JSON;使用 --output 时同时写入指定文件;失败时在 stderr 输出响应体或解析错误,并返回非零退出码。不要传入不支持的字段,也不要传 SerpAPI 的 engine 或 api_key,这些由 Frevana 在服务端设置。适用场景为需要获取或搜索 Google Maps 评论并保存原始 JSON 的流程。