Keywordista 是一款面向独立 iOS 开发者和小团队的 App Store 关键词排名追踪工具。它可以记录你的 App 在不同国家和地区 App Store 中针对指定关键词的排名变化，并保存历史数据，方便你持续观察 ASO 优化效果。数据保存在本机微服的持久化目录中，不依赖第三方 SaaS。 ## 适合谁使用 - 有 iOS App 上架 App Store，希望长期观察关键词排名的开发者。 - 需要比较同一关键词在不同国家或地区表现的小团队。 - 想记录关键词历史排名，而不是手动截图或维护表格的 ASO 运营人员。 - 想关注自己的 App 是否进入各地区免费榜 Top 100 的用户。 ## 核心功能 - 追踪 App Store 关键词排名。 - 支持多个国家和地区的 App Store。 - 添加多个 App 后，可以在不同 App 之间切换查看。 - 保存关键词排名历史，便于查看趋势。 - 显示搜索结果中的 Top Results，用于观察竞争 App。 - 计算 Difficulty 和 Entry Barrier，辅助判断关键词竞争强度。 - 可选接入 App Store Connect API，读取你在 App Store Connect 中配置的开发者关键词。 - 可选接入 Apple Search Ads API，用于关键词建议。 - 监控 App 是否进入各地区榜单 Top 100，并支持浏览器通知。 ### 2. 添加要追踪的 App 首次进入时，页面会提示没有已关注的 App。 操作步骤： 1. 点击左上角的 `Select app`。 2. 选择 `+ Add an app`。 3. 填入 App Store ID，例如 App Store 链接中的数字 ID。 4. 选择 Primary storefront，用于拉取 App 名称和图标。 5. 点击 `Add app`。 App Store ID 通常可以从 App Store 链接中找到。例如： ```text https://apps.apple.com/us/app/example/id1625870857 ``` 其中 `1625870857` 就是 App Store ID。 ### 3. 添加关键词 添加 App 后，回到主界面添加要追踪的关键词。 操作步骤： 1. 点击页面上方的 `+ Keyword`。 2. 在 `Term` 中输入关键词，例如 `flashcards`。 3. 在 `Countries` 中选择要追踪的国家或地区。 4. 点击 `Add in ... countries`。 如果一次选择多个国家，Keywordista 会为同一个关键词分别创建多个地区的追踪任务。 ### 4. 等待或手动刷新排名 关键词添加后，应用会查询对应 App Store 搜索结果，并记录你的 App 在该关键词下的排名。 ### App Store Connect API App Store Connect API 是可选配置。 配置后，Keywordista 可以读取你在 App Store Connect 中为 App 版本填写的关键词字段，并在界面中标识这些开发者关键词。 需要填写： - `Key ID` - `Issuer ID` - `.p8` 私钥内容 创建路径： ```text App Store Connect -> Users and Access -> Integrations -> App Store Connect API ``` 填写后点击 `Save`。连接成功后，可以点击 `Refresh now` 拉取最新关键词列表。 ### Apple Search Ads API Apple Search Ads API 是可选配置。 配置后，Keywordista 可以基于 Apple Search Ads 搜索词报告提供关键词建议。它适合已经在 Apple Search Ads 中投放过广告，并积累了搜索词数据的账号。 需要填写： - `Client ID` - `Client Secret` - `Org ID`，可选 如果没有 Apple Search Ads 账号，或账号中没有相关广告数据，可以先不配置这一项，不影响基础关键词排名追踪。 ### 榜单监控 点击顶部的 Charts 入口可以查看榜单监控页面。 这里的榜单不是关键词搜索排名，而是 App Store 的免费榜 Top 100。Keywordista 会检查已关注 App 在可用地区是否进入对应分类的免费榜 Top 100，并在发生以下变化时记录事件： - 进入榜单。 - 榜单排名变化。 - 退出榜单。 你可以在 Charts 页面点击： - `Check now`：立即检查榜单状态。 - `Re-probe availability`：重新检测 App 在哪些国家或地区可用。 - `Enable`：允许浏览器通知，榜单变化时接收提醒。 榜单检查是异步任务。点击 `Check now` 后，应用需要逐个请求 App 的可用地区和对应分类榜单，通常需要等待 30 秒到 2 分钟。检查完成后，如果 App 在任意可用地区进入 Top 100，页面会显示当前上榜记录；如果没有进入 Top 100，则页面会继续为空，这是正常情况。 例如使用中国区应用测试： - App：抖音 - App Store ID：`1142110895` - Primary storefront：`CN` - 推荐测试关键词：`抖音`、`微信`、`小红书` 添加抖音后进入 Charts 页面，点击 `Check now` 并等待检查完成。如果抖音当时仍在免费榜 Top 100 内，会出现类似以下记录： - `CN` 中国区免费榜：第 `#7` 左右 - `HK` 香港区免费榜：第 `#1` 左右 - `MO` 澳门区免费榜：第 `#2` 左右 榜单排名会随 App Store 实时变化，上述名次仅作为测试参考。