关于 search
该 AppFollow 技能通过商店搜索查找应用，并可将选定应用加入指定集合的跟踪，适用于管理应用清单的团队。它先去重并展示候选项，写入前要求明确批准；若添加失败，仍会输出找到的应用信息。
主要功能
- 01按应用名称搜索商店
- 02展示候选项并处理匹配确认
- 03检查集合中的重复应用
- 04经批准后添加应用跟踪
- 05输出已添加及未添加结果
适用场景
- 01查找待分析的应用商店条目
- 02将自有应用加入 AppFollow 集合
- 03把明确指定的竞争者加入跟踪
- 04写入受限时保留候选应用引用
MCP 相关
该技能使用 AppFollow MCP 工具搜索应用、读取集合和应用列表，并在用户批准后添加集合或应用。搜索和去重可在不写入时完成。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/search确认已加载。
详细介绍
search — 查找 + 跟踪应用
先阅读 using-appfollow（会话开启、写入流程、错误代码）。
输入
query：应用名称（自由文本搜索关键词）。store：短商店代码——搜索时使用as（App Store）或gp（Google Play）；add_app接受全部十种代码（using-appfollow→references/tool-map.md）。country（默认值为us）、collection（名称；如果不存在则创建）、locale。
流程
- 会话：
whoami（参见using-appfollow）。 - 规范化输入。 搜索仅接受自由文本关键词——ASO 搜索端点不接受商店 URL 或
ext_id。将查询精简为应用名称（如果粘贴了 URL，搜索前先将其缩减为应用名称／标题）。 - 搜索（只读，适用于任何方案）。 调用
aso_search_results（可选调用aso_search_suggestions，12 cr）。列出带编号的候选项。仅在有且只有一个标题完全匹配时自动选择；否则由用户选择。 - 确定集合。 调用
list_collections。如果目标集合尚不存在，依次执行add_collection_preview→ 用户批准 →add_collection。 - 去重（只读）。 调用
list_apps（apps_id= 目标集合的collectionId）；如果应用的extId已存在，则将其记录到skipped_existing并跳过添加。list_apps中的store使用全名（itunes=as，googleplay=gp）。 - 添加（写入——可能受方案限制）。 执行
add_app_preview→ 获得用户明确批准 → 使用完全相同的参数调用add_app：store（短代码）、ext_id、apps_id、locale（两字母国家／地区代码）。仅当用户说明该应用是竞争对手时才传入is_competitor: true（默认视为用户自己的应用）。 - 验证。 再次调用
list_apps；确认应用的extId现已出现；将集合的apps_id与其一并保留——报告技能通过apps_id+ext_id定位应用。 - 输出 JSON 代码块（如下）。
只读降级路径（写入受方案限制）
add_collection 需要 Advanced API / Custom 方案；它和 add_app 均不受功能门控限制——因此方案限制不会以 FEATURE_DISABLED 的形式返回。错误可能表现为 ACCESS_DENIED、VALIDATION_ERROR（调用 add_app 时，应用或竞争对手数量已达上限），或 UPSTREAM_ERROR。因此：
- 始终完成搜索和去重（只读操作，任何方案均可使用）。
- 尝试执行
add_*确认操作。 - 添加时若出现任何错误代码，不要断言具体错误代码。报告找到的候选项引用，明确说明无法完成添加（很可能是方案限制），并将找到的引用列入
not_added，以便报告技能仍可将其作为目标（它们可能已经在跟踪中）。
输出（围栏式 JSON）
{
"added": [{"store": "as", "ext_id": "389801252", "apps_id": 12345, "collection": "Core apps", "locale": "us", "title": "Example App"}],
"skipped_existing": [],
"not_added": [],
"collection_created": null,
"credits_spent_estimate": 13
}
评论
支持 Markdown