Wow Keywords MCP

Local MCP server (107 tools) inside the Wow Keywords desktop app: App Store keyword research, ASO audits, listing localization in 50 languages and upload to App Store Connect or Google Play.

Dokümantasyon

Connect

Pick your agent. Wow Keywords needs to be installed and activated.

Claude Code

  1. 1 One click: in Wow Keywords click MCP in the sidebar and press Add next to it. The app writes the config and fixes it after you move the app.
  2. 2 Or run this once:
    claude mcp add --scope user wow-keywords \
      -e ELECTRON_RUN_AS_NODE=1 \
      -- "/Applications/Wow Keywords.app/Contents/MacOS/Wow Keywords" \
         "/Applications/Wow Keywords.app/Contents/Resources/mcp.cjs"
    
  3. 3 Check: claude mcp list shows wow-keywords. Start a new Claude Code session.

Try asking

Start a new session in your agent, then ask in plain words.

  • “Which of my apps lost the most ranks since the last check?”
  • “Where is my app outside the top 10 in Germany, and what would it take to get in?”
  • “Brainstorm keywords for a keto calorie tracker and check them in the US.”
  • “Compare narrower product directions for my app idea using checked keywords and competitors.”
  • “Add Japan and Korea to my app and check every keyword there.”
  • “Run the ASO audit for my app and show me the three options side by side.”

How long jobs run

  • Checks, brainstorms and audits run inside the app. The tool that starts one answers at once.
  • The agent follows along with wait, which returns within 50 seconds, then status. It repeats until the job is done.
  • You can watch the same job in the Wow Keywords window, and stop it there.
  • audit_publish writes to App Store Connect only when you ask. It never submits for review.

Workflows

The calls an agent makes for common jobs.

Track your own apps

asc_apps → app_addAll → wait → overview

Track a competitor

store_search → app_add → wait

Research a niche without an app

session_create → wait → board_get

Refine an idea before building

session_create → wait → session_opportunities → wait → board_get

Refresh ranks

check_run → wait → board_get

Where an app stands

audit_overview_run → wait → audit_overview_get → app_facts

Reposition an app

app_context → keywords_brainstorm → wait → board_get → audit_english → wait → audit_get

ASO audit

audit_english → wait → audit_get → audit_choose → audit_localize → wait → audit_get

Save and recover audit edits

audit_draft_set → audit_undo → audit_redo → audit_get

Promo text and description

audit_copy_settings → audit_copy_write → wait → audit_copy_localize → wait

Final review before upload

audit_final_review → wait → audit_get → audit_final_undo

Publish the audit

publish_preview → next_version → audit_publish → wait

Export to fastlane

audit_get → audit_fastlane

App Store screenshots

screens_capture → screens_import → screens_headings → wait → screens_localize → wait → screens_render → wait → screens_review → screens_publish → wait

Tools (114)

Open a tool for its full description and parameters.

Read

status Read

Tracked apps (ids, kind, store, linked app, markets; board_get app has the icon and brief), connections and jobs (every running one and the 20 latest; wait with appId has one app's).

Tracked apps (ids, kind, store, linked app, markets; board_get app has the icon and brief), connections and jobs (every running one and the 20 latest; wait with appId has one app's). Start here.

No parameters.

overview Read

One line per tracked entry: kind, store (appstore or play), linked (the same app in the other store, app_link; null = none), markets, keyword count, phrases checked vs never checked, last check, the Audit tab's score (auditScore, null = not run or nothing measured; auditAt), the Optimize stage (audit: none, options, chosen, localized, published), running jobs and, as the window's Dashboard shows them, ranks (every tracked country summed: visibility = 0–100, the Audit's Rankings formula over every country (keywords with more demand count more), top10 / top3 = phrases in the top 10 / top 3, ranked = phrases found at all, avgRank = their average position, measured = phrases searched) with from = the same numbers on the range's first day with a search (day; null = no earlier day in the range), and for own apps counts (what the store itself counted over the range, as the Dashboard cards show it: downloads = first-time downloads / Play acquisitions, conversion = downloads ÷ page views in %, each with before = the same days one span earlier, null when not on file; app_analytics has the detail).

One line per tracked entry: kind, store (appstore or play), linked (the same app in the other store, app_link; null = none), markets, keyword count, phrases checked vs never checked, last check, the Audit tab's score (auditScore, null = not run or nothing measured; auditAt), the Optimize stage (audit: none, options, chosen, localized, published), running jobs and, as the window's Dashboard shows them, ranks (every tracked country summed: visibility = 0–100, the Audit's Rankings formula over every country (keywords with more demand count more), top10 / top3 = phrases in the top 10 / top 3, ranked = phrases found at all, avgRank = their average position, measured = phrases searched) with from = the same numbers on the range's first day with a search (day; null = no earlier day in the range), and for own apps counts (what the store itself counted over the range, as the Dashboard cards show it: downloads = first-time downloads / Play acquisitions, conversion = downloads ÷ page views in %, each with before = the same days one span earlier, null when not on file; app_analytics has the detail). Use it to plan work across all apps before reading a board.

kind mine | competitor | brainstorm

Only this kind.

range 7d | 30d | 90d

The ranks' change window. Default 7d.

app_insights Read

One app's Overview tab, Progress view (the Dashboard preview in full) over a range: the five measures now and their move (visibility 0–100 = the Audit's Rankings formula over every tracked country, keywords with more volume count more; top10; top3; avgRank; auditScore), top keywords by volume, keywords near the top 10 (ranks 11–30, most volume first), the biggest moves up and down (weighted like visibility) and each country's measures.

One app's Overview tab, Progress view (the Dashboard preview in full) over a range: the five measures now and their move (visibility 0–100 = the Audit's Rankings formula over every tracked country, keywords with more volume count more; top10; top3; avgRank; auditScore), top keywords by volume, keywords near the top 10 (ranks 11–30, most volume first), the biggest moves up and down (weighted like visibility) and each country's measures. Each keyword: text, country, label (the English gloss, only when it differs from text), rank now and at the range start (null = not ranked), volume, difficulty. country narrows it to one store.

appId requiredstring

App id from status ("bs_…" = brainstorm).

range 7d | 30d | 90d

Default 30d.

country string

Optional store code, e.g. us.

board_get Read

The app’s keyword grid, compact: mainLocale (the main listing the Audit and Optimize judge; mainLocked = Optimize has drafts from it), auditScope (main or all), home (the market keywords pivot on: the main listing’s store when tracked, else the first market; a brainstorm’s is its first market; english false = rows are named by its phrase and new countries are translated from it), listings, then one row per keyword (id, name = what the window calls it, label = English gloss, source, hidden, mean volume) with one cell per market (phrase, rank, earlier rank, volume proxy 0-100 (relevant apps in search results, not search counts), difficulty 0-100, verdict; rank null = not in the first 200; checked false = never searched).

The app’s keyword grid, compact: mainLocale (the main listing the Audit and Optimize judge; mainLocked = Optimize has drafts from it), auditScope (main or all), home (the market keywords pivot on: the main listing’s store when tracked, else the first market; a brainstorm’s is its first market; english false = rows are named by its phrase and new countries are translated from it), listings, then one row per keyword (id, name = what the window calls it, label = English gloss, source, hidden, mean volume) with one cell per market (phrase, rank, earlier rank, volume proxy 0-100 (relevant apps in search results, not search counts), difficulty 0-100, verdict; rank null = not in the first 200; checked false = never searched). Top 5 competitors per market and the AI Agent chat (its last 20 messages). Pass storefront for one market only. term_get has a cell’s top apps and history. A cell’s variant is the same keyword’s second phrase in that market (keyword_add scope english beside a local phrase), measured on its own.

appId requiredstring

App id from status ("bs_…" = brainstorm).

storefront string

Storefront code, e.g. "es" (markets_list).

term_get Read

Everything about one keyword in one market: the phrase, rank history, volume and difficulty breakdown, and the top apps for that search (name, subtitle, ratings, whether each counts toward volume).

Everything about one keyword in one market: the phrase, rank history, volume and difficulty breakdown, and the top apps for that search (name, subtitle, ratings, whether each counts toward volume).

appId requiredstring

App id from status ("bs_…" = brainstorm).

keywordId requiredstring

Keyword id from board_get.

storefront requiredstring

Storefront code, e.g. "es" (markets_list).

markets_list Read

Every storefront code with its country, language and App Store Connect locales.

Every storefront code with its country, language and App Store Connect locales. main = one of the 52 stores the window offers; prefer those. size (main stores only) = estimated market: population, smartphone users and iPhone users in millions, iOS share %, GDP per person at PPP in thousand $, score 0–10 (√iPhone users × purchasing power^1.5 × access, log scale, USA = 10) and share % of all main stores, access 0–1 = share of the market that can actually buy (restriction says why; Russia and India are cut); rounded estimates, not measurements. play = how a Google Play app is searched there (hl = language, listing = Play listing language); null = no Google Play (China).

No parameters.

ai_status Read

Which AIs can run here (Claude Code, Codex, OpenCode, Gemini (Antigravity or Gemini CLI), Cursor, Grok, Ollama, OpenRouter): installed (OpenRouter: a key is saved), signed in (OpenRouter: the key is accepted), and their models with reasoning levels.

Which AIs can run here (Claude Code, Codex, OpenCode, Gemini (Antigravity or Gemini CLI), Cursor, Grok, Ollama, OpenRouter): installed (OpenRouter: a key is saved), signed in (OpenRouter: the key is accepted), and their models with reasoning levels. Pass one as ai on AI tools, or save it with settings_save.

No parameters.

ai_calls Read

This app’s own AI calls over the last days (default 7): per AI and model and per task, calls, retries, failures and tokens exactly as each CLI reported them (null = not reported, never 0), plus the 20 newest calls.

This app’s own AI calls over the last days (default 7): per AI and model and per task, calls, retries, failures and tokens exactly as each CLI reported them (null = not reported, never 0), plus the 20 newest calls. Not plan limits (ai_status) and not your own tokens.

days integer

wait Read

Returns status immediately when no matching job is running.

Returns status immediately when no matching job is running. Otherwise waits until a job changes state (or one of appId’s jobs, when given) or seconds pass (default and max 50). With appId the answer holds only that app and its 15 latest jobs; without it, running jobs and the 20 latest, and only the apps those jobs belong to (status lists them all). Call again while jobs run; a finished fetch can start brainstorming, then a check, so inspect all jobs for the app.

appId string

App id from status ("bs_…" = brainstorm).

seconds integer

5–50.

Apps

store_search Read

Top 8 apps in one App Store (default us) for a name or niche, or the one app an App Store link names, from the store the link names: id, name, developer, ratings, whether it is tracked and whether the App Store Connect key sees it (mine).

Top 8 apps in one App Store (default us) for a name or niche, or the one app an App Store link names, from the store the link names: id, name, developer, ratings, whether it is tracked and whether the App Store Connect key sees it (mine). Track one with app_add. store play searches Google Play in that country instead (its first page, at most 8 here; a Play link shows that app; installs instead of ratings).

term requiredstring

Name, niche or App Store link.

storefront string

Storefront code, e.g. "es" (markets_list).

store appstore | play

Which store: appstore (default) or play (Google Play).

asc_apps Read

Every app the connected App Store Connect accounts can see: id, name, bundle id, account (key id), whether it is on the App Store and already tracked.

Every app the connected App Store Connect accounts can see: id, name, bundle id, account (key id), whether it is on the App Store and already tracked. null = no key connected. Track one with app_add and its id. store play lists the apps the connected Google Play service accounts see instead (Play Developer Reporting API; problems says when that API is off and where to turn it on); packages pastes package names to check while it is off (each one Play Console edit). Track one with app_add, store play.

store appstore | play

Which store: appstore (default) or play (Google Play).

packages string[]

Optional Android package names to look for in the Google Play accounts (store play).

app_add WriteBackground

Track an app from its App Store URL or numeric id; an unreleased app in the owner’s App Store Connect account is added by its id (asc_apps).

Track an app from its App Store URL or numeric id; an unreleased app in the owner’s App Store Connect account is added by its id (asc_apps). A URL naming a country (apps.apple.com/ru/…) makes that store the app’s main one: its name, first country, and the audit’s default main listing. Reads every locale’s listing next (App Store Connect when a key is connected). kind: mine (the owner’s app) or competitor; by default mine when the App Store Connect key sees the app, else competitor. store_search finds ids by name. Adding runs setup by itself: reads listings, brainstorms, checks the main listing’s store, then the first Audit (audit_overview_get; with audit all, then every country and a summary). Wait for those jobs instead of starting a duplicate brainstorm or audit. markets scopes this app’s initial work; brief gives the AI product direction before it starts; ai picks the AI for setup. To track a competitor from the Audit, pass its id with kind competitor. Returns as soon as the work starts. Call wait, then status, to follow it. Google Play: pass store play with a Play link (play.google.com/store/apps/details?id=…; &gl=de names its main country) or a package name; a link names its own store whatever store says (a Play link = play, an App Store link = the App Store). Play apps are tracked in the countries Play serves (no China); rank is only Play's first page (null = not in the top outOf), volume and difficulty stand on installs.

url requiredstring

App Store URL or id, or a Google Play link or package name (store play).

kind mine | competitor

Optional.

mainLocale string

Optional main listing (App Store language, e.g. de-DE) the Audit and Optimize judge. Default: the URL's store language, or App Store Connect's primary language.

audit main | all

What the first audit (started after setup) covers: main = the main listing's country only (default; with audit main given, only that country is tracked and checked, whatever markets says), all = then every tracked country and a summary across them.

folder string

Optional sidebar folder: "mine", "research" or a folder id (status settings.folders). Default: My apps when the key sees it, else Research.

markets string[]

Initial storefronts for this app only. Omit to use settings.defaultMarkets; choose a focused set before the first automatic check.

brief string

Product facts, upcoming changes and preferred positioning, saved before the first brainstorm. Distinguish upcoming features from the current listing. Read back in status or board_get.app.brief.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

store appstore | play

Which store: appstore (default) or play (Google Play).

app_context Write

Save or replace the app’s product brief: product facts, upcoming changes and preferred positioning.

Save or replace the app’s product brief: product facts, upcoming changes and preferred positioning. All later brainstorms, researcher conversations and ASO audits use it. This does not start jobs or erase measurements. Empty brief clears it. For directions that apply to one audit only, use audit_english request. Read back in status or board_get.app.brief.

appId requiredstring

App id from status ("bs_…" = brainstorm).

brief requiredstring

Product brief, up to 4000 characters; empty clears.

app_addAll WriteBackground

Track every on-store app the App Store Connect key sees that is not tracked yet, as the owner’s apps.

Track every on-store app the App Store Connect key sees that is not tracked yet, as the owner’s apps. Returns as soon as the work starts. Call wait, then status, to follow it.

No parameters.

app_kind Write

Move an app between My apps (mine) and Research (competitor).

Move an app between My apps (mine) and Research (competitor). Both kinds can be audited and exported; only connected owner apps can publish to App Store Connect.

appId requiredstring

App id from status ("bs_…" = brainstorm).

kind requiredmine | competitor

Kind.

app_link Write

Link an app to the same app in the other store (App Store ⇄ Google Play), for owner and research apps alike; linkedId null unlinks.

Link an app to the same app in the other store (App Store ⇄ Google Play), for owner and research apps alike; linkedId null unlinks. A link only groups them (one sidebar row, a store switch, status apps[].linked): keywords, drafts, screenshots and uploads stay per store, and nothing is done in the other store unless the owner asks for it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

linkedId requiredstring | null

The other store’s app id (App Store numeric id or Google Play package name), or null to unlink.

app_move Write

Move an entry to a sidebar folder and place it in that folder’s order.

Move an entry to a sidebar folder and place it in that folder’s order. to: "mine" (My apps; makes it the owner’s), "research" (Research; competitors and apps being studied), "brainstorms" (brainstorms only) or an owner-made folder id, where it keeps its kind. before: the entry it lands above; omit for last.

appId requiredstring

App id from status ("bs_…" = brainstorm).

to requiredstring

Folder.

before string

Optional entry id it goes above.

folder_create Write

Make a sidebar folder.

Make a sidebar folder. Returns its id. Move entries in with app_move.

name requiredstring

Folder name.

folder_rename Write

Rename an owner-made sidebar folder.

folder_remove WriteDestructive

Delete an owner-made sidebar folder.

Delete an owner-made sidebar folder. Its entries go back to My apps, Research or Brainstorms; nothing is deleted.

folderId requiredstring

Folder id.

import_astro WriteBackground

Import Astro (the Mac ASO tracker) as evidence: per app, every phrase it tracked with Astro’s popularity, difficulty, rank and best rank (astro_get).

Import Astro (the Mac ASO tracker) as evidence: per app, every phrase it tracked with Astro’s popularity, difficulty, rank and best rank (astro_get). Nothing is added to the board; the researcher and brainstorms use it to suggest keywords. Apps not tracked here are added (with their Astro stores) and brainstormed with it. Reads Astro’s own database on this Mac, or the CSV from Astro’s Export all keywords (file). preview: counts only, nothing changes. Returns as soon as the work starts. Call wait, then status, to follow it.

file string

Optional absolute path to an Astro keyword CSV export.

preview boolean

Only count what would come across.

folder string

Optional folder for apps that are new here: "mine", "research" or a folder id.

astro_get Read

What Astro (another ASO tracker) followed for this app, saved by import_astro: per store and phrase, Astro’s popularity (Apple search popularity 5–100; 5 = the floor), difficulty, current rank and best rank in the last 90 days (null = not ranked).

What Astro (another ASO tracker) followed for this app, saved by import_astro: per store and phrase, Astro’s popularity (Apple search popularity 5–100; 5 = the floor), difficulty, current rank and best rank in the last 90 days (null = not ranked). Evidence for which keywords to add (phrases the app already ranks for, with popularity above 5), not tracked keywords. The researcher and brainstorms read it too.

appId requiredstring

App id from status ("bs_…" = brainstorm).

app_markets Write

Set the tracked countries, in display order; all show in the grid.

Set the tracked countries, in display order; all show in the grid. Newly added countries get every keyword translated (AI) and checked; dropped ones keep their phrases for later. Any markets_list code works (App Store); one with main false is a More country: ranks and volume only, no per-country audit.

appId requiredstring

App id from status ("bs_…" = brainstorm).

markets requiredstring[]

Storefront codes.

app_mainListing Write

Set the main listing (an App Store language, e.g.

Set the main listing (an App Store language, e.g. en-US, de-DE) that the Audit and Optimize judge (the window does this in Rerun). Its store is added to the tracked countries if missing. Refused once Optimize has drafts from another language unless clearDrafts (clears Optimize steps 1–2; promo and description stay). Read back as board_get.mainLocale.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale requiredstring

App Store language code (en-US, de-DE, ja …).

clearDrafts boolean

Clear Optimize's name/subtitle/keyword drafts from another language first.

app_autoCheck Write

Set how often this app is re-checked on its own.

Set how often this app is re-checked on its own. default = follow settings autoCheck (the default for every app).

appId requiredstring

App id from status ("bs_…" = brainstorm).

autoCheck requireddefault | off | daily | weekly | biweekly | monthly

Interval.

app_fetch WriteBackground

Re-read the app’s name, subtitle, keyword field, promotional text and description per locale (the last three only from App Store Connect).

Re-read the app’s name, subtitle, keyword field, promotional text and description per locale (the last three only from App Store Connect). Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

app_remove WriteDestructive

Stop tracking an app and delete its keywords.

Stop tracking an app and delete its keywords.

appId requiredstring

App id from status ("bs_…" = brainstorm).

Analytics

app_analytics Read

One own app's Analytics (the Overview tab's Analytics view) over a range, as the store counted it (totals from the store's own reports, never unique devices): impressions (App Store only: the app's icon shown in a list such as search results or charts; websites and other apps have none, they land on the page), pageViews (App Store: views of the product page, store sheets included / Play Console's Store listing visitors), downloads (App Store Connect's First-Time Downloads / Play Console's Store listing acquisitions) and conversion (% downloads of pageViews, the same for every source, country and store; on Google Play that is Play Console's own rate; on the App Store people also download straight from search results without a page view, so a search-heavy row can pass 100%; not App Store Connect's unique-device Conversion Rate), each with the same days one span earlier (prior: only the days the range has reports for are compared, so days still to come never read as a drop; all null when those earlier days are not stored; a country row has prior only when some of it is known); per country (the first 25 by downloads, countriesTotal = how many have data; country gives any one, other = Google Play's small countries folded together), per source (search, browse, web, app, other; Google Play's sources are never per country) and Google Play's search terms.

One own app's Analytics (the Overview tab's Analytics view) over a range, as the store counted it (totals from the store's own reports, never unique devices): impressions (App Store only: the app's icon shown in a list such as search results or charts; websites and other apps have none, they land on the page), pageViews (App Store: views of the product page, store sheets included / Play Console's Store listing visitors), downloads (App Store Connect's First-Time Downloads / Play Console's Store listing acquisitions) and conversion (% downloads of pageViews, the same for every source, country and store; on Google Play that is Play Console's own rate; on the App Store people also download straight from search results without a page view, so a search-heavy row can pass 100%; not App Store Connect's unique-device Conversion Rate), each with the same days one span earlier (prior: only the days the range has reports for are compared, so days still to come never read as a drop; all null when those earlier days are not stored; a country row has prior only when some of it is known); per country (the first 25 by downloads, countriesTotal = how many have data; country gives any one, other = Google Play's small countries folded together), per source (search, browse, web, app, other; Google Play's sources are never per country) and Google Play's search terms. The range ends today (UTC), the same days as app_insights; through = the newest day with data (the stores run a day or two behind, so the last days of the range are not counted yet). daysCovered = days of the range the stored reports cover: the totals are for those days only. state other than ready says what is missing (analytics_sync). Missing numbers are null, never 0.

appId requiredstring

App id from status ("bs_…" = brainstorm).

range 7d | 30d | 90d

Default 30d.

country string

Optional store code, e.g. us.

analytics_sync Write

Analytics (own apps; the Overview tab's Analytics view): read the store's newest report files now (App Store Connect Analytics Reports, Google Play's report bucket) and return where it stands.

Analytics (own apps; the Overview tab's Analytics view): read the store's newest report files now (App Store Connect Analytics Reports, Google Play's report bucket) and return where it stands. Runs by itself once a day; app_analytics reads what is stored. state needsAdmin = the App Store Connect key's role cannot read analytics (asc_connect an Admin key with replace); needsReports = Google Play needs play_reports; notLive = the app is not on its store (never published, or its first version is still in review): no report will ever come until it is; preparing = the app is live and its first report was asked for in the last days (Apple: up to two days); noReport = the app is live and the store still has no report for it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

play_reports Write

Google Play analytics: give the Play account's report bucket from any Play Console link of the account that owns the apps (it contains /developers/<id>/), the bucket's gs:// name or the developer id.

Google Play analytics: give the Play account's report bucket from any Play Console link of the account that owns the apps (it contains /developers/<id>/), the bucket's gs:// name or the developer id. The first connected service account that can read it keeps it; every Play app's analytics then reads again.

link requiredstring

Play Console link, gs://pubsite_prod_… or the developer account id.

accountId string

Optional Play account id.

Brainstorms

session_create WriteBackground

Start a keyword brainstorm: no app, just a topic ("a calorie tracker for keto dieters").

Start a keyword brainstorm: no app, just a topic ("a calorie tracker for keto dieters"). The AI proposes 15–25 keywords, checked for volume and difficulty in the US first, then in the Settings countries (settings.defaultMarkets), or only in the markets given. Change countries later with app_markets. Brainstorms have no rank, listing or audit. Returns its id (bs_…). Returns as soon as the work starts. Call wait, then status, to follow it. store play brainstorms for Google Play instead (searched on Google Play, no China; volume and difficulty stand on installs). A brainstorm without store (status apps[].store) is an App Store one.

brief requiredstring

What to brainstorm.

markets string[]

Optional storefront codes; default: US, then the Settings countries.

store appstore | play

Which store: appstore (default) or play (Google Play).

session_update Write

Rename a brainstorm, change its topic or its icon.

Rename a brainstorm, change its topic or its icon.

appId requiredstring

App id from status ("bs_…" = brainstorm).

name string

New name.

brief string

New topic.

emoji string

One emoji as its icon; an empty string brings back the lightbulb.

session_opportunities WriteBackground

Refine a brainstorm idea before building it.

Refine a brainstorm idea before building it. Checks missing keywords in one tracked market through the existing search queue, then compares 2–4 narrower audiences and product directions with cited measured phrases, actual competitors, proposed MVP features and risks. No traffic or ranking promises. Saved report is in board_get.opportunities; stale marks changed idea/evidence. Does not change the idea or publish anything. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

storefront string

Storefront code, e.g. "es" (markets_list).

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

Keywords

keywords_brainstorm WriteBackground

AI rebuilds the app’s keywords: the phrases its listing targets (name, subtitle and keyword field combined) plus up to 10 ideas, each with one phrase in every market, then checks new phrases.

AI rebuilds the app’s keywords: the phrases its listing targets (name, subtitle and keyword field combined) plus up to 10 ideas, each with one phrase in every market, then checks new phrases. Keywords the user added or edited stay. On a brainstorm it adds up to 25 more keywords and keeps everything. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

keyword_add WriteBackground

Track a keyword.

Track a keyword. scope "all" (default): label is the English phrase and the AI fills in the phrase each tracked country types; "home": label is the phrase in the home market's language (board_get home), checked exactly as written there and translated into the other countries from it (same as "all" when home is English); "english": the label as is, in every tracked country (no translation). A label or phrase already tracked is refused (answer refused: the reason, existing: its keyword id), except scope "english" on a keyword tracked under local phrases: the label joins it as each such market's variant (answer variants: those markets; board_get cells[sf].variant). Pass terms (storefront → phrase) to set phrases yourself; missing countries are still translated with scope all. section "listing" files it under App Store Connect, else Ideas. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

label requiredstring

The phrase: English for scope all, the home market's language for scope home, e.g. "habit tracker".

scope all | home | english

How the countries get their phrase.

terms object

Optional storefront → local phrase.

section idea | listing

Section.

keyword_localize WriteBackground

Translate a keyword into every tracked country it has no phrase in yet, then check.

Translate a keyword into every tracked country it has no phrase in yet, then check. Returns as soon as the work starts. Call wait, then status, to follow it.

keywordId requiredstring

Keyword id from board_get.

keyword_update Write

Rename a keyword's English label.

Rename a keyword's English label. Where home is not English, rows are named by the home phrase: change that with term_set.

keywordId requiredstring

Keyword id from board_get.

label requiredstring

New English phrase.

keyword_hide Write

Hide a keyword from the board and from checks without deleting it, or show it again.

Hide a keyword from the board and from checks without deleting it, or show it again.

keywordId requiredstring

Keyword id from board_get.

hidden requiredboolean

true hides, false shows.

keyword_avoid Write

The app’s "don’t target" list: phrases the owner doesn’t want in the listing yet (e.g.

The app’s "don’t target" list: phrases the owner doesn’t want in the listing yet (e.g. a feature the app doesn’t have). avoid true adds the phrase (or replaces its note) and hides the tracked keyword with that phrase; every brainstorm, researcher answer and Optimize step then leaves it out of names, subtitles, keyword fields, descriptions and keyword ideas. avoid false targets it again and shows the keyword. Rerun Optimize (audit_more or audit_english) for drafts written before the change. The list is in board_get.app.avoid.

appId requiredstring

App id from status ("bs_…" = brainstorm).

term requiredstring

The phrase in English, e.g. "sleep tracking". Any phrase, tracked or not.

avoid requiredboolean

true = don’t target, false = target again.

note string

Optional reminder for the owner, e.g. "not in the app yet". Omit to keep the current note; empty clears it.

keyword_remove WriteDestructive

Stop tracking a keyword in every market.

Stop tracking a keyword in every market.

keywordId requiredstring

Keyword id from board_get.

term_set Write

Set the phrase one market types for a keyword.

Set the phrase one market types for a keyword. Empty text removes the keyword from that market. variant true sets or (empty text) removes the cell's variant instead: a second phrase compared beside the main one.

keywordId requiredstring

Keyword id from board_get.

storefront requiredstring

Storefront code, e.g. "es" (markets_list).

text requiredstring

Phrase as people type it in that market.

variant boolean

The cell's second phrase, not its main one.

check_run WriteBackground

Search every term in each market: rank, volume and difficulty.

Search every term in each market: rank, volume and difficulty. Reuses today’s cached results unless force is true; pass force true when the owner asks to refresh ranks now. Apps are also re-checked on their own (settings autoCheck). Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

storefronts string[]

Only these markets.

force boolean

Re-check ranks already checked today (default false).

ASO audit

audit_overview_run WriteBackground

The Audit tab (own and research apps): where the app stands.

The Audit tab (own and research apps): where the app stands. Reads the App Store page when there is no listing (or refetch), brainstorms when there are no keywords, asks the researcher for more keywords when moreKeywords, checks phrases never checked (every phrase when recheck), then scores the board in the main listing's store: 0–100 from three parts, Rankings 50 (where the app ranks for phrases with demand), Listing 30 (how well the name, subtitle and keyword field target that demand) and Competition 20 (how beatable the apps above it are), capped at Rankings + 30; missing measurements stay null. The AI writes a short headline, the verdict's reason and 3–6 takeaways (each with the Optimize step that acts on it). With scope all it then audits every other checked country, each judged on its own, and writes a summary across them, weighted by market potential; a country whose measurements didn't change since its last audit keeps its words, and the summary stays when nothing changed (request asks again). request: the owner's feedback for this run (e.g. "focus on competitors in Germany"); it also steers the researcher when moreKeywords. Read the result with audit_overview_get. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale string

Main listing to judge (App Store language, e.g. en-US); default the app's current main listing. Shared with Optimize.

scope main | all

main = the main listing's country only (default: the app's last choice, else main); all = then every other tracked country on its own, then a summary across them (countries, meta).

countries string[]

Audit exactly these tracked countries (store codes, e.g. ["mx"]); the other countries keep their last audit and the summary is rewritten when something changed. Overrides scope.

request string

Optional feedback or focus for this run.

refetch boolean

Read the App Store page again first.

moreKeywords boolean

Ask the researcher for more keywords first (uses request).

recheck boolean

Check every phrase again, not only unchecked ones.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_overview_get Read

The Audit tab's last run (audit_overview_run), or null when never run: at (ISO), score 0–100 (null = nothing measured; Rankings 50 / Listing 30 / Competition 20, capped at Rankings + 30), verdict (pivot = change your keywords, align = fine-tune, fine) with the AI's headline and verdictReason, sections (ranking, listing, competition: score, summary, facts, action), competitors (other apps in the top 10 of the tracked phrases, most often first; sameDeveloper = the owner's own app, not a competitor; app_facts adds their rating, release and last update; track one with app_add kind competitor), ranked (In the top 10), gaps (Outside the top 10: phrases with demand where the app is not in the top 30; covered = all its words are in the listing), others (each other tracked store: checked, top10, ranked, gaps, best phrase), market and locale (the main listing judged; localized false = that store shows another language), local (this store only), listing issues, takeaways (text, tone, action: the step that acts on it, e.g.

The Audit tab's last run (audit_overview_run), or null when never run: at (ISO), score 0–100 (null = nothing measured; Rankings 50 / Listing 30 / Competition 20, capped at Rankings + 30), verdict (pivot = change your keywords, align = fine-tune, fine) with the AI's headline and verdictReason, sections (ranking, listing, competition: score, summary, facts, action), competitors (other apps in the top 10 of the tracked phrases, most often first; sameDeveloper = the owner's own app, not a competitor; app_facts adds their rating, release and last update; track one with app_add kind competitor), ranked (In the top 10), gaps (Outside the top 10: phrases with demand where the app is not in the top 30; covered = all its words are in the listing), others (each other tracked store: checked, top10, ranked, gaps, best phrase), market and locale (the main listing judged; localized false = that store shows another language), local (this store only), listing issues, takeaways (text, tone, action: the step that acts on it, e.g. keywords, names, namesLocalize, copy, copyLocalize or store; null = the AI part failed), scope (main or all) and, with all, countries (each other country's own audit, same shape) and meta (the summary across countries: score weighted by market potential, verdict, headline, reason, takeaways). error = why the AI part is missing.

appId requiredstring

App id from status ("bs_…" = brainstorm).

app_facts Read

For App Store app ids (e.g.

For App Store app ids (e.g. audit_overview_get competitors) in one store: star rating, rating count, release date, last update, current version and price, as the Audit's competitors table shows them. Ids missing from the answer are not in that store. Google Play package names (com.x.y) answer from what checks stored for that country (no version or release date).

ids requiredstring[]

App Store ids.

storefront requiredstring

Storefront code, e.g. "es" (markets_list).

competitor_add Write

Add an app to this app’s Main competitors by hand (the Audit’s Add competitor): it stays in the list whether or not it ranks on this app’s keywords, with its place and average rank wherever it appears in the checked results (— when it appears nowhere).

Add an app to this app’s Main competitors by hand (the Audit’s Add competitor): it stays in the list whether or not it ranks on this app’s keywords, with its place and average rank wherever it appears in the checked results (— when it appears nowhere). It does not track the competitor’s own keywords: app_add with kind competitor does that. Must be in the same store as the app. Added ones are in board_get.app.picked and marked picked in board_get competitors; competitor_dismiss takes one off.

appId requiredstring

App id from status ("bs_…" = brainstorm).

competitor requiredstring

The competitor’s App Store link or id (store_search finds ids by name), or its Google Play link or package name.

storefront string

Optional store to look it up in. Default: the app’s main store.

competitor_dismiss Write

Remove an app from this app’s competitors (it is unrelated), or bring it back.

Remove an app from this app’s competitors (it is unrelated), or bring it back. A removed app leaves the Audit’s Main competitors (the next one takes its place), the keyword competitor lists, the audit summary and the competitor evidence the AI reads when auditing and localizing. Ranks and scores still count it: it holds its place in search. Removed ids are in board_get.app.dismissed. A competitor the owner added (competitor_add, board_get.app.picked) is taken off that list instead.

appId requiredstring

App id from status ("bs_…" = brainstorm).

competitorId requiredstring

App Store id or Google Play package name of the competitor (board_get competitors, audit_overview_get competitors).

dismissed requiredboolean

true removes, false brings it back.

audit_get Read

The app’s ASO audit: main-locale current fields, options, chosen fields, core keywords and research; per locale current vs proposed fields and the local phrases tested with their numbers; copy: step 3 promo text and description (settings, main, per-locale current vs proposed; name = the app name it was translated with: a different name now means translate it again); finalReview: the final review across every language (audit_final_review: changes it made, before → after, and looks it couldn’t fix).

The app’s ASO audit: main-locale current fields, options, chosen fields, core keywords and research; per locale current vs proposed fields and the local phrases tested with their numbers; copy: step 3 promo text and description (settings, main, per-locale current vs proposed; name = the app name it was translated with: a different name now means translate it again); finalReview: the final review across every language (audit_final_review: changes it made, before → after, and looks it couldn’t fix). export: true returns the export file format instead (per-locale fields, changes, tests).

appId requiredstring

App id from status ("bs_…" = brainstorm).

export boolean

Return the export format.

audit_english WriteBackground

ASO audit step 1 (own apps and competitors; a competitor’s keyword field is not public, so it is inferred): optimizes the main listing (locale, default en-US or the last audit's): measures extra phrases in that locale's store when the AI needs more data, then proposes 3 name / subtitle / keyword field options in its language (one recommended), keeping the brand.

ASO audit step 1 (own apps and competitors; a competitor’s keyword field is not public, so it is inferred): optimizes the main listing (locale, default en-US or the last audit's): measures extra phrases in that locale's store when the AI needs more data, then proposes 3 name / subtitle / keyword field options in its language (one recommended), keeping the brand. Every other locale is localized from it in step 2. Result in audit_get english. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale string

Optional main listing: an App Store Connect locale, e.g. "es-ES". Default en-US.

request string

Optional note for the auditor, e.g. "keep the brand in the name".

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_more WriteBackground

Write more main-listing options (default 3), different from the ones the audit has; existing options stay.

Write more main-listing options (default 3), different from the ones the audit has; existing options stay. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

count integer

1–5.

request string

Optional directions, e.g. "lead with the main feature".

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_measure WriteBackground

Measure phrases for the audit in the main listing's store: one App Store search each (cached per day); results join audit_get english.research.

Measure phrases for the audit in the main listing's store: one App Store search each (cached per day); results join audit_get english.research. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

phrases requiredstring[]

Phrases in the main listing's language, lowercase.

audit_option_add Write

Add a main-listing option to the audit (shown as a tab).

Add a main-listing option to the audit (shown as a tab). Owner edits preserve the supplied keyword words; researcher suggestions remove repeated visible-field words. Limits 30/30/100.

appId requiredstring

App id from status ("bs_…" = brainstorm).

by owner | researcher

Authorship: owner for a manual edit, researcher for an agent suggestion (default).

title requiredstring

2–3 words.

why string

One line: what it wins.

explain string

Optional: two short paragraphs on the idea.

fields requiredobject

name, subtitle, keywords.

audit_option_update Write

Change an existing main-listing option in place (it keeps its tab and number).

Change an existing main-listing option in place (it keeps its tab and number). Pass the full new fields; title/why/explain are optional.

appId requiredstring

App id from status ("bs_…" = brainstorm).

by owner | researcher

Authorship: owner for a manual edit, researcher for an agent suggestion (default).

optionId requiredstring

The option id from audit_get.

title string

Optional new title.

why string

Optional.

explain string

Optional.

fields requiredobject

name, subtitle, keywords.

audit_option_remove WriteDestructive

Remove one main-listing option from the audit.

Remove one main-listing option from the audit.

appId requiredstring

App id from status ("bs_…" = brainstorm).

optionId requiredstring

Option id from audit_get.

audit_choose Write

Settle the main listing's fields: an option’s fields, the current ones, or your own.

Settle the main listing's fields: an option’s fields, the current ones, or your own. Limits: name 30, subtitle 30, keywords 100. core optionally supplies full search intents. Localization derives its strategy from the approved name and subtitle, preserving their topics and priority; stale core fragments cannot override them.

appId requiredstring

App id from status ("bs_…" = brainstorm).

fields requiredobject

name, subtitle, keywords.

core string[]

Optional full search intents; never isolated category or modifier fragments.

audit_undo Write

Undo the last Optimize draft change, including chosen fields, deleted options or localized drafts.

Undo the last Optimize draft change, including chosen fields, deleted options or localized drafts. Saved across restarts; does not undo App Store uploads or promo/description changes.

appId requiredstring

App id from status ("bs_…" = brainstorm).

audit_redo Write

Redo an undone Optimize draft change.

Redo an undone Optimize draft change.

appId requiredstring

App id from status ("bs_…" = brainstorm).

audit_draft_set Write

Save unfinished typing in the Optimize editor without choosing or publishing it.

Save unfinished typing in the Optimize editor without choosing or publishing it. Omit locale for the main editor; null fields clears that editor draft.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale string

Optional App Store locale.

fields requiredobject | null

Unsaved editor fields, or null to clear the saved draft.

audit_localize WriteBackground

ASO audit step 2: localize the approved main listing into each language, adding no ideas of its own.

ASO audit step 2: localize the approved main listing into each language, adding no ideas of its own. Per language family (biggest market first): 2–3 native ways to say each approved search intent plus the native words of the approved keyword field, checked in that country's App Store and vetted once, then written and independently reviewed for natural language and fidelity. Regional variants (en-GB, es-MX, fr-CA, pt-PT) reuse their parent's phrases; same-language listings keep the approved name/subtitle. Rejected drafts stay marked for the owner. Result in audit_get locales, with phrase evidence and review notes. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locales string[]

App Store Connect locales, e.g. "de-DE". Default: all 49 besides the main listing.

request string

Optional directions; default = the main listing audit’s request.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_locale_set Write

Edit one locale’s proposed fields by hand.

Edit one locale’s proposed fields by hand.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale requiredstring

App Store Connect locale.

fields requiredobject

name, subtitle, keywords.

audit_locale_pick WriteBackground

Use another tested phrase for a core keyword in one locale; the AI rewrites that locale.

Use another tested phrase for a core keyword in one locale; the AI rewrites that locale. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale requiredstring

App Store Connect locale.

keyword requiredstring

Core keyword.

text requiredstring

One of its tested candidates.

audit_clear WriteDestructive

Delete the app’s keyword audit (steps 1–2: options, chosen main listing, languages).

Delete the app’s keyword audit (steps 1–2: options, chosen main listing, languages). The promo text and description (step 3) stay; audit_copy_clear deletes those.

appId requiredstring

App id from status ("bs_…" = brainstorm).

audit_copy_settings Write

ASO audit step 3 settings for the promo text and description: whether the description says some features need Premium (omit = no mention, but never implies free; soft = one light line that Premium unlocks more; mention = says plainly which features need Premium; free = the app has no paid features) the privacy policy and terms of use links every description ends with, and the marketing URL.

ASO audit step 3 settings for the promo text and description: whether the description says some features need Premium (omit = no mention, but never implies free; soft = one light line that Premium unlocks more; mention = says plainly which features need Premium; free = the app has no paid features) the privacy policy and terms of use links every description ends with, and the marketing URL. The privacy policy and marketing URL are also uploaded to every language (audit_publish parts privacy and marketing). null = use what the current listing has (its links, else Apple’s standard EULA; paid defaults to mention). Read back in audit_get copy.settings; the effective values come back here.

appId requiredstring

App id from status ("bs_…" = brainstorm).

paid omit | soft | mention | free | null

Paid features.

privacyUrl string | null

Privacy policy URL, or null for the listing’s.

termsUrl string | null

Terms of use URL, or null for the listing’s (else Apple’s standard EULA).

marketingUrl string | null

Marketing URL, or null for the listing’s.

audit_copy_write WriteBackground

ASO audit step 3: the AI writes the main locale’s promotional text (170) and description (4000).

ASO audit step 3: the AI writes the main locale’s promotional text (170) and description (4000). With a current description (or one set earlier) it improves it, keeping its structure and true facts; without one it writes from request and the product brief, so pass what the app does. Casual, neutral, no prices or "free", ends with the terms and privacy links. Needs the listing synced (app_fetch) when App Store Connect is connected. An agent that can read the app’s code or notes can instead write the copy itself and save it with audit_copy_set. Result in audit_get copy.main. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

request string

Optional directions or product facts: new features, who it is for, what to keep.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_copy_set Write

Set promo text and description by hand: the main locale’s (locale omitted or the main one), or one other locale’s proposal.

Set promo text and description by hand: the main locale’s (locale omitted or the main one), or one other locale’s proposal. Limits: promo 170, description 4000; description required.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locale string

Optional App Store Connect locale; omit for the main listing.

promo requiredstring

Promotional text, up to 170 characters (may be empty).

description requiredstring

Description, up to 4000 characters, plain text with line breaks.

audit_copy_localize WriteBackground

ASO audit step 3: translate the main promo text and description into the app’s other languages (every locale it has plus every locale step 2 wrote), or only the locales given.

ASO audit step 3: translate the main promo text and description into the app’s other languages (every locale it has plus every locale step 2 wrote), or only the locales given. Uses each locale’s name; keeps the links. A language already translated from the same description and name (hand edits included) is kept with no AI call; request translates every language asked again. Result in audit_get copy.locales. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locales string[]

Optional App Store Connect locales, e.g. "de-DE".

request string

Optional directions.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_copy_clear WriteDestructive

Delete step 3: the chosen main promo text and description, the translated languages and the copy settings.

Delete step 3: the chosen main promo text and description, the translated languages and the copy settings.

appId requiredstring

App id from status ("bs_…" = brainstorm).

audit_final_review WriteBackground

The final review of Optimize’s localizations: every language side by side, in two separate reviews that FIX what they find and log it (the owner never judges per-language wording).

The final review of Optimize’s localizations: every language side by side, in two separate reviews that FIX what they find and log it (the owner never judges per-language wording). names: each language’s name and subtitle against the approved main listing and its concepts (wrong meaning, dropped topic, doubled word, unnatural order, wrong regional term or script, stray English, Latin & in Hebrew/Arabic, over the limit), fixed with a whole new field within the limit that keeps the brand. keywords and copy: a rejection-risk scan of the keyword fields and of promo text + description, main listing included (words vulgar in that language or a neighbouring variant, competitor or drug brands, medical claims, price/free/trial words, features the app doesn’t have, wrong script, altered URLs), fixed by replacing or removing the words. Each fix is reviewed once more (names also by the per-language concept review: a fix that loses a topic is undone); what still fails stays as the best version and becomes a look. A renamed language’s description is translated again and scanned. Runs by itself after audit_localize (names, keywords) and audit_copy_localize (copy). Result in audit_get finalReview: changes (id, part, locale, field, before, after, reason, severity, applied = the draft still holds after, undone) and looks (locale, field, text, problem, open = still applies: the only items that need the owner), runs (per part: at, locales, unfinished). A language whose text is what the last review passed is not reviewed again (names: unless any language changed). audit_final_undo puts one change back. Nothing is blocked. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

locales string[]

Optional App Store Connect locales, e.g. "de-DE". Default every language drafted.

parts string[]

Optional: which reviews. Default all three.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

audit_final_undo Write

Undo one final-review fix: the field goes back to the change’s before value (refused when the text changed since).

Undo one final-review fix: the field goes back to the change’s before value (refused when the text changed since). Names and keyword fields also go through audit_undo/audit_redo history.

appId requiredstring

App id from status ("bs_…" = brainstorm).

id requiredstring

The change id from audit_get finalReview.changes.

publish_preview Read

For an own app, read fresh from App Store Connect: target (live version, editable draft, a version blocking a new one, next number, firstRelease, namesEditable, every locale's current name, subtitle, keywords, promo, description, What's New and URLs) and rows: per language, each field the audit would change, from → to; isNew = a language the app doesn't have yet.

For an own app, read fresh from App Store Connect: target (live version, editable draft, a version blocking a new one, next number, firstRelease, namesEditable, every locale's current name, subtitle, keywords, promo, description, What's New and URLs) and rows: per language, each field the audit would change, from → to; isNew = a language the app doesn't have yet. Read it before audit_publish and tell the owner what changes. null = no key connected.

appId requiredstring

App id from status ("bs_…" = brainstorm).

next_version Read

For an own app: the editable iOS version in App Store Connect, if any, and the next version number to create.

For an own app: the editable iOS version in App Store Connect, if any, and the next version number to create. audit_publish writes into the editable one, or needs versionString = next. null = no key connected.

appId requiredstring

App id from status ("bs_…" = brainstorm).

audit_publish WriteBackgroundDestructive

Upload the audit into App Store Connect (the App Store tab in the window): the editable iOS version, created as versionString when there is none (refused while another version is in review or pending release).

Upload the audit into App Store Connect (the App Store tab in the window): the editable iOS version, created as versionString when there is none (refused while another version is in review or pending release). Promo text alone, with no draft, goes straight to the live version. parts picks the fields (name, subtitle, keywords, promo, description, privacy, marketing = the privacy policy and marketing URL from audit_copy_settings, written to every language), locales the languages; default everything publish_preview lists. New languages are added when names are written, with the main language's privacy URL and description. Every language then gets what Apple needs before submitting: privacy and support URLs, What's New (pass whatsNew for an update), and the live promo text and marketing URL are kept. A new version still needs a build with the same version number. Never submits for review. Only when the owner asked, with the parts they asked for. Returns as soon as the work starts. Call wait, then status, to follow it. screenshots renders those sets first and uploads them into the same version.

appId requiredstring

App id from status ("bs_…" = brainstorm).

versionString string

New version number when no editable version exists, e.g. "2.4" (publish_preview target.next).

parts string[]

Optional: what to write. Default all.

locales string[]

Optional App Store Connect locales to write, e.g. "es-ES". Default every changed one.

whatsNew string

What's New for every language of an update that has none; one line, usually English.

screenshots object[]

Screenshot sets to render and upload with the listing, into the same version: [{locale, target: iphone|duo|ipad|watch|header|searchResult}] (screens_get readiness). Rendered first, so the call starts a shotsRender job, then the publish. Google Play apps: [{locale: Play listing language, target: playPhone|featureGraphic}], uploaded to the Play listing.

audit_fastlane WriteDestructive

Write the ASO audit as a fastlane deliver metadata folder: <locale>/name.txt, subtitle.txt, keywords.txt, promotional_text.txt, description.txt, privacy_url.txt, marketing_url.txt (release_notes.txt with whatsNew).

Write the ASO audit as a fastlane deliver metadata folder: <locale>/name.txt, subtitle.txt, keywords.txt, promotional_text.txt, description.txt, privacy_url.txt, marketing_url.txt (release_notes.txt with whatsNew). dir: the project, its fastlane folder or its metadata folder (absolute path); any other folder gets <app>-fastlane/metadata inside it. Only the files for the parts and locales written are replaced; others stay. Same parts as audit_publish. For owners who ship with fastlane instead of uploading here.

appId requiredstring

App id from status ("bs_…" = brainstorm).

dir requiredstring

Absolute path: the project, fastlane or fastlane/metadata folder.

parts string[]

Optional: what to write. Default all.

locales string[]

Optional App Store Connect locales, e.g. "de-DE". Default every one the audit has.

whatsNew string

Optional release notes for every language written.

Screenshots

screens_get Read

The app’s App Store screenshot project (Optimize steps 5–6), compact: main language, languages, export sizes, default text style, the iPhone, iPhone Duo and iPad sets (independent slides: id, heading, background, effective text font/scale/color with contrast, device layers with their image ids and canvas-fraction positions; elements on a full-picture slide) and the Watch set (images as they go up), the header (3840 × 1646) and searchResult (3840 × 2560) sets (optional, one slide each, a canvas like the feature graphic: graphic.elements text boxes and images, phones in layers; options.templates and options.safeArea: keep text inside Apple’s safe area), stored images, readiness per language and set (problem null = can render/upload) and the folder rendered PNGs land in.

The app’s App Store screenshot project (Optimize steps 5–6), compact: main language, languages, export sizes, default text style, the iPhone, iPhone Duo and iPad sets (independent slides: id, heading, background, effective text font/scale/color with contrast, device layers with their image ids and canvas-fraction positions; elements on a full-picture slide) and the Watch set (images as they go up), the header (3840 × 1646) and searchResult (3840 × 2560) sets (optional, one slide each, a canvas like the feature graphic: graphic.elements text boxes and images, phones in layers; options.templates and options.safeArea: keep text inside Apple’s safe area), stored images, readiness per language and set (problem null = can render/upload) and the folder rendered PNGs land in. translations: true adds each slide’s translated headings and whether they are current, and a language’s own screenshots (images: device position → image id, screens_locale_image_set). Google Play apps (store play) have only the playPhone set (1080 × 1920, 2–8 per language, drawn in an Android phone frame) and the featureGraphic set (1024 × 500, exactly 1: background color or image, heading, optional icon, no device; its slide has graphic instead of layers); languages are Play listing languages.

appId requiredstring

Own app id (kind mine).

translations boolean

Include translated headings and per-language screenshots per slide.

screens_raw Read

The full ScreenProject and translations exactly as stored, to edit and send back with screens_save.

The full ScreenProject and translations exactly as stored, to edit and send back with screens_save.

appId requiredstring

Own app id (kind mine).

screens_capture Write

Mac: take a screenshot of a booted iOS Simulator (xcrun simctl io <device> screenshot) and import it like screens_import.

Mac: take a screenshot of a booted iOS Simulator (xcrun simctl io <device> screenshot) and import it like screens_import. Boot one first (xcrun simctl boot <udid>, open -a Simulator) and navigate the app to the screen. Captures are full device resolution PNGs. Google Play apps: not supported yet; import PNGs with screens_import.

appId requiredstring

Own app id (kind mine).

device string

Simulator udid or name; default "booted" (the one booted simulator).

target requirediphone | duo | ipad | watch | header | searchResult | playPhone | featureGraphic

Screenshot set. iPhone Duo is one App Store screenshot set; Watch uploads unchanged; header and searchResult are the App Store’s product page header and search results image (one each per language). Google Play apps: playPhone or featureGraphic.

slideId string

Optional: fill this slide (and the following ones).

layerId string

Optional with slideId: fill exactly this device layer.

screens_import Write

Import image files (absolute paths to PNG or JPEG, e.g.

Import image files (absolute paths to PNG or JPEG, e.g. simulator captures) into a set, as dropping them in the window does: without slideId they fill the set’s first empty devices in order (files sorted by name), adding slides up to 10; with slideId they start there; with slideId + layerId one image replaces that device’s screenshot (on every set, phones on the feature graphic, header and search result included) or that canvas image; one file with slideId on a slide without a device becomes its background picture. Watch-sized images (e.g. 416 × 496) also join the Watch set; target watch only adds to the Watch set. layout styles new slides. Google Play apps: playPhone takes raw phone captures of any portrait shape (Android, or iPhone fitted whole), adding slides up to 8; a square image (a Wear OS screenshot) fills the next empty Wear OS watch (layout phoneWatch or watch); featureGraphic without layerId takes a square image as the app icon and any other image as the background image; with layerId (a phone in its layers) it fills that phone.

appId requiredstring

Own app id (kind mine).

files requiredstring[]

Absolute paths to PNG/JPEG files.

target requirediphone | duo | ipad | watch | header | searchResult | playPhone | featureGraphic

Screenshot set. iPhone Duo is one App Store screenshot set; Watch uploads unchanged; header and searchResult are the App Store’s product page header and search results image (one each per language). Google Play apps: playPhone or featureGraphic.

slideId string

Optional slide to start at.

layerId string

Optional with slideId: the device layer (or canvas image element) to fill with one file.

layout center | bleed | large | pair | phoneWatch | watch

Optional layout for slides this adds.

screens_slide_update Write

Edit one slide, or every slide of a set (all) or every other slide starting with the second (everyOther) — the inspector’s apply-all buttons: heading (main language, plain text, short), background, text color ("auto" = white or near-black, whichever reads; null = the default), font, size (scale 60–140, 100 = default; it also shrinks to fit two lines), device layout (keeps placed screenshots) and device frame.

Edit one slide, or every slide of a set (all) or every other slide starting with the second (everyOther) — the inspector’s apply-all buttons: heading (main language, plain text, short), background, text color ("auto" = white or near-black, whichever reads; null = the default), font, size (scale 60–140, 100 = default; it also shrinks to fit two lines), device layout (keeps placed screenshots) and device frame. background.image puts the owner’s own picture (a file path or image id) behind the heading of an iPhone, iPhone Duo, iPad or playPhone slide, the same in every language; with layout none the slide has no device: picture + localized heading. Changing a heading makes its translations stale until screens_localize or screens_translation_set. header, searchResult and featureGraphic have no device layout: template applies a starting layout (options.templates ids: text boxes, the app icon and phones filled with the app’s own screenshots), graphic sets the background image. elements places images and text boxes (the heading may be one) on those sets and on full-picture slides: the owner’s own image (a watch render, a logo) over their picture, with Wow’s localized text.

appId requiredstring

Own app id (kind mine).

slideId string

The slide to edit; or pass target with all/everyOther.

target iphone | duo | ipad | header | searchResult | playPhone | featureGraphic

Screenshot set.

all boolean

Apply to every slide of target.

everyOther boolean

Apply to every other slide of target (2nd, 4th, …).

heading string

Main-language heading.

background object

Background: solid uses a; gradient goes from a to b at angle (degrees). Omitted keys keep their value.

textColor string | null

#RRGGBB, "auto", or null for the default.

font DM Sans | Inter | Poppins | Montserrat | Rubik | Outfit | Archivo Black | Fredoka | System

Heading font.

scale number

Heading size, 60–140.

layout center | bleed | large | pair | phoneWatch | watch | none

Device layout (iPad, iPhone Duo: center, bleed, large; playPhone adds phoneWatch and watch with a round Wear OS watch, filled with a square Wear screenshot); none = no device, for a slide with a background picture.

frame dark | light

Device frame color.

graphic object

Feature graphic, header and search result: image = background image id (fills the canvas over the background color), icon = app icon image id (screens_get images; null removes either), align = heading left (beside the icon) or center (under it).

template string

Header, search result or feature graphic: a template id (screens_get options.templates; feature graphic: classic, centered, showcase, iconPhones, headline, phoneLeft). Replaces the slide’s boxes and phones; background and heading stay.

elements object[]

The free canvas, in paint order (later = on top); replaces the slide’s list. On the feature graphic, header and search result, and on full-picture slides (a background picture, no device: layout none); device slides keep the fixed heading. Positions and sizes are canvas fractions (x, y = top-left; image height follows the image). Text shrinks to fit its box in every language.

screens_slide_add Write

Add empty slides to a set (up to 10), styled like the slide before them, after the given slide or at the end.

Add empty slides to a set (up to 10), styled like the slide before them, after the given slide or at the end. A set with none starts here (iPad, Duo and Watch start empty). Google Play: playPhone holds up to 8, featureGraphic 1.

appId requiredstring

Own app id (kind mine).

target requirediphone | duo | ipad | header | searchResult | playPhone | featureGraphic

Screenshot set.

count integer

1–10, default 1.

after string

Optional slide id they go after; default the end.

screens_slide_remove WriteDestructive

Delete one slide from its set.

Delete one slide from its set. Its translations go with it; its images stay stored.

appId requiredstring

Own app id (kind mine).

slideId requiredstring

Slide id from screens_get.

screens_slide_move Write

Move a slide to a new position (1 = first) in its set.

Move a slide to a new position (1 = first) in its set. The order is the App Store order.

appId requiredstring

Own app id (kind mine).

slideId requiredstring

Slide id from screens_get.

position requiredinteger

1–10.

screens_slide_duplicate Write

Copy a slide (heading, background, text style, devices and their screenshots) right after itself.

Copy a slide (heading, background, text style, devices and their screenshots) right after itself.

appId requiredstring

Own app id (kind mine).

slideId requiredstring

Slide id from screens_get.

screens_set_copy Write

Fill an empty screenshot set from another set, as the window’s Copy from button does: same headings, backgrounds and text style, each slide centered with the other set’s first screenshot.

Fill an empty screenshot set from another set, as the window’s Copy from button does: same headings, backgrounds and text style, each slide centered with the other set’s first screenshot. Translations are not copied. The target set must be empty (screens_set_clear first).

appId requiredstring

Own app id (kind mine).

from requirediphone | duo | ipad | header | searchResult | playPhone | featureGraphic

Screenshot set.

to requirediphone | duo | ipad | header | searchResult | playPhone | featureGraphic

Screenshot set.

screens_set_clear WriteDestructive

Delete every slide of a screenshot set, or every Watch screenshot.

Delete every slide of a screenshot set, or every Watch screenshot. Images stay stored; translations of deleted slides go.

appId requiredstring

Own app id (kind mine).

target requirediphone | duo | ipad | watch | header | searchResult | playPhone | featureGraphic

Screenshot set. iPhone Duo is one App Store screenshot set; Watch uploads unchanged; header and searchResult are the App Store’s product page header and search results image (one each per language). Google Play apps: playPhone or featureGraphic.

screens_watch_set Write

Set the Watch screenshots, in order, from stored image ids (screens_get images).

Set the Watch screenshots, in order, from stored image ids (screens_get images). Drop an id to remove it. All must be one Apple Watch size.

appId requiredstring

Own app id (kind mine).

images requiredstring[]

Image ids, in order (up to 10).

screens_settings Write

Project settings: export size per set (App Store display size; iPhone 6.9/6.7/6.5…, iPad 13/12.9/11…), the device model each family draws (deviceModels: official Apple and Google frames, e.g.

Project settings: export size per set (App Store display size; iPhone 6.9/6.7/6.5…, iPad 13/12.9/11…), the device model each family draws (deviceModels: official Apple and Google frames, e.g. iPhone 18 Pro, iPad Pro 13″, Apple Watch Ultra 4) and the default heading style slides inherit until edited (font, color "auto" or #RRGGBB, scale 60–140). Google Play sizes are fixed (phone 1080 × 1920, feature graphic 1024 × 500); its models: playPhone (Pixel 10 family, Galaxy S24 Ultra) and wear (round, square and rectangular Wear OS watches, Galaxy Watch4).

appId requiredstring

Own app id (kind mine).

deviceModels object

Device model drawn per family, for every slide (export sizes stay the same; a device keeps its top-left and width, its height follows the model). Ids from screens_get options.deviceModels (older ids such as iphone-classic map to their replacement); App Store: iphone, ipad, watch (the watch on phone slides; the Watch set goes up as it is); Google Play: playPhone, wear.

iphoneSize 4 | 6.9 | 6.7 | 6.5 | 6.3 | 6.1 | 5.8 | 5.5 | 4.7 | 3.5

iPhone export size.

ipadSize 11 | 13 | 12.9 | 10.5 | 9.7

iPad export size.

font DM Sans | Inter | Poppins | Montserrat | Rubik | Outfit | Archivo Black | Fredoka | System

Default heading font.

color string

Default text color: "auto" or #RRGGBB.

scale number

Default heading size, 60–140.

screens_save Write

Replace the whole project (the shape screens_raw returns), as the window saves it: for edits the other tools don’t cover, such as moving, resizing or rotating devices (x, y, width are canvas fractions; rotation in degrees).

Replace the whole project (the shape screens_raw returns), as the window saves it: for edits the other tools don’t cover, such as moving, resizing or rotating devices (x, y, width are canvas fractions; rotation in degrees). Unknown images and devices are dropped.

appId requiredstring

Own app id (kind mine).

project requiredobject

The full ScreenProject.

screens_headings Write

The AI writes the main-language heading of every slide in the given sets (or only one slide), from the listing, the tracked keywords and the product brief: verb first, one benefit, 2–5 words.

The AI writes the main-language heading of every slide in the given sets (or only one slide), from the listing, the tracked keywords and the product brief: verb first, one benefit, 2–5 words. A set with no slides gets count empty slides first (default 5). By default only slides without a heading are filled: headings already written (by hand or earlier) are kept unless overwrite is true. Headings land on the slides; translations become stale. Write them yourself instead with screens_slide_update heading. Returns as soon as the work starts. Call wait, then status, to follow it. Google Play apps: targets playPhone and/or featureGraphic.

appId requiredstring

Own app id (kind mine).

targets requiredstring[]

One or more screenshot device sets.

only string

Optional slide id: rewrite only this heading.

overwrite boolean

Replace headings that are already written too. Default false: fill empty slides only.

count integer

Slides to create in an empty set, 1–10 (default 5).

request string

Optional directions, e.g. "lead with the barcode scanner".

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

screens_localize Write

Translate the main headings of the given sets into the app’s other App Store languages (or only locales), using each language’s listing words; Apple product names and the brand stay exact.

Translate the main headings of the given sets into the app’s other App Store languages (or only locales), using each language’s listing words; Apple product names and the brand stay exact. Every selected heading must be written first. A language already translated from the same headings and listing is kept with no AI call; request translates every language asked again. Returns as soon as the work starts. Call wait, then status, to follow it. Google Play apps translate into their Google Play listing languages (Play codes: de-DE, es-419, iw-IL …).

appId requiredstring

Own app id (kind mine).

targets requiredstring[]

One or more screenshot device sets.

locales string[]

Optional App Store languages, e.g. "de-DE"; default every language the app has. Google Play apps: Play listing languages.

request string

Optional directions.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

screens_translation_set Write

Set one slide’s heading in one language by hand (marks it current for the main heading it translates).

Set one slide’s heading in one language by hand (marks it current for the main heading it translates).

appId requiredstring

Own app id (kind mine).

locale requiredstring

App Store language, e.g. "de-DE".

slideId requiredstring

Slide id from screens_get.

text requiredstring

The heading in that language.

screens_locale_image_set Write

Give one language its own raw screenshot for a slide’s device (when the app’s screen itself shows text in that language); every other language keeps the main screenshot.

Give one language its own raw screenshot for a slide’s device (when the app’s screen itself shows text in that language); every other language keeps the main screenshot. Not a translation: headings stay current. null goes back to the main screenshot.

appId requiredstring

Own app id (kind mine).

locale requiredstring

A language other than the main listing, e.g. "de-DE".

slideId requiredstring

Slide id from screens_get.

layer integer

0-based position of the device on the slide (screens_get layers order), default 0.

image requiredstring | null

An absolute path to a PNG/JPEG (imported) or a stored image id; null removes it.

screens_render Write

Draw the chosen languages × sets as App Store PNGs (the window renders them, open or not), into the private folder screens_get renderDir names (<locale>/iphone_1.png …): look at them before uploading.

Draw the chosen languages × sets as App Store PNGs (the window renders them, open or not), into the private folder screens_get renderDir names (<locale>/iphone_1.png …): look at them before uploading. Fails, naming the slide, when a screenshot or heading is missing, a translation is stale or a heading doesn’t fit. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

Own app id (kind mine).

locales requiredstring[]

App Store languages to render, e.g. ["en-US", "de-DE"]: the main listing, or languages whose headings are translated and current (screens_get readiness). Required: nothing is inferred. Google Play apps: Play listing languages (e.g. de-DE, es-419, iw-IL).

targets requiredstring[]

App Store screenshot sets to render (header and searchResult included). Google Play apps: playPhone, featureGraphic.

screens_export WriteDestructive

Render the chosen languages × sets, then copy the PNGs into dir/<locale>/ (iphone_1.png, ipad_1.png, watch_1.png …; the layout fastlane deliver uploads from fastlane/screenshots).

Render the chosen languages × sets, then copy the PNGs into dir/<locale>/ (iphone_1.png, ipad_1.png, watch_1.png …; the layout fastlane deliver uploads from fastlane/screenshots). Files of the same name are replaced. Returns as soon as the work starts. Call wait, then status, to follow it. Google Play apps: fastlane supply’s layout, dir/<lang>/images/phoneScreenshots/1.png … and dir/<lang>/images/featureGraphic.png (older numbered phone PNGs there are removed).

appId requiredstring

Own app id (kind mine).

dir requiredstring

Absolute folder path.

locales requiredstring[]

App Store languages to render, e.g. ["en-US", "de-DE"]: the main listing, or languages whose headings are translated and current (screens_get readiness). Required: nothing is inferred. Google Play apps: Play listing languages (e.g. de-DE, es-419, iw-IL).

targets requiredstring[]

App Store screenshot sets to render (header and searchResult included). Google Play apps: playPhone, featureGraphic.

screens_review Read

What the last render staged for upload (per language and set: App Store display type and count) and the App Store Connect version it would go into (or why none).

What the last render staged for upload (per language and set: App Store display type and count) and the App Store Connect version it would go into (or why none). Google Play apps: the Play image type per set; no version (images replace the listing’s).

appId requiredstring

Own app id (kind mine).

screens_publish WriteDestructive

Render the chosen languages × sets, then upload them to App Store Connect into the editable iOS version, replacing those sets there (up to 10 per set; old screenshots are removed only to make room, so a failed run never leaves a language empty — run it again).

Render the chosen languages × sets, then upload them to App Store Connect into the editable iOS version, replacing those sets there (up to 10 per set; old screenshots are removed only to make room, so a failed run never leaves a language empty — run it again). Screenshots only; to upload them with listing text in one go use audit_publish screenshots. Never submits for review. Only when the owner asked. Returns as soon as the work starts. Call wait, then status, to follow it. Google Play apps: uploads to the Play listing through the connected service account, replacing each language’s phone screenshots and feature graphic in one committed edit per language and set (a failure keeps the old images). Never touches tracks or releases.

appId requiredstring

Own app id (kind mine).

locales requiredstring[]

App Store languages to render, e.g. ["en-US", "de-DE"]: the main listing, or languages whose headings are translated and current (screens_get readiness). Required: nothing is inferred. Google Play apps: Play listing languages (e.g. de-DE, es-419, iw-IL).

targets requiredstring[]

App Store screenshot sets to render (header and searchResult included). Google Play apps: playPhone, featureGraphic.

expectedVersion string

Optional version id from screens_review; refused if the editable version changed.

Pricing

pricing_get Read

An own app’s pricing (Optimize’s Pricing steps), read from App Store Connect, or Play Console for a Google Play app (store: play; kept 10 minutes; fresh: true re-reads): baseTerritory (the main listing’s country), territories (every App Store country: id, two-letter country, currency, tier 1–5), products (every subscription and in-app purchase: id, name, type, state, the base country’s current and planned price; for selected ones, changed count, which data set the defaults (by) and changes: per territory whose price changes, "current → proposed" with any scheduled price and "typed" for an override) and plan.

An own app’s pricing (Optimize’s Pricing steps), read from App Store Connect, or Play Console for a Google Play app (store: play; kept 10 minutes; fresh: true re-reads): baseTerritory (the main listing’s country), territories (every App Store country: id, two-letter country, currency, tier 1–5), products (every subscription and in-app purchase: id, name, type, state, the base country’s current and planned price; for selected ones, changed count, which data set the defaults (by) and changes: per territory whose price changes, "current → proposed" with any scheduled price and "typed" for an override) and plan. territories maps each id to "country currency tier". product: one product id adds its full cells (every territory: current, scheduled, proposed, overridden, by). status noKey = no App Store Connect key (Google Play: no Play account), notOwn = the key can’t see this app. The first read of a kind of product fetches Apple’s price lists (up to a minute).

appId requiredstring

App id from status ("bs_…" = brainstorm).

fresh boolean

Re-read App Store Connect.

product string

Optional product id: include its full cells.

pricing_plan Write

Change the pricing plan of an own app (Optimize’s Pricing steps: Main listing = products and base price, Localizations = every country): which subscriptions and one-time purchases are priced (select = App Store Connect product ids from pricing_get), the method (tiers = Wow Keywords 5 tiers, countries at 100/80/60/40/25%; ppp = GNI per person at purchasing power parity relative to the base country; streaming = Spotify Premium’s price relative to the base country, else ppp; income = GNI per person (exchange rates); bigmac = Big Mac index, else income; equal = Apple’s conversion of the base price; ppp, streaming, income and bigmac fall back to tiers where data is missing), the range every method’s result is held in (floor and ceiling, shares of the converted base price, default 0.25 and 1; prices always prefer ones that look set locally, like 4.99, 199 or 600, within 10%), a product’s base price in the base country (the main listing’s country), a country’s own price (override, in its currency, snapped to the nearest price Apple offers), the start date, whether one-time purchases change at once instead (iapNow, default false) and whether existing subscribers keep their price.

Change the pricing plan of an own app (Optimize’s Pricing steps: Main listing = products and base price, Localizations = every country): which subscriptions and one-time purchases are priced (select = App Store Connect product ids from pricing_get), the method (tiers = Wow Keywords 5 tiers, countries at 100/80/60/40/25%; ppp = GNI per person at purchasing power parity relative to the base country; streaming = Spotify Premium’s price relative to the base country, else ppp; income = GNI per person (exchange rates); bigmac = Big Mac index, else income; equal = Apple’s conversion of the base price; ppp, streaming, income and bigmac fall back to tiers where data is missing), the range every method’s result is held in (floor and ceiling, shares of the converted base price, default 0.25 and 1; prices always prefer ones that look set locally, like 4.99, 199 or 600, within 10%), a product’s base price in the base country (the main listing’s country), a country’s own price (override, in its currency, snapped to the nearest price Apple offers), the start date, whether one-time purchases change at once instead (iapNow, default false) and whether existing subscribers keep their price. Google Play apps use the same plan: product ids are productId:basePlanId (subscriptions) or productId:purchaseOptionId (one-time), territories the same ids, prices any amount (rounded to set-looking ones, no ladder), and startDate, iapNow and preserve don’t apply (Google changes prices at once, for new buyers only). Nothing is uploaded; read pricing_get to see every country’s result.

appId requiredstring

App id from status ("bs_…" = brainstorm).

select string[]

Optional: product ids to price (replaces the selection).

method tiers | ppp | streaming | income | bigmac | equal

Optional method.

base object

Optional base price for one product, in the base country’s currency; price null = back to its current price.

override object

Optional: one country’s price for one product; price null = back to the method’s price.

reset string

Optional product id: drop all its country overrides.

startDate string | null

Optional start date YYYY-MM-DD for subscriptions (and one-time purchases when iapNow is false); null = as soon as Apple allows (tomorrow for approved subscriptions).

iapNow boolean

Optional: one-time purchases change at once; default false = on the start date (tomorrow when none).

preserve boolean

Optional: existing subscribers keep their current price (default true).

pricing_publish WriteBackgroundDestructive

Upload the pricing plan to App Store Connect: one-time purchases get a new price schedule (every country set; in effect at once, or from the start date when iapNow is false), subscriptions get the changed countries from the plan’s start date (prices already scheduled there are replaced).

Upload the pricing plan to App Store Connect: one-time purchases get a new price schedule (every country set; in effect at once, or from the start date when iapNow is false), subscriptions get the changed countries from the plan’s start date (prices already scheduled there are replaced). Google Play apps: the changed regions of each base plan or purchase option are written to Play Console at once, for new buyers only (current subscribers keep their price; a region Google refuses keeps today’s price and is listed). Never touches anything else. Read pricing_get first and tell the owner what changes. Only when the owner asked. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

products string[]

Optional product ids; default every selected one.

AI Agent chat

agent_ask WriteBackground

Message the in-app AI Agent for an app, as the owner would in the chat.

Message the in-app AI Agent for an app, as the owner would in the chat. It reads the board and may add, hide, delete or edit keywords; with scope "audit" or "store" it also reads the ASO audit and may add or remove listing options and measure phrases. It can also use this app's tools (prices, screenshots, promo text and description, choosing an option, the Audit score, the Overview tab's progress and store analytics) over several turns, reads the app it is linked to in the other store (status apps[].linked) without changing it, and uploads to App Store Connect or Google Play only when the text asks. Its answer lands in board_get chat. Returns as soon as the work starts. Call wait, then status, to follow it.

appId requiredstring

App id from status ("bs_…" = brainstorm).

text requiredstring

The message.

scope keywords | audit | store

The page the owner is on.

page dashboard | insights | analytics | keywords | overview | names | namesLocalize | copy | copyLocalize | screens | screensLocalize | pricing | store

Optional: the tab or Optimize step open (insights = the Overview tab's Progress view, analytics = its Analytics view, overview = the Audit tab).

attachedAppIds string[]

Other tracked app IDs to read as reference context. Actions stay on appId.

ai object

Optional AI for this run (ai_status); omitted = Settings, model/effort omitted = defaults.

agent_clear WriteDestructive

Clear the AI Agent chat for an app.

Clear the AI Agent chat for an app.

appId requiredstring

App id from status ("bs_…" = brainstorm).

Other computers

computers_status Read

This computer's role in sharing one Wow Keywords between computers.

This computer's role in sharing one Wow Keywords between computers. mode local: its own data (host.enabled = other computers may connect: host.addresses (local network and Tailscale), host.port, paired host.devices with online, an active host.pairing code). mode connected: it shows another computer's data (connection: hostName, address, status connected/connecting/offline, error). Every other tool works on the connected computer's data; the computers_ tools always act on this computer.

No parameters.

computers_host Write

Turn on (or off) letting other computers connect to this one.

Turn on (or off) letting other computers connect to this one. On: this computer keeps the data and does the work; paired computers see and change it live over an encrypted link (nothing goes through any server). Off: paired computers stay paired but can't connect until it is on again. Then computers_pair_code.

on requiredboolean

true = let other computers connect.

computers_pair_code Write

Make a one-time 6-digit code (valid 2 minutes; 5 wrong tries withdraw it) so one more computer can pair with this one; turns on letting other computers connect if it is off.

Make a one-time 6-digit code (valid 2 minutes; 5 wrong tries withdraw it) so one more computer can pair with this one; turns on letting other computers connect if it is off. Hand the code, one of host.addresses and host.port to the agent or person on the other computer: there, computers_connect.

No parameters.

computers_find Read

Computers on this local network with Wow Keywords letting other computers connect (name, address, port).

Computers on this local network with Wow Keywords letting other computers connect (name, address, port). Over Tailscale nothing is found: use the other computer's Tailscale address (its computers_status host.addresses) in computers_connect.

No parameters.

computers_connect Write

Pair this computer with another using the code it shows (computers_pair_code there) and switch to its data: Wow Keywords restarts in a few seconds, then every tool works on that computer's apps, keywords and settings (this computer's own data is kept and comes back with computers_disconnect).

Pair this computer with another using the code it shows (computers_pair_code there) and switch to its data: Wow Keywords restarts in a few seconds, then every tool works on that computer's apps, keywords and settings (this computer's own data is kept and comes back with computers_disconnect). Refused while this computer runs a task. Call computers_status after the restart to see connected.

address requiredstring

The other computer's address: local network IP, Tailscale IP or Tailscale name.

port integer

Default 47821.

code requiredstring

The 6-digit code.

computers_disconnect Write

Stop showing the other computer's data: Wow Keywords restarts on this computer's own data, as it was before connecting.

Stop showing the other computer's data: Wow Keywords restarts on this computer's own data, as it was before connecting. The pairing is forgotten here (pair again with a new code to reconnect).

No parameters.

computers_remove WriteDestructive

Forget a paired computer (computers_status host.devices[].id): its connection drops at once and it can't connect again until it pairs again.

Forget a paired computer (computers_status host.devices[].id): its connection drops at once and it can't connect again until it pairs again. Nothing is deleted.

deviceId requiredstring

Paired computer id.

App Store Connect, Google Play and settings

asc_connect Write

Save an App Store Connect API key (encrypted on this computer) as one more developer account (status settings.ascAccounts), then re-read every app’s listings.

Save an App Store Connect API key (encrypted on this computer) as one more developer account (status settings.ascAccounts), then re-read every app’s listings. The same key again updates it; replace = an account id this key takes the place of. Pass keyFile (path to the AuthKey_<id>.p8; keyId then comes from its name) or privateKey.

issuerId requiredstring

Issuer id (UUID).

keyId string

Key id; optional with an AuthKey_<id>.p8 keyFile.

keyFile string

Absolute path to the.p8 file.

privateKey string

.p8 file contents, when there is no file.

replace string

Optional account id (key id) to replace.

asc_test Write

Check the saved App Store Connect keys with Apple (one account with accountId, else all).

Check the saved App Store Connect keys with Apple (one account with accountId, else all). Returns how many apps they see and admin (true = an Admin key; false = another role: everything works except Analytics, which need an Admin key; null = Apple did not say), or the reason it fails (a revoked key or wrong Issuer ID → asc_connect with a new key; 403 → the key needs Admin access).

accountId string

Optional account id (key id).

asc_disconnect WriteDestructive

Forget one App Store Connect account (accountId = its key id), or every account without accountId.

Forget one App Store Connect account (accountId = its key id), or every account without accountId.

accountId string

Optional account id (key id).

play_connect Write

Connect a Google Play service-account JSON key by its absolute file path, as Settings → Google Play does.

Connect a Google Play service-account JSON key by its absolute file path, as Settings → Google Play does. The apps it sees in Play Console (released or not) become the owner's Play apps: add them with app_add store play (a package name works for unreleased apps). The key stays in the app's secure storage and only goes to Google.

file requiredstring

Absolute path to the service-account.json key.

settings_save Write

Pick the AI used for brainstorming (a CLI, a local model through Ollama, or OpenRouter once its key is saved in Settings → AI), its model and reasoning level (null = the recommended model: Sonnet 5.5 on Claude Code, a Luna model on Codex, the newest GPT-5 on OpenRouter, the CLI default elsewhere), how often every app is re-checked on its own (default daily) and at what hour, how many AI runs go at once, whether detail popups open on click or hover, and the countries new apps start with.

Pick the AI used for brainstorming (a CLI, a local model through Ollama, or OpenRouter once its key is saved in Settings → AI), its model and reasoning level (null = the recommended model: Sonnet 5.5 on Claude Code, a Luna model on Codex, the newest GPT-5 on OpenRouter, the CLI default elsewhere), how often every app is re-checked on its own (default daily) and at what hour, how many AI runs go at once, whether detail popups open on click or hover, and the countries new apps start with.

aiProvider claude | codex | opencode | gemini | cursor | grok | ollama | openrouter

Provider.

aiModel object

Model and reasoning level for one provider. Models are listed by Settings → AI agent.

aiCli object

Which installed copy of a CLI to run, when status lists more than one (ai_status copies). null = the newest (default).

autoCheck off | daily | weekly | biweekly | monthly

Auto-check interval.

autoCheckHour integer | null

Local hour (0–23) scheduled checks run at, once per interval; null = any time (default).

updateSource github | website

Where in-app updates download first: github (default) or website (wowkeywords.com). The other is the fallback.

aiParallel integer

AI runs at once across every app (brainstorms, translations, audits, chat), 1–4, default 3. App Store checks have their own queue and are not affected.

details click | hover

Detail popups open on click (default) or on hover.

boardMetrics string[]

Metrics shown on the board, at least one. Default: all three. Order is always rank, difficulty, volume.

defaultMarkets string[]

Storefront codes for new apps.

job_stop Write

Stop a running job for an app (status lists them).

Stop a running job for an app (status lists them). Stopping localize also drops the keywords still waiting to be translated; phrases already written stay.

appId requiredstring

App id from status ("bs_…" = brainstorm).

kind requiredfetch | brainstorm | localize | check | agent | audit | auditLocalize | auditCopy | auditReview | publish | overview | pricing | opportunity | shotsHeadings | shotsLocalize | shotsRender | shotsPublish

Job kind.

ai_pause Write

An AI ran out of usage mid-work (status aiPauses): its tasks are paused, not failed.

An AI ran out of usage mid-work (status aiPauses): its tasks are paused, not failed. switch = run the paused work on another AI (to; it also becomes the AI in use), retry = try the same AI again now, stop = let the paused work fail. Without a decision it resumes by itself at resetsAt when the plan has one.

provider requiredclaude | codex | opencode | gemini | cursor | grok | ollama | openrouter

The paused AI.

action requiredswitch | retry | stop

What to do.

to claude | codex | opencode | gemini | cursor | grok | ollama | openrouter

The AI to switch to (switch only).

Troubleshooting

“Wow Keywords is not running and could not be opened.”

Open Wow Keywords, then ask again.

“Activate Wow Keywords first.”

Enter your license key in the app.

The agent doesn’t see the tools

Start a new agent session. Check its list command (claude mcp list, codex mcp list, opencode mcp list).

It worked, then stopped after moving or reinstalling the app

Click MCP in the Wow Keywords sidebar and press Update next to the agent.

A long job seems stuck

Ask the agent to call status. Jobs keep running in the app; wait returns within 50 seconds by design.

Still stuck? Chat with us.