用途:根据用户提供的 Apple App Store 产品 ID,获取该应用的用户评价,支持分页和排序。
主要能力:输入 product_id(或 --id),可选 country(默认 us)、page(从 1 开始,默认 1)、sort(mostrecent、mosthelpful、mostfavorable、mostcritical,默认 mostrecent)、output 路径,以及 SerpAPI 相关标志 serpapi_output、no_cache、async、zero_trace。输出为经过校验的 JSON,包含 search_metadata、search_parameters、reviews 等部分,并在每次成功运行时保存到本地文件,默认路径为 ./out/apple-reviews-<timestamp>-<pid>.json。
使用方式:需要环境变量 FREVANA_TOKEN,或本次运行显式传入 --token;依赖 curl、bash、python3。优先使用脚本而非临时 curl 命令。基本用法:bash <skill-path>/scripts/get_apple_reviews.sh --product-id "6444058226"。可加 --country us --page 2 --sort mosthelpful,或用 --output 指定保存路径。脚本先读取 FREVANA_TOKEN,交互式场景缺失时可能提示输入,非交互或智能体流程中缺失则快速失败并提示设置。
限制:仅 product_id 为必填,不要自行编造可选参数值;page 最小为 1;sort 仅限上述四个值;缺少 curl 或 python3 时应停止并提示安装;不要回显 Bearer token;除非用户明确要求完整数据,否则应总结评价而非直接输出原始 JSON。返回数据不应改写或重塑,除非用户明确要求转换。