ShipASO

The reason → execute ASO loop for App Store and Google Play.

The product is ShipASO; the codebase, this repo, and the Cloudflare services are named store-ops.

Every other AI ASO tool does one half. Advisory tools (and most "AI ASO agents") reason about your listing then stop at the copy-paste boundary — and they depend on a paid data API. Deploy CLIs (Fastlane, raw APIs) execute but have no ASO brain. ShipASO does both, on both stores, with no paid data dependency.

The open lane: Google Play. There is no public tool that operationally optimizes a Google Play Console listing end-to-end. ShipASO does iOS and Android.

Install — any coding agent

The loop runs in your editor, on your machine, with your credentials. The 31 skills are plain Markdown runbooks over plain CLI tools, and the engine is standard-library Python — so nothing here is tied to one vendor.

Any agent (Codex, Cursor, Copilot, Gemini, Amp, Aider…):

git clone https://github.com/airowe/store-ops && cd store-ops

Then point your agent at AGENTS.md — most read it automatically. That file is the front door: the skills index, the credential rules, and how to run the engine. Cursor, Copilot, and Gemini also get a pointer file that redirects there.

Claude Code additionally has a plugin installer:

/plugin marketplace add airowe/store-ops
/plugin install store-ops@store-ops

Either way, audit any listing — read-only, no credentials, no keys:

python3 lib/aso_rank_check.py --bundle com.burbn.instagram "photo,stories,reels"

You get a per-field ASO score of your live listing and the exact next skill to run for each gap. → Full walkthrough + what you'll see: https://shipaso.com/install

Zero install: point your agent at the hosted MCP

No clone, no key, no account:

claude mcp add shipaso --transport http https://api.shipaso.com/mcp

Your agent immediately gets preview_app — a real, measured teaser of any App Store app (audit grade, lead organic rank, how many keywords crack the top 10) — and proof, the aggregate rank-win record. The other ten tools (listing audit, keyword gaps, rank check, screenshot scoring, competitor watch, war room, localization gaps, draft copy, and the two Google Play audits) unlock with a free shipaso_ key from app.shipaso.com → Settings → Agent access; re-add the server with --header "Authorization: Bearer <key>". MCP is vendor-neutral, so Cursor and any other MCP client work the same way. Every tool is read or draft; nothing pushes to a live store. Details: skills/shipaso-mcp/SKILL.md.

What's in this repo

ShipASO comes in two forms — run it yourself, or let the hosted agent run it for you:

The plugin is the funnel (discover the agent by running it); the hosted app is the product (it keeps working while you build). Same engine, two surfaces.

Run it yourself, or let it run itself:

• Free, in your editor — install the plugin and run the loop yourself in whichever agent you already use. Your credentials, your machine, no cost. Start here ↓ (Install).
• Hosted + autonomous — connect an app by bundle id and an agent runs the loop on a weekly schedule: re-checking ranks, watching competitors, drafting the next optimization, surfacing each decision for you to approve. It's live: https://app.shipaso.com

What it does

audit  →  research keywords  →  optimize to char limits  →  push  →  verify rank
(asc/gplay) (no paid API)        (ready copy + commands)   (you approve) (free, over time)

The full loop, not half of it. The data tools (Astro, AppTweak, Sensor Tower) stop at "here's what to do" and leave you in the App Store Connect form. ShipASO picks the keywords, writes the metadata, hands you the push, and then verifies the rank actually moved — the only piece that closes the loop and the one nobody else ships.

/store-ops myapp                     # full chain, both stores
/store-ops myapp --store playstore   # Google Play only
/store-ops myapp --audit-only        # just score the live listing

Try it in 30 seconds (no credentials, no setup)

The verify/watch half runs on the free public iTunes API — try it on any live app right now:

# organic App Store rank for some keywords (any app's bundle id)
python3 lib/aso_rank_check.py \
    --bundle com.burbn.instagram "photo,stories,reels"

# score an app's screenshots against ASO best practice
python3 lib/aso_screenshot_score.py \
    --app instagram --bundle com.burbn.instagram

# resolve a non-US market's keyword-volume + rank constants
python3 lib/aso_locale.py --locale de-DE

Run the test suites (standard-library only — no network, no keys):

python3 lib/run_tests.py

Skills

Reasoning (the IP):

More reasoning — audit, risk, and research:

Execution — App Store Connect (via the asc CLI):

Execution — Google Play (via the gplay CLI):

Hosted:

Every asc-* / gplay-* skill that writes asks which API key to use before it does — asc resolves credentials from a default profile, and with more than one registered a push through the wrong one succeeds against the wrong account.

Principles

• No paid data dependency — reasons over free + owned data (store autocomplete, public listings, your own asc/gplay exports). Every credentialed source is an optional accelerator with a free fallback, never a gate:
  • volume — bring your own Apple Search Ads / Google Keyword Planner keys for real search-popularity numbers; without them, an honest autocomplete-rank proxy.
  • scrape — bring a context.dev key for clean competitor-listing + brand-data scraping; without it, WebFetch / Crawl4AI. You bring your own keys (it's your data, ToS-clean); the plugin never resells data.
• Both stores, official APIs.
• Nothing ships without your approval — reasoning writes copy + prints commands; you run the push.
• App-agnostic — --app <slug> + a context.md. No hardcoded apps, no secrets in the plugin.

Requirements

• To execute: the asc and gplay CLIs installed + authed with your own developer credentials.
• The reasoning skills work standalone (they emit commands you can run later).

Install

/plugin marketplace add airowe/store-ops
/plugin install store-ops@store-ops

Open-core — what's free vs. hosted

The plugin is free and MIT-licensed, forever. Everything above — the full audit → research → optimize → push → verify loop, both stores, all 31 skills — runs locally with your own credentials at no cost. Use it, fork it, ship apps with it. That's the whole product for anyone who's comfortable in a terminal.

The line for the hosted tier is convenience, never capability. The free plugin is complete; the paid tier sells you out of the setup pain and the remembering. The hosted agent is live now at https://app.shipaso.com — connect an app and watch the loop run on a schedule.

The tiers:

We will never resell Apple/Google data through a shared account (that breaks their ToS) — the hosted tier is BYO-credentials too, and we never hold your store credentials; the push is a generated-commands handoff. What you pay for is the guided onboarding, the scheduler, and the history. The differentiator isn't the data — everyone has Apple's popularity numbers. It's that ShipASO ships the metadata and proves the rank moved.

→ Try the hosted agent: https://app.shipaso.com

License

MIT — see LICENSE.