{"id":27176,"plugin_id":"plugin_asdk_app_6ac31e16fb6881919510d9cb1ea39463","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-06T18:05:25.837Z","digest":"0cc0290e7b3362da04fa0436ded51df400d34384dbe5366f10c7c3f3bf3447e5","against":null,"payload":{"description":"When the user wants to reverse-look-up every keyword an app ranks for using ASOScan's keyword-spy (the full set of terms an app appears under, community rank pool plus discovered terms), flagged by whether you already track them. Also use when the user mentions \"what keywords does this app rank for\", \"reverse keyword lookup\", \"spy on a competitor's keywords\", \"what search terms is X winning\", or \"which of their keywords am I missing\". For the fuller competitive picture, see competitor-analysis.","included_files":[],"name":"keyword-spy","skill_md_contents":"---\nname: keyword-spy\ndescription: When the user wants to reverse-look-up every keyword an app ranks for using ASOScan's keyword-spy (the full set of terms an app appears under, community rank pool plus discovered terms), flagged by whether you already track them. Also use when the user mentions \"what keywords does this app rank for\", \"reverse keyword lookup\", \"spy on a competitor's keywords\", \"what search terms is X winning\", or \"which of their keywords am I missing\". For the fuller competitive picture, see competitor-analysis.\nmetadata:\n  version: 1.3.1\n---\n\n# Keyword Spy\n\nSee the full keyword footprint of an app — yours or a tracked competitor's — with\nASOScan, and mine it for real terms you should be targeting too.\n\n## When to use\n\n- \"What keywords does `<app>` rank for?\"\n- \"Spy on `<competitor>`'s keywords.\"\n- \"Which of their terms am I not tracking?\"\n\n## Getting the data (two modes)\n\nPick the first mode that applies, then follow the steps below.\n\n1. **ASOScan tools are connected** (the ASOScan plugin or connector in ChatGPT or Claude, or any MCP client): use the tool named in the table. Do not ask for an API key and do not run `curl`. Tool results have the same fields as the API responses below, and a list comes back inside `items`. If a tool answers with a message instead of data (reconnect, credits used up, plan limit, \"preparing\"), pass that message on and stop.\n2. **No tools, but you can run shell commands and `ASOSCAN_API_KEY` is set**: make the API call in the table. Base `https://asoscan.com/api/public/v1`, header `Authorization: Bearer $ASOSCAN_API_KEY`, JSON with camelCase fields. Never print the key. Capture the HTTP status and handle errors as described at the bottom.\n3. **Neither**: hand off to **asoscan-setup**. It explains how to connect ASOScan in ChatGPT or Claude, or how to create an API key.\n\nASOScan only sees the apps in the user's own account and the competitors they track. Every call uses API credits (failed calls are free). Before a call that costs more than 2 API credits, or one that uses AI, tell the user the cost and wait for a yes. Before any call that changes data, ask first.\n\n| Step | Tool (connected) | API call (key) | API credits |\n|---|---|---|---|\n| Find the app | `list_my_apps` | `GET /apps` | 1 |\n| Is the rival tracked? | `get_competitors` | `GET /apps/{id}/competitors` | 1 |\n| Add the rival by store link (changes data) | `add_competitor` | `POST /apps/{id}/competitors` with `{ \"storeUrl\": \"...\" }` | 2, ask first |\n| Spy | `spy_competitor_keywords` | `GET /apps/{id}/keyword-spy?country=` | 2 |\n\n## Steps\n\n1. **Find the app** — `GET /apps` → use the `id`.\n   - **Own app** → spy it directly.\n   - **A rival** → it must be a **tracked competitor** first. Check\n     `GET /apps/{id}/competitors`; if absent, add it via\n     `POST /apps/{id}/competitors { \"storeUrl\": \"…\" }` (2 credits, **write** key),\n     then spy the returned competitor's `id`. Add-by-URL only — there's no lookup\n     by app name.\n2. **Spy** — `GET /apps/{id}/keyword-spy?country=` (**2 credits**) →\n   `{ appName, totalKeywordsFound, communityPoolSize, discoveryStatus,\n   keywords[]{ term, rank, volume, difficulty, origin, isTracked } }`.\n   - `origin` = `\"community\"` \\| `\"discovered\"`; `isTracked` = already in your set.\n   - `discoveryStatus` = `\"cached\"` \\| `\"none\"`. The public API doesn't trigger a\n     fresh crawl, so a just-added competitor may be sparse until ASOScan's\n     background discovery has cached results — re-calling won't add more right away.\n\n## How to analyze\n\n1. **Coverage** — how many terms, split by `origin`.\n2. **Steal list** (the payoff) — terms the *competitor* ranks for that are relevant\n   to your app AND `isTracked = false`. Filter for relevance first.\n3. **Overlap** — terms you both rank for (battlegrounds).\n4. Feed the best into **keyword-intelligence** (validate) then **keyword-opportunities**\n   (track) — the natural next steps in ASOScan.\n\n## Output template\n\n```\n### Keyword spy — {target app} ({country})   ·  credits left: {remaining}\n\nRanks for **{totalKeywordsFound}** keywords ({communityPoolSize} pooled · rest discovered).\n\n**Terms worth stealing** (they rank, relevant, not yours yet)\n| Keyword | Rank | Origin | Note |\n|---|---|---|---|\n\n**Shared battlegrounds**\n| Keyword | Their rank | Origin |\n|---|---|---|\n```\n\n## Errors, credits & honesty\n\n- `401` → asoscan-setup · `403` no API access (or read-only key on the add) · `402`\n  out of credits · `404` not owned/tracked · `503` not enabled yet. Spy = 2 credits,\n  add-competitor = 2.\n- A term appearing in spy is a ranking signal, not proof it suits your app — filter\n  for relevance. Clean numbers only.\n- Full reference: <https://asoscan.com/api/developers>\n\n## Related\n\n- **competitor-analysis** — the fuller competitive picture.\n- **keyword-intelligence** — validate stolen terms.\n- **keyword-opportunities** — track the winners.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}