9 ASOScan

keyword-spy Skill

当用户想用 ASOScan 的关键词间谍功能反查一款应用排名的所有关键词时使用(该应用出现的完整关键词集合,包括社区排名池和发现的关键词),并标记出你是否已在追踪这些词。当用户提到"这个应用排在哪些关键词下"、"关键词反查"、"侦察竞争对手的关键词"、"X 在哪些搜索词上胜出"或"他们的哪些关键词我漏掉了"时也使用。要了解更全面的竞争格局,参见 competitor-analysis。

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

查看源码

技能指令原文(SKILL.md)

Keyword Spy

See the full keyword footprint of an app — yours or a tracked competitor's — with
ASOScan, and mine it for real terms you should be targeting too.

When to use

  • "What keywords does rank for?"
  • "Spy on 's keywords."
  • "Which of their terms am I not tracking?"

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 |
| Is the rival tracked? | get_competitors | GET /apps/{id}/competitors | free |
| Add the rival by store link (changes data) | add_competitor | POST /apps/{id}/competitors with { "storeUrl": "..." } | 2, ask first |
| Spy | spy_competitor_keywords | GET /apps/{id}/keyword-spy?country= | 2 |

Steps

  1. Find the app — GET /apps → use the id.
  • Own app → spy it directly.
  • A rival → it must be a tracked competitor first. Check

GET /apps/{id}/competitors; if absent, add it via
POST /apps/{id}/competitors { "storeUrl": "…" } (2 credits, write key),
then spy the returned competitor's id. Add-by-URL only — there's no lookup
by app name.

  1. Spy — GET /apps/{id}/keyword-spy?country= (2 credits) →

`{ appName, totalKeywordsFound, communityPoolSize, discoveryStatus,
keywords[]{ term, rank, volume, difficulty, origin, isTracked } }`.

  • origin = "community" \| "discovered"; isTracked = already in your set.
  • discoveryStatus = "cached" \| "none". The public API doesn't trigger a

fresh crawl, so a just-added competitor may be sparse until ASOScan's
background discovery has cached results — re-calling won't add more right away.

How to analyze

  1. Coverage — how many terms, split by origin.
  2. Steal list (the payoff) — terms the competitor ranks for that are relevant

to your app AND isTracked = false. Filter for relevance first.

  1. Overlap — terms you both rank for (battlegrounds).
  2. Feed the best into keyword-intelligence (validate) then keyword-opportunities

(track) — the natural next steps in ASOScan.

Output template

### Keyword spy — {target app} ({country})   ·  credits left: {remaining}

Ranks for **{totalKeywordsFound}** keywords ({communityPoolSize} pooled · rest discovered).

**Terms worth stealing** (they rank, relevant, not yours yet)
| Keyword | Rank | Origin | Note |
|---|---|---|---|

**Shared battlegrounds**
| Keyword | Their rank | Origin |
|---|---|---|

Errors, credits & honesty

  • 401 → asoscan-setup · 403 no API access (or read-only key on the add) · 402

out of credits · 404 not owned/tracked · 503 not enabled yet. Spy = 2 credits,
add-competitor = 2.

  • A term appearing in spy is a ranking signal, not proof it suits your app — filter

for relevance. Clean numbers only.

  • Full reference:

Related

  • competitor-analysis — the fuller competitive picture.
  • keyword-intelligence — validate stolen terms.
  • keyword-opportunities — track the winners.

配合站内内容