9 ASOScan

keyword-opportunities Skill

当用户想获取 ASOScan 中已追踪应用的最佳未开发关键词时使用(按机会评分排序的差距评分建议,每条显示哪些竞争对手已在该词上有排名)。当用户提到"我该瞄准哪些关键词"、"寻找关键词机会"、"我漏掉了什么"、"和竞争对手相比的关键词差距"或"推荐要添加的关键词"时也使用。还可以开始追踪选定的关键词。要验证某个具体词的搜索量/难度,参见 keyword-intelligence。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

Keyword Opportunities

Answer "what should I target next?" with ASOScan's pre-computed, opportunity-scored
suggestions, then track the winners, all from real numbers.

When to use

  • "What keywords should I add / target?"
  • "Where are my keyword gaps vs competitors?"
  • "Suggest high-opportunity keywords for my app."

Getting the data (two modes)

Pick the first mode that applies, then follow the steps below.

  1. 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.
  2. 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.
  3. Neither: hand off to asoscan-setup. It explains how to connect ASOScan in ChatGPT or Claude, or how to create an API key.

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 |

Steps

  1. Find the app — GET /apps → use the id.
  2. Opportunities — 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).

  1. (Optional) validate a shortlisted term — the research call in

keyword-intelligence (8 credits), for a few finalists only.

  1. (Optional) track the picks — POST /apps/{id}/keywords with

{ "terms": [...], "country": "US" } (2 credits, needs a write key; up
to 500 terms) → { added[], skipped[]{ term, reason } }.

How to prioritize

Sort by opportunityScore, then sanity-check each candidate:

  1. Relevant? Would a searcher for this term actually want this app? Drop

off-topic high-volume terms — irrelevant installs churn.

  1. Winnable? Is difficulty realistic for this app's authority?
  2. A real gap? In 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).

Output template

### 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.

Errors, credits & honesty

  • 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.

  • Present numbers cleanly; never track terms without asking; don't overpromise ranks.
  • Full reference:

Related

  • keyword-intelligence — validate a shortlisted term.
  • competitor-analysis — see which competitors drive the gap.
  • metadata-audit — place the chosen keywords into the listing.

配合站内内容