App audit (lite)

• The user wants an assessment of their own app or a competitor's ("audit", "teardown", "what should I fix").
• Before an ASO rewrite (run aso-keywords-metadata-rewrite afterwards for the metadata itself).
• Prefer audit_app instead when the user wants the full report or a link to share, or has not used their free audit yet (call it with free_only: true to run it only if it is free). Stay on this lite flow when credits are tight or for a quick check.
• Not for idea hunting (use find-app-ideas) or for turning reviews into tickets (use reviews-to-github-issues).

• app (required): anything that identifies the app - store URL, Apple id (284882215), Play package (com.spotify.music), bundle id or a name. If a name resolves to the wrong app (check the warning in the tool output), ask the user for the store link.
• country (optional, default us): two-letter storefront code. Audit one country per run.

Call the AppGoat MCP tools in this order. Costs are AppGoat credits; every tool output ends with a footer showing credits_used and credits_remaining - stop and tell the user if remaining credits drop below 50. Without the MCP, use the REST equivalents in the REST calls below.

Budget: about 25 credits (up to ~40 with refreshes and a second reviews page). Do not page through more reviews unless the user asks.

If a call answers that data is still being refreshed (refreshing, a job_id), call get_job {id} (free) every few seconds until it is done, then repeat the original call once.

Score each area Good / Needs work / Problem using these thresholds:

• Rating: Problem if rating < 4.0 or the 90-day history shows a drop ≥ 0.1; Needs work if 4.0–4.4; Good if ≥ 4.5. Flag if 1★ share of the histogram > 15%.
• Rating volume: Needs work if ratings_count grew < 1% in 90 days while competitors' median ratings_count is ≥ 5× higher (prompt for ratings in the app).
• Freshness: Problem if updated_at > 180 days ago; Needs work if > 60 days. Release notes that are generic ("bug fixes and improvements") in ≥ 3 of the last 5 versions: Needs work.
• Title / subtitle (Apple 30 / 30 characters; Play title 30, short description 80): Needs work if either uses < 70% of its limit, if the title has no non-brand keyword, or if the subtitle repeats title words.
• Keywords: count ranked terms with rank ≤ 10 and popularity ≥ 30 ("winning"), and terms with rank 11–50 and popularity ≥ 30 ("striking distance"). Problem if winning = 0; every striking-distance term with relevance < 0.7 is a metadata opportunity.
• Complaints: a theme counts when ≥ 3 of the 1–2★ reviews mention it, or ≥ 1 mentions a crash, data loss, a billing/subscription problem or a login lockout. Unanswered 1–2★ reviews (no reply)

  50%: Needs work.

• Competitors: note every competitor that changed its title or subtitle in the last 60 days (they are targeting new terms) and any competitor with rating ≥ 0.3 higher than the app.
• Localization: Needs work if languages has 1 entry and any competitor has ≥ 5.

Fix list: at most 7 items, each tied to a finding above, ordered by (impact × ease). Crashes and billing complaints always come first, then title/subtitle keyword gaps, then everything else. Never invent numbers; if a value is missing, say "no data".

# App audit: <title> (<store>, <country>) - <date>

**Verdict:** <one sentence>

| Area | Status | Evidence |
|---|---|---|
| Rating | Good / Needs work / Problem | 4.6★ (42,310 ratings), −0.05 in 90 days, 1★ 6% |
| Freshness | … | v3.2.1, updated 12 days ago |
| Title & subtitle | … | "…" (24/30), "…" (18/30) |
| Keywords | … | 4 winning, 9 striking distance |
| Complaints | … | login loop (7), sync lost data (2) |
| Competitors | … | X changed subtitle to "…" on <date> |
| Localization | … | English only; 3 of 5 competitors ≥ 5 languages |

## Top fixes
1. **<fix>** - why (evidence), expected effect.
2. …

## Keyword opportunities
| Term | Popularity | Difficulty | Your rank | Relevance | Action |
|---|---|---|---|---|---|

## What users say
- Love: "<≤ 120-char quote>" (5★, v3.2)
- Hate: <theme> - "<quote>" (1★, v3.2)

## Competitors
| App | Rating | Ratings | Updated | Recent change |
|---|---|---|---|---|

_Credits used: <sum of the footers>._

**Automate this →** weekly competitor changes and review alerts: see the `reviews-to-github-issues`
playbook; metadata fixes: `aso-keywords-metadata-rewrite`.

Without the AppGoat MCP server, call the API directly. Base URL https://api.appgoat.ai/v1, header x-api-key: $APPGOAT_API_KEY (create a key at https://dash.appgoat.ai). Responses are { "data": …, "meta": { "credits_used", "credits_remaining", "freshness", "next_cursor", "warnings" } }; errors are { "error": { "code", "message", "hint" } } - read hint. {app} must be URL-encoded.

curl -s -H "x-api-key: $APPGOAT_API_KEY" \
  "https://api.appgoat.ai/v1/apps/$(python3 -c 'import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=""))' 'https://apps.apple.com/us/app/id284882215')?country=us"