OpenASO：macOS 应用商店 ASO 研究工具

项目简介

OpenASO 是一款原生 macOS 应用，用于 App Store Optimization（ASO）研究。它帮助你追踪所关注 App 在 App Store 的关键词排名、商店评分与评论、竞品曝光情况，以及 Apple Ads 的关键词热度。

主要功能

• 按 storefront、App Store ID、bundle ID、标题、开发者、平台追踪 App Store 应用。
• 跨国家创建关键词追踪，并随时间记录排名快照。
• 查看每个关键词搜索结果中出现的竞品应用排名。
• 监控商店评分、评分历史与评论。
• 导入关键词列表，把关键词、关键词历史与评分数据导出为 CSV。
• 手动刷新，或为过期的排名数据配置每日自动刷新。
• 通过 MCP 工具进行关键词发现与元数据定向分析：suggest_keywords、get_keyword_popularity、get_ranked_apps_for_keyword、audit_keyword_targeting、compare_metadata_draft、record_metadata_baseline、remove_keywords 等。这些工具只做读取与分析，不会自动发布元数据或修改 App Store 字段。

安装与使用

环境要求：macOS 15.0 或更高版本，Xcode 17 或更高版本（支持 Swift 6.2）。Apple Ads 与 App Store Connect 凭据用于需要账号的私有功能。

1. 克隆仓库。
2. 用 Xcode 打开 OpenASO.xcodeproj，或从命令行构建。
3. 如需通过环境变量导出 Apple Ads API 凭据，可参考 .env.example。
4. 在 App 的设置窗口连接 Apple Ads：填写 Apple Ads Platform API 凭据以获取关键词热度数据；Web Access 为可选项，用于补充 API 未返回的词，登录在应用内的 WebKit 窗口中打开，双因素认证与通行密钥的表现与 Safari 一致。也可以展开「Sign In With My Own Browser」，粘贴 Apple Ads 页面中的 cookie header。
5. 需要时在设置窗口填入 App Store Connect 凭据。

构建并运行：

./script/build_and_run.sh

启动冒烟检查：

./script/build_and_run.sh --verify

App、关键词、评分、评论与指标数据通过 SwiftData 保存在本地，CSV 导出是把数据带到应用外使用的主要方式。

注意事项

• OpenASO 依赖公开的 App Store 接口、Apple Ads API、App Store Connect API 以及可选的浏览器辅助 Apple Ads 会话。这些服务可能限流、重定向、要求双因素认证或改变返回格式，部分功能需要有效的账号访问权限。
• 匿名分析默认开启，可在设置中随时关闭；它只用于了解功能使用情况，不收集可识别信息，也不收集 App、关键词、评论、回复、凭据、搜索文本或国家等细节。
• 如果本地数据库无法打开，OpenASO 不会删除或替换现有文件，并会显示数据库位置。此时应先退出所有 OpenASO 进程与 MCP 进程，把整个 SwiftData 目录复制到安全位置（default.store、default.store-wal、default.store-shm 必须一起保留，不要单独删除或恢复某个文件），再用兼容的备份完整恢复，或用创建该数据库的兼容版本打开。
• 项目采用 MIT 许可证。

---

本作品整理自 GitHub 开源项目 hubab1/OpenASO，原作者 @hubab1，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。