asosuite

# ASO Suite CLI

Use `asosuite` to run ASO workflows across iPhone, iPad, Mac, Apple TV, Apple Watch, and VisionOS apps: discover keywords with popularity and difficulty data, track keyword position over time, and monitor ratings, editorial features, and chart appearances with machine-readable output.

## Setup

Install:

```bash
npm install -g asosuite
asosuite help
```

Authenticate:

```bash
asosuite login
```

## JSON-first rule

For easier parsing, always pass `--json` on every command that supports it.
Commands that do not take `--json`: `login`, `logout`.

## Defaults

- `region=US`
- `platform=iphone`
- `period=30` for `charts` and `ratings`
- Supported platforms: iPhone (`iphone`), iPad (`ipad`), Mac (`mac`), Apple TV (`appletv`), Apple Watch (`watch`), VisionOS (`vision`)

## Command reference (all commands)

- `asosuite login`
- `asosuite logout`
- `asosuite subscription [--json]`
- `asosuite search-apps [--json] [--region <REGION>] [--platform <PLATFORM>] <query...>`
- `asosuite list-apps [--json]`
- `asosuite keywords [--json] [--region <REGION>] [--platform <PLATFORM>] [--app <APP_ID_OR_URL>] <keyword...>`
- `asosuite track-app [--json] [--region <REGION>] [--platform <PLATFORM>] --app <APP_ID_OR_URL>`
- `asosuite untrack-app [--json] [--region <REGION>] [--platform <PLATFORM>] --app <APP_ID_OR_URL>`
- `asosuite plan-app [--json] --name <APP_NAME> [--id <PLANNED_APP_ID>] [--region <REGION>] [--platform <PLATFORM>]`
- `asosuite unplan-app [--json] --id <PLANNED_APP_ID> [--region <REGION>] [--platform <PLATFORM>]`
- `asosuite tracked-keywords list [--json] [--region <REGION>] [--platform <PLATFORM>] [--page <NUMBER>] [--sort <FIELD>] [--order <asc|desc>] --app <APP_ID_OR_URL_OR_PLANNED_ID>`
- `asosuite tracked-keywords add [--json] [--region <REGION>] [--platform <PLATFORM>] --app <APP_ID_OR_URL_OR_PLANNED_ID> <keyword...>`
- `asosuite tracked-keywords remove [--json] [--region <REGION>] [--platform <PLATFORM>] --app <APP_ID_OR_URL_OR_PLANNED_ID> <keywor...