{"id":27175,"plugin_id":"plugin_asdk_app_6ac31e16fb6881919510d9cb1ea39463","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-10-06T18:05:25.802Z","digest":"d4b7279702a2628b6a5728e691c8c665ad0744f0b0b6f4e92c5af384e82d0172","against":null,"payload":{"description":"When the user wants the best untapped keywords for an app tracked in ASOScan (gap-scored suggestions ranked by opportunity score, each showing which competitors already rank for the term). Also use when the user mentions \"what keywords should I target\", \"find keyword opportunities\", \"what am I missing\", \"keyword gaps vs my competitors\", or \"suggest keywords to add\". Can also start tracking the chosen terms. For validating a specific term's volume/difficulty, see keyword-intelligence.","included_files":[],"name":"keyword-opportunities","skill_md_contents":"---\nname: keyword-opportunities\ndescription: When the user wants the best untapped keywords for an app tracked in ASOScan (gap-scored suggestions ranked by opportunity score, each showing which competitors already rank for the term). Also use when the user mentions \"what keywords should I target\", \"find keyword opportunities\", \"what am I missing\", \"keyword gaps vs my competitors\", or \"suggest keywords to add\". Can also start tracking the chosen terms. For validating a specific term's volume/difficulty, see keyword-intelligence.\nmetadata:\n  version: 1.3.1\n---\n\n# Keyword Opportunities\n\nAnswer \"what should I target next?\" with ASOScan's pre-computed, opportunity-scored\nsuggestions, then track the winners, all from real numbers.\n\n## When to use\n\n- \"What keywords should I add / target?\"\n- \"Where are my keyword gaps vs competitors?\"\n- \"Suggest high-opportunity keywords for my app.\"\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| Opportunities | `find_keyword_opportunities` | `GET /apps/{id}/opportunities?country=&limit=50` | 2 |\n| Validate a finalist | `research_keyword` | `GET /apps/{id}/keywords/research?term=&country=` | 8, say the cost first |\n| Track the picks (changes data) | `track_keywords` | `POST /apps/{id}/keywords` with `{ \"terms\": [...], \"country\": \"US\" }` | 2, ask first |\n\n## Steps\n\n1. **Find the app** — `GET /apps` → use the `id`.\n2. **Opportunities** — `GET /apps/{id}/opportunities?country=&limit=50` (**2 credits**,\n   limit 1–200). Each row: `{ term, volume, difficulty, opportunityScore,\n   competitorRanks[]{ name, rank, isYou } }`. There is **no** \"source\" field — rank\n   by `opportunityScore` and read `competitorRanks` for context (the entry with\n   `isYou: true` is the owner; `rank: null` there = you don't rank yet).\n3. **(Optional) validate a shortlisted term** — the research call in\n   **keyword-intelligence** (8 credits), for a few finalists only.\n4. **(Optional) track the picks** — `POST /apps/{id}/keywords` with\n   `{ \"terms\": [...], \"country\": \"US\" }` (**2 credits**, needs a **write** key; up\n   to 500 terms) → `{ added[], skipped[]{ term, reason } }`.\n\n## How to prioritize\n\nSort by `opportunityScore`, then sanity-check each candidate:\n\n1. **Relevant?** Would a searcher for this term actually want this app? Drop\n   off-topic high-volume terms — irrelevant installs churn.\n2. **Winnable?** Is `difficulty` realistic for this app's authority?\n3. **A real gap?** In `competitorRanks`, `isYou` has a null/poor rank while rivals\n   rank well → the sharpest opportunity.\n\nGroup into **Quick wins** (high score, low difficulty, relevant, you don't rank)\nand **Watchlist** (promising but harder / needs validation).\n\n## Output template\n\n```\n### Keyword opportunities — {App} ({country})   ·  credits left: {remaining}\n\n**Quick wins** (track these)\n| Keyword | Volume | Difficulty | Score | You rank? | Rivals ranking |\n|---|---|---|---|---|---|\n| … | … | … | … | no | Rival A #4, Rival B #9 |\n\n**Watchlist**\n| Keyword | Volume | Difficulty | Score | Note |\n|---|---|---|---|---|\n\n**Next in ASOScan:** track the quick wins → track_keywords or POST /apps/{id}/keywords,\nthen place them with `metadata-audit`.\n```\n\nIf the user approves tracking, call the write endpoint and report `added`/`skipped`.\n\n## Errors, credits & honesty\n\n- `401` → asoscan-setup · `403` = no API access **or** a read-only key on the write\n  call (tell them to create a **read + write** key) · `402` out of credits · `429`\n  back off · `503` not enabled yet. Opportunities = 2 credits, tracking = 2.\n- Present numbers cleanly; never track terms without asking; don't overpromise ranks.\n- Full reference: <https://asoscan.com/api/developers>\n\n## Related\n\n- **keyword-intelligence** — validate a shortlisted term.\n- **competitor-analysis** — see which competitors drive the gap.\n- **metadata-audit** — place the chosen keywords into the listing.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}