用途:通过 Frevana 搜索 Apple App Store 的应用列表,可按关键词、开发者、分类、国家、语言、设备等条件检索。
主要能力:输入 term(必填,别名 --q/--query),可选 country(默认 us)、lang(默认 en-us)、num(1-200,默认 10)、page(0 起始,默认 0)、disallow_explicit、property(如 developer)、category_id(数字分类 ID,如 6014 为 Games)、device(desktop|tablet|mobile,默认 desktop)、output,以及 SerpAPI 标志 serpapi_output、no_cache、async、zero_trace。返回经校验的 JSON,含 search_metadata、search_parameters、organic_results 等,并保存到本地文件。
使用方式:需 FREVANA_TOKEN 环境变量或 --token 覆盖,依赖 curl、bash、python3。基本命令:bash <skill-path>/scripts/search_apple_app_store.sh --term "instagram"。可按开发者搜索加 --property developer,指定输出加 --output ./out/my-apple-search.json。脚本先读 FREVANA_TOKEN,非交互环境缺失则快速失败。成功时打印 JSON 到 stdout 并保存文件,后续解析应使用已保存文件而非重复调用。
限制:仅 term 必填,不要臆造可选参数值;num 须为 1-200 整数,page 须 >=0,device 仅限三种取值;缺少 curl 或 python3 需先安装;不要回显 Bearer token;除非用户要求完整数据,否则应汇总结果而非直接输出原始 JSON。