用途
本技能用于回答一个核心问题：在特定市场（单一区域）和平台（iOS、Android 或两者）上，目标应用实际在与谁竞争，以及自身的竞争位置如何。它仅使用 AppFollow MCP 能够产出的数据，通过应用商店搜索发现竞品，将选中的竞品添加到账户跟踪，并生成包含五个部分的竞争审计报告。
主要能力
- 竞品发现：基于品牌名和品类通用词，在指定国家/地区的应用商店搜索建议中播种搜索词，然后扫描最多 8 个搜索词的结果，按出现次数和平均排名对候选竞品排序。支持用户手动输入竞品名称，并通过一次搜索调用解析匹配。
- 添加跟踪：对每个选中的竞品，先调用 add_app_preview 展示将写入的内容，经用户明确批准后，使用相同参数和令牌调用 add_app 添加。写入后重新读取实际存储的国家。
- 竞争审计（五个部分）：
- 搜索份额：基于扫描结果，计算每个应用在 N 个搜索词中的覆盖率、出现时的平均排名、前三名比率，不加权。
- 新发现竞品：对比扫描中出现的 ext_id 与已跟踪应用列表，列出在目标应用自身搜索词上排名更高但未跟踪的应用。
- 分类排名：调用 get_rankings 获取每个应用在指定国家/设备的分类排名，标记分类不匹配情况。
- 近30天平均评分：调用 get_ratings_history，type 设为 "diff" 获取增量平均评分，而非累计平均。
- 近30天新评分星级分布：同一次调用中获取新评分总数及 1-5 星分布，重点报告负面（1-2星）占比，并在 App Store 上提供基于累计评分数的相对读数。
- 输出：生成 competitors-<app-slug>-<country>-<date>.html 报告和 findings.json（遵循 appfollow.toolkit.findings/v1 架构），每个发现都附带证据数组，可追溯至具体 MCP 调用。
使用方式
技能以交互方式运行：首先询问应用（名称、商店 URL 或 ext_id）、平台和区域（必须恰好一个两位国家代码），然后解析目标应用（在账户集合中查找）。若未找到，发现步骤仍可运行，但需要跟踪的审计部分将不可用。随后执行发现扫描、选择、添加跟踪（可选）和审计，最后输出报告。整个过程依赖 AppFollow MCP 接口，需先阅读 using-appfollow 技能了解会话开启、写入仪式和错误代码。
适用场景
- 应用发布商或营销团队需要了解特定市场中的实际竞争对手。
- 进行竞争审计，评估自身在搜索中的可见性、排名和评分健康状况。
- 发现未跟踪但排名靠前的潜在竞品。
- 监控竞品评分变化趋势和负面评价流入。
限制
- 区域单一性：必须指定一个区域，结果因市场差异显著，混合答案无意义。
- 跟踪依赖：除 6.1 和 6.2 节外，审计部分需要目标应用在账户中跟踪；未跟踪应用在 get_reviews、list_keywords 上返回 AUTH_REQUIRED (403)，在 get_ratings_history 上返回空体 VALIDATION_ERROR (422)。
- 槽位消耗：添加竞品会占用 My Apps 槽位，且 MCP 中无移除工具，添加后只能通过 AppFollow 仪表板删除。槽位上限无接口可查，list_collections.count_apps 与 list_apps 结果可能不一致，因此不应给出具体数字。
- 计划限制：add_app 需要 Advanced API / Custom 计划，错误可能以 AUTH_REQUIRED、VALIDATION_ERROR 或 UPSTREAM_ERROR 形式出现，不应归因于具体原因。
- 存储国家可能不符：请求的 locale 可能被存为不同国家，写入后必须用 list_apps 读回确认。
- 排名空列表：get_rankings 返回空通常表示应用未进入该国家分类榜，而非数据未就绪；仅在整批调用均为空时才考虑解析周期。
- 评分历史国家过滤：get_ratings_history 仅接受集合配置的国家代码，多代码会合并为单一序列，必须每次调用一个代码。调用前需对比 list_collections.countries，不匹配时提示用户需在仪表板添加区域。
- Google Play 限制：品牌词精确查询的首行 rating_avg 可能为 0，不应从品牌词行读取评分；Google Play 搜索行不包含 rating_cnt，因此 6.5 节的相对读数仅适用于 App Store。
- App Store 搜索富化限制：仅前约 12 行富化，更深行只有 ext_id，因此 iOS 上“不在前 N 名”的结论仅限该窗口。
- 同品牌不同应用：跨商店和市场的同一品牌可能对应不同应用 ID，应按市场匹配。
- 超出范围：不提供安装量、下载量、MAU、收入、市场份额、竞品元数据（描述、关键词字段）、关键词级对比、Apple Search Ads 定向列表等。
- 降级路径：任何部分失败不会导致整个运行失败，跳过该部分并记录错误代码，继续执行。