Use it when you want 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).
Listed ·Updated
Install data from skills.sh
Keyword Opportunities is a Keyword Research skill for AI agents, published in the seoskills.sh catalog. Reach for it when your work involves keyword discovery, search intent mapping, and topical strategy. Install it with one command and it runs inside your own agent, so the work happens in your workflow, not a separate SEO tool.
Answer "what should I target next?" with ASOScan's pre-computed, opportunity-scored suggestions, then track the winners, all from real numbers.
Pick the first mode that applies, then follow the steps below.
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.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.ASOScan 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.
| Step | Tool (connected) | API call (key) | API credits |
|---|---|---|---|
| Find the app | list_my_apps | GET /apps | free |
| Opportunities | find_keyword_opportunities | GET /apps/{id}/opportunities?country=&limit=50 | 2 |
| Validate a finalist | research_keyword | GET /apps/{id}/keywords/research?term=&country= | 8, say the cost first |
| Track the picks (changes data) | track_keywords | POST /apps/{id}/keywords with { "terms": [...], "country": "US" } | 2, ask first |
GET /apps → use the id.GET /apps/{id}/opportunities?country=&limit=50 (2 credits,
limit 1–200). Each row: { term, volume, difficulty, opportunityScore, competitorRanks[]{ name, rank, isYou } }. There is no "source" field — rank
by opportunityScore and read competitorRanks for context (the entry with
isYou: true is the owner; rank: null there = you don't rank yet).POST /apps/{id}/keywords with
{ "terms": [...], "country": "US" } (2 credits, needs a write key; up
to 500 terms) → { added[], skipped[]{ term, reason } }.Sort by opportunityScore, then sanity-check each candidate:
difficulty realistic for this app's authority?competitorRanks, isYou has a null/poor rank while rivals
rank well → the sharpest opportunity.Group into Quick wins (high score, low difficulty, relevant, you don't rank) and Watchlist (promising but harder / needs validation).
### Keyword opportunities — {App} ({country}) · credits left: {remaining}
**Quick wins** (track these)
| Keyword | Volume | Difficulty | Score | You rank? | Rivals ranking |
|---|---|---|---|---|---|
| … | … | … | … | no | Rival A #4, Rival B #9 |
**Watchlist**
| Keyword | Volume | Difficulty | Score | Note |
|---|---|---|---|---|
**Next in ASOScan:** track the quick wins → track_keywords or POST /apps/{id}/keywords,
then place them with `metadata-audit`.
If the user approves tracking, call the write endpoint and report added/skipped.
401 → asoscan-setup · 403 = no API access or a read-only key on the write
call (tell them to create a read + write key) · 402 out of credits · 429
back off · 503 not enabled yet. Opportunities = 2 credits, tracking = 2.Not using the CLI? Copy the SKILL.md and paste it straight into ChatGPT, Claude, or any agent.
