Cursor · App Store Connect

Do App Store keyword research from Cursor

Ask Cursor what people type before they find apps like yours. MetaRun reads App Store autocomplete, checks where you rank in each storefront, tracks the keywords you pick, and lints the keyword field before you stage a change.

Start Free Trial See pricing →

Setup checked October 2026 against Cursor MCP docs, Cursor CLI

01 · Uplink

Connect Cursor once

01 · Add to ~/.cursor/mcp.json (or .cursor/mcp.json for one project)

{
  "mcpServers": {
    "metarun": {
      "url": "https://metarun.dev/api/mcp"
    }
  }
}

02 · Or use the install link

Opens Cursor with the server filled in.

https://cursor.com/link/mcp/install?name=metarun&config=eyJ1cmwiOiJodHRwczovL21ldGFydW4uZGV2L2FwaS9tY3AifQ%3D%3D

03 · Sign in

When Cursor connects, MetaRun opens in your browser. Pick read-only or read and change, and you're back in the editor with the tools listed under MCP.

Prefer a personal access token (scripts, CI)?

Use a token instead

Mint a personal access token in MetaRun under Settings, MCP. It's shown once and can be revoked any time. Cursor reads ${env:METARUN_TOKEN} from your environment. Some Cursor versions start the browser sign-in even when a header is set; if that happens, signing in works the same.

{
  "mcpServers": {
    "metarun": {
      "url": "https://metarun.dev/api/mcp",
      "headers": { "Authorization": "Bearer ${env:METARUN_TOKEN}" }
    }
  }
}

02 · Briefing

What Cursor handles here

Apple doesn't publish search volume. The signals you do have are autocomplete suggestions, where you rank today, which apps hold the top spots, and, once enabled, Apple's own search impression reports for your app.

MetaRun turns those into tools. Cursor can research terms, track them, check ranks on demand, and write keyword fields that fit in 100 characters without repeating what your name already covers.

03 · Preflight

Before you start

Seed terms that describe your app.
The storefronts you care about.
For measured search data: an Admin key, once, to enable Apple's analytics reports.

04 · Execution

How it runs

01
Research
Cursor expands seed terms with autocomplete and checks who ranks for them.
02
Pick and track
Tracked keywords are checked on a schedule by MetaRun's rank Sentinel, which reports moves of five places or more and entries into the top ten.
03
Write the field
The agent drafts keywords and the lint checks them before the localization preview stages the change.
04
Measure
With search analytics enabled, Apple's own impression and conversion data shows whether the change moved anything.

05 · Session

An example session in Cursor

Where do we rank for 'budget planner' in the US, Canada and Australia?

aso_suggest_keywordsAutocomplete for 'habit' in the US storefront.
aso_keyword_leadersThe apps holding the top five spots for each candidate.
aso_track_keywords15 terms tracked in the US and UK.
aso_lint_metadataKeyword field: two words repeat the subtitle.
apple_preview_set_version_localizationPreview: English (U.S.) keywords, 99 of 100 characters.
Cursor asks before running apple_apply_set_version_localization. You read the preview above and approve.
apple_apply_set_version_localizationApplied.

Illustrative: your apps, versions and numbers will differ. The tool names and their order are real.

06 · Tools

The MetaRun tools Cursor calls

Tool	What it does
aso_suggest_keywordsread	App Store autocomplete for a seed term in a storefront.
aso_check_rankread	Where the app ranks for a term right now.
aso_track_keywordsMetaRun	Track terms over time, per storefront.
aso_keyword_historyread	Rank history for a tracked term.
aso_keyword_leadersread	Which apps hold the top spots for a term.
aso_lint_metadataread	Rulebook check: wasted characters, repeats, limits.
aso_get_search_performanceread	Apple's measured search impressions and conversion, once reports are enabled.
aso_scan_rivalsMetaRun	What changed in competitors' listings since the last scan.

Each preview has an apply twin (the same name with apply instead of preview) that only runs with the confirm token from a fresh preview, and refuses if App Store Connect changed in between. MetaRun tools save to your MetaRun workspace only (studio projects, tracked keywords), never to Apple.

07 · Apple rules

What Apple enforces, and how MetaRun handles it

The keyword field is 100 characters

Commas count. Spaces after commas are wasted, and words in your name or subtitle are already indexed, so repeating them spends characters for nothing.

Ranks differ per storefront

A term can rank 4th in the US and 60th in the UK. MetaRun tracks and checks per storefront.

Search analytics take a day or two

Apple's analytics reports need a one-time request with an Admin key, and the first reports arrive one to two days later.

Extra languages add keyword room

Storefronts index more than one listing language. The US indexes nine besides English (U.S.), each with its own keyword field.

08 · Comms

What to ask Cursor

Ask Cursor: Where do we rank for 'budget planner' in the US, Canada and Australia?
Ask Cursor: Lint our keyword fields in every language.
Ask Cursor: What changed in our top three competitors' listings this week?

09 · Unattended

Run it from a script with Cursor

The Cursor CLI runs one request without the editor with agent -p. Allow only the read tools the request needs in ~/.cursor/cli-config.json (Mcp(metarun:tool_name) rules), and keep MetaRun's apply tools out of that list.

Read-only check, safe to schedule

agent -p "Check the current rank of com.example.app for every tracked keyword and list the biggest moves since last week. Read only." --output-format json

Don't run it with --force for MetaRun: that approves every tool, applies included.

10 · Safety

How Cursor asks before a change

Cursor asks before each MCP tool call by default, following your Run Mode settings. Keep MetaRun's apply tools on ask: that prompt is the confirm step for every App Store change. In the Cursor CLI, allow rules live in ~/.cursor/cli-config.json in the form Mcp(server:tool), so you can allow MetaRun's read tools and leave the applies out.

Apple key stays on MetaRun, encryptedPreview before every writeRecorded, revertible from history

11 · FAQ

Frequently asked questions

Does MetaRun show keyword search volume?

No, because Apple doesn't publish it and any number would be an estimate. MetaRun uses autocomplete, live ranks, who holds the top spots, and Apple's own impression data for your app once enabled.

How often are tracked keywords checked?

The rank Sentinel scans tracked keywords on a schedule and records findings such as moves of five or more places. Cursor can also check any term on demand.

Can Cursor change my keywords directly?

It stages the change through the same localization preview as any listing edit. You approve it, and it's in your history if you want it back.

How many keywords can I track?

25 on Starter, 200 on Pro, unlimited on Studio, and 10 during the 14-day trial.

How do I connect Cursor to App Store Connect?

Add https://metarun.dev/api/mcp to ~/.cursor/mcp.json (or use the install link) and sign in to MetaRun when Cursor opens your browser. After that, ask for "aso keywords" in plain words and Cursor picks the MetaRun tools.

Does Cursor see my App Store Connect key?

No. Your App Store Connect API key stays envelope-encrypted on MetaRun's servers and is decrypted per request. Cursor holds a MetaRun token that you can revoke in Settings at any time.

More with Cursor

Cursor

Localize your listing

Name, subtitle, keywords and description in every App Store language, limits checked.

Open

Cursor

Reply to reviews

Triage App Store reviews, find the themes, and post replies you've approved.

Open

Cursor

Screenshots

Design, caption, translate and upload App Store screenshots from a prompt.