SuperAPI AI 工具集

search

数据与分析

查看项目

更新于 10-18 16:14

技能介绍

用途:本技能负责“查找并追踪应用”。它先在指定商店和地区中搜索目标应用,确认候选,再把应用加入 AppFollow 的集合中以便持续追踪,最后输出结构化引用,交给反馈分析(feedback-analysis)和 ASO 分析等技能继续使用。使用前需先阅读 using-appfollow 文档,了解会话开启、写入流程和错误码。

主要能力:支持按应用名称关键词进行自由文本搜索,可指定商店(as 表示 App Store、gp 表示 Google Play、ms 表示 Microsoft Store、am 表示 Amazon)、国家(默认 us)、集合名称和语言区域。搜索为只读操作,任何套餐均可使用。流程中会列出编号候选,仅在出现唯一精确标题匹配时自动选择,否则由用户挑选。随后解析目标集合,若集合不存在则走预览、用户确认、创建的流程;再通过 list_apps 去重,已追踪的应用记入 skipped_existing 并跳过添加。添加时先执行 add_app_preview,经用户明确同意后以相同参数调用 add_app,最后再次 list_apps 验证并记录 apps_id。

使用方式:输入 query(应用名称关键词)及 store、country、collection、locale 等参数。注意搜索端点只接受自由文本关键词,不接受商店 URL 或 ext_id,因此需先把粘贴的链接裁剪为应用名称或标题。搜索会调用 aso_search_results,可选用 aso_search_suggestions(5 点数)。查询候选后解析集合并去重,添加应用前必须获得用户明确确认。最终以 fenced JSON 输出,包含 added、skipped_existing、not_added、collection_created 和 credits_spent_estimate 字段。

只读降级路径:add_app 和 add_collection 需要 Advanced API / Custom 套餐,且相关路由没有功能门控,套餐限制不会以 FEATURE_DISABLED 形式出现,而可能表现为 AUTH_REQUIRED、VALIDATION_ERROR 或 UPSTREAM_ERROR。因此应始终完成搜索与去重,再尝试添加;若添加返回任何错误码,不要断言具体错误码,而应报告找到的候选引用,说明添加未能完成(可能是套餐限制),并把找到的引用列入 not_added,以便后续报告技能仍可指向它们(它们可能已被追踪)。

适用场景:需要批量或单个将应用纳入 AppFollow 监控体系,并为后续反馈分析和 ASO 分析准备结构化应用引用的工作流。

限制:搜索必须使用关键词而非链接或 ext_id;添加应用与新建集合受套餐限制,需用户逐次确认;关于各商店、套餐、价格或效果的具体细节,资料暂未提供。