hubab1/OpenASO

# OpenASO OpenASO 是一款用于应用商店优化研究的原生 macOS 应用。它可帮助您追踪所监控应用的 App Store 关键词排名、商店评分与评论、竞争对手可见度以及 Apple Ads 关键词热度。  ## OpenASO 功能介绍 - 根据商店、App Store ID、Bundle ID、标题、卖家和平台追踪 App Store 应用。 - 跨国家/地区创建关键词追踪并随时间记录排名快照。 - 检查每个关键词搜索返回的已排名竞争对手应用。 - 监控商店评分、评分历史和评论。 - 导入关键词列表并将关键词、关键词历史和评分数据导出为 CSV。 - 手动刷新或为陈旧的排名数据配置自动每日刷新。 ## 文档说明 托管文档是使用 OpenASO 的权威指南： - [快速入门](https://openaso.thirdtechapps.com/docs/getting-started/quickstart/) - [核心概念](https://openaso.thirdtechapps.com/docs/getting-started/concepts/) - [管理应用](https://openaso.thirdtechapps.com/docs/guides/manage-apps/) - [追踪关键词](https://openaso.thirdtechapps.com/docs/guides/track-keywords/) - [评分与评论](https://openaso.thirdtechapps.com/docs/guides/ratings-reviews/) - [Apple Ads](https://openaso.thirdtechapps.com/docs/guides/apple-ads/) - [导入与导出](https://openaso.thirdtechapps.com/docs/guides/import-export/) - [每日刷新](https://openaso.thirdtechapps.com/docs/guides/daily-refresh/) - [CSV 格式](https://openaso.thirdtechapps.com/docs/reference/csv-formats/) - [常见问题](https://openaso.thirdtechapps.com/docs/troubleshooting/common-issues/) ## 系统要求 - macOS 15.0 或更高版本 - 支持 Swift 6.2 的 Xcode 17 或更高版本 - Node.js（用于可选的 Apple Ads 网络会话助手） - Apple Ads 和 App Store Connect 凭据（用于需要账户支持的功能） ## 设置步骤 1. 克隆代码仓库。 2. 在 Xcode 中打开 `OpenASO.xcodeproj`，或通过命令行构建。 3. 如果希望将 Apple Ads API 凭据作为进程环境变量导出，可参考 `.env.example`。 4. 需要时，在应用的设置窗口中输入 Apple Ads 网络登录凭据和 App Store Connect 凭据。 已提交的开源构建版本默认关闭分析功能。省略 `OPENASO_OSS_BUILD` 的非开源构建版本默认保持分析功能启用。 ## 数据与凭据 OpenASO 使用 SwiftData 本地存储应用、关键词、评分、评论和指标数据。CSV 导出是在应用外使用这些数据的主要途径，特别适用于 AI 辅助评论分析、关键词研究、报告或电子表格。 ## 构建与测试 构建并运行： ``` ./script/build_and_run.sh ``` 运行测试： ``` xcodebuild test -project OpenASO.xcodeproj -scheme OpenASO -destination 'platform=macOS,arch=arm64' -derivedDataPath Build CODE_SIGNING_ALLOWED=NO ``` 启动冒烟检查： ``` ./script/build_and_run.sh --verify ``` ## Apple 服务说明 OpenASO 依赖公开的 App Store 端点、Apple Ads API、App Store Connect API 以及一个可选的基于浏览器的 Apple Ads 会话助手。这些服务可能会有速率限制、重定向、要求双因素认证或更改响应格式。应用会尽可能报告提供商错误，但某些功能需要有效的账户访问权限和当前的 Apple 服务行为。 ## 许可证 OpenASO 基于 MIT 许可证发布。参见 `LICENSE` 文件。

标签：Apple Ads分析, CSV数据处理, GNU通用公共许可证, macOS应用, MITM代理, Node.js, Swift开发, Xcode, 关键词排名跟踪, 市场监控工具, 市场竞争分析, 应用可见性分析, 应用商店优化, 应用商店监控, 应用商店研究, 应用排名优化, 数字营销, 数据分析工具, 数据导入导出, 移动应用分析, 移动端优化, 竞争对手监控, 自动刷新, 评分评论管理