用途:该技能用于搜索 Google Maps 地点,或按 Google Maps place ID / CID 获取特定地点记录。
主要能力:支持关键词搜索(--type search 配合 --q),也支持地点查询(--place-id 或 --data-cid)。可指定地图原点(--ll,或 --location 与 --lat/--lon 配合 --z 或 --m),并支持附近搜索、google_domain、hl、gl、价格/评分/营业状态筛选及 start 分页参数。
使用方式:需在环境变量中提供 FREVANA_TOKEN,或本次运行使用 --token;依赖 curl、bash、python3。基本搜索示例:bash <skill-path>/scripts/search_google_maps.sh --q "coffee shops" --type search。按地点 ID 查询:bash <skill-path>/scripts/search_google_maps.sh --place-id "ChIJIQBpAG2ahYAR_6128GcTUEo"。可用 FREVANA_API_BASE_URL 覆盖 API 主机,默认 https://ai-factory.frevana.com。
规则与限制:--type 接受 search 或 place,除非提供 --place-id 或 --data-cid,否则必填;--type search 需要 --q,--type place 需要 --data;--place-id 与 --data-cid 不可同时使用。--location 或 --lat/--lon 必须与 --z 或 --m 配对,--lat 与 --lon 需同时提供。--z 为 3–30,--m 为 1–15028132,--min-price/--max-price 为 1–4,--min-rating 为 2、2.5、3、3.5、4、4.5 之一。--open-state 为 now 或 24h,不能与 --open-on-day/--open-at-hour 同用;--open-at-hour 为 0–23 且需配合 --open-on-day。成功时输出校验后的 JSON,可用 --output 写入文件;失败时在 stderr 输出响应体或校验错误并返回非零退出码。脚本不会改写返回数据,除非用户明确要求转换。