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.
Documentation
Connect
Pick your agent. Wow Keywords needs to be installed and activated.
Claude Code
- 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
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
Check:
claude mcp listshowswow-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, thenstatus. It repeats until the job is done. - You can watch the same job in the Wow Keywords window, and stop it there.
audit_publishwrites 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.