OpenASO is a native macOS app for App Store Optimization research. It helps track App Store keyword rankings, storefront ratings and reviews, competitor visibility, and Apple Ads keyword popularity for the apps you monitor.

• Track App Store apps by storefront, App Store ID, bundle ID, title, seller, and platform.
• Create keyword tracks across countries and record ranking snapshots over time.
• Inspect ranked competitor apps returned for each keyword search.
• Monitor storefront ratings, rating history, and reviews.
• Import keyword lists and export keyword, keyword history, and rating data as CSV.
• Run manual refreshes or configure an automatic daily refresh for stale ranking data.

For project development, see Contributing to OpenASO.

The hosted docs are the canonical guide for using OpenASO:

• Quickstart
• Core concepts
• Manage apps
• Track keywords
• Ratings and reviews
• Apple Ads
• Import and export
• Daily refresh
• CSV formats
• Common issues

• macOS 15.0 or later
• Xcode 17 or later with Swift 6.2 support
• Node.js for the optional Apple Ads web session helper
• Apple Ads and App Store Connect credentials for private account-backed features

1. Clone the repository.
2. Open OpenASO.xcodeproj in Xcode, or build from the command line.
3. Use .env.example as a reference if you want to export Apple Ads API credentials as process environment variables.
4. Enter Apple Ads web login credentials and App Store Connect credentials in the app Settings window when needed.

Analytics is off by default for checked-in OSS builds. Non-OSS builds that omit OPENASO_OSS_BUILD keep analytics enabled by default.

OpenASO stores app, keyword, rating, review, and metric data locally with SwiftData. CSV export is the primary path for using that data outside the app, especially for AI-assisted review analysis, keyword research, reporting, or spreadsheets.

If OpenASO cannot open its local database, it does not delete or replace the existing files and shows the database location when available. Before attempting recovery:

1. Quit every running OpenASO app and MCP process.
2. Copy the entire SwiftData directory to a safe location. Keep default.store, default.store-wal, and default.store-shm together; do not delete or restore an individual file.
3. Restore the complete directory from a compatible backup, or open it with the compatible OpenASO version that created it.
4. Reopen OpenASO only after the complete directory is back in place.

Keep the backup until the restored database has opened and its contents have been verified. OpenASO does not automatically reset or replace a database that fails to open.

Build and run:

./script/build_and_run.sh

Run tests:

xcodebuild test -project OpenASO.xcodeproj -scheme OpenASO -destination 'platform=macOS,arch=arm64' -derivedDataPath Build CODE_SIGNING_ALLOWED=NO

Launch smoke check:

./script/build_and_run.sh --verify

OpenASO relies on public App Store endpoints, Apple Ads APIs, App Store Connect APIs, and an optional browser-backed Apple Ads session helper. These services may rate-limit, redirect, require two-factor authentication, or change response formats. The app reports provider errors where possible, but some features require valid account access and current Apple service behavior.

OpenASO is available under the MIT License. See LICENSE.