菜单
Track Amazon keyword ranking positions for a specific ASIN and keyword set. Triggers: keyword rank, ASIN position, ranking changes, where does my product rank. Use for current/ranking changes, not keyword discovery or reverse ASIN lookup.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | ecommerce.keyword-rank-tracker |
| version | 2.0.0 |
| description | Track Amazon keyword ranking positions for a specific ASIN and keyword set. Triggers: keyword rank, ASIN position, ranking changes, where does my product rank. Use for current/ranking changes, not keyword discovery or reverse ASIN lookup. |
| allowed-tools | ["Bash","Read","Write"] |
IMPORTANT — Working Directory: All scripts in this skill MUST be executed with the working directory set to the absolute path of the directory containing this SKILL.md file (the skill root directory). Always
cdinto this directory before running any command. Do NOT use relative paths or shell shortcuts like~in paths, as they may not be resolved by the execution environment.
Where does this ASIN rank for the target keywords, and how are rankings changing?
How are my keyword rankings?
| Source | Endpoint | Purpose |
|---|---|---|
| Jungle Scout | {NEXSCOPE_PROXY_BASE}/api/v1/tools/jungle-scout/keywords/by-asin | keyword rankings, search volume, monthly trend for tracked ASINs |
US, CA, MX, UK, DE, FR, IT, ES, JP, IN, AU, BR, NL, SE, PL, TR, AE, SA, SG
--chart with an output directory unless the user asks for a quick text-only result or chart data is unavailable.ecommerce_chart_helpers.py which reads from chart_style.json (derived from references/display-rules.md). Do NOT hardcode colors in scripts.# Basic rank tracking
python3 scripts/keyword_rank_tracker.py '{"asin": "B0BTYCRJSS"}'
# Specific market
python3 scripts/keyword_rank_tracker.py '{"asin": "B0BTYCRJSS", "market": "DE"}'
# With filter conditions
python3 scripts/keyword_rank_tracker.py '{"asin": "B0BTYCRJSS", "conditions": {"isPurchaseKw": true}}'
# With charts
python3 scripts/keyword_rank_tracker.py '{"asin": "B0BTYCRJSS"}' --chart /tmp/charts
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
asin | string | Yes | - | Amazon ASIN to track |
market | string | No | Marketplace code | |
conditions | string | No | - | Filter conditions (comma-separated) |
limit | int | No | 100 | Max keywords to fetch |
| Condition | Description |
|---|---|
nfPosition | Natural traffic keywords |
isSpAd | SP ad keywords |
isBrandAd | Brand ad keywords |
isAC | Amazon's Choice keywords |
isMainKw | Main traffic keywords |
isPurchaseKw | Keywords generating orders |
isQualityKw | High conversion keywords |
isLossKw | Conversion loss keywords |
The output will be a structured markdown report, following this format:
Keyword Ranking Tracking Report: [ASIN]
1. Executive Summary
2. Keyword Ranking Overview
| Rank Range | Count | Percentage |
|---|---|---|
| Top 3 | [analysis.rank_distribution.top3] | [analysis.rank_distribution.top3_percentage]% |
| Page 1 (4-10) | [analysis.rank_distribution.page1] | [analysis.rank_distribution.page1_percentage]% |
| Page 2 (11-20) | [analysis.rank_distribution.page2] | [analysis.rank_distribution.page2_percentage]% |
| Page 3-5 (21-50) | [analysis.rank_distribution.page3_5] | [analysis.rank_distribution.page3_5_percentage]% |
| Beyond Page 5 | [analysis.rank_distribution.beyond] | [analysis.rank_distribution.beyond_percentage]% |
| Unranked | [analysis.rank_distribution.unranked] | [analysis.rank_distribution.unranked_percentage]% |
| Type | Count |
|---|---|
| HEAD (Short-tail) | [analysis.keyword_types.HEAD] |
| BODY (Mid-tail) | [analysis.keyword_types.BODY] |
| LONG_TAIL (Long-tail) | [analysis.keyword_types.LONG_TAIL] |
Traffic Type:
Search Volume Statistics:
3. Top Traffic Keywords
| Keyword | Estimated Traffic | Organic Rank | Monthly Search Volume |
|---|---|---|---|
| [analysis.top_traffic_keywords[0].keyword] | [analysis.top_traffic_keywords[0].estimated_traffic] | [analysis.top_traffic_keywords[0].organic_rank] | [analysis.top_traffic_keywords[0].monthly_search] |
| ... | ... | ... | ... |
4. Opportunities & Recommendations
| Keyword | Monthly Search Volume | Current Rank | Potential |
|---|---|---|---|
| [opportunities.high_potential[0].keyword] | [opportunities.high_potential[0].monthly_search] | [opportunities.high_potential[0].current_rank] | [opportunities.high_potential[0].potential] |
| ... | ... | ... | ... |
insights.recommendations]insights.recommendations]5. Attached Visualizations
| Tier | Rank Range | Icon |
|---|---|---|
| Top 3 | 1-3 | 🥇 |
| Page 1 | 4-10 | 🟢 |
| Page 2 | 11-20 | 🟡 |
| Page 3-5 | 21-50 | 🟠 |
| Beyond P5 | 51+ | 🔴 |
| Unranked | No rank | ⚪ |
| Type | Description | Icon |
|---|---|---|
| natural | Organic search result | 🔵 |
| sp | Sponsored Products ad | 🟢 |
| ac | Amazons Choice | 3 keywords |
Top Keywords:
| Keyword | Rank | Search/Week | Traffic |
|---|---|---|---|
| wireless earbuds | #2 | 114,175 | 16.1% |
| earbuds | #1 | 139,290 | 9.7% |
| bluetooth headphones | #12 | 138,309 | 4.7% |
| Chart | Description | File |
|---|---|---|
| Rank Distribution | Keyword rank position histogram | 1_rank_distribution.png |
| Top Traffic Keywords | Estimated traffic by keyword | 2_top_traffic.png |
| Position Types | Organic vs sponsored breakdown | 3_position_types.png |
| Keyword Types | Keyword category distribution | 4_keyword_types.png |
| Variable | Required | Description |
|---|---|---|
NEXSCOPE_PROXY_BASE | Yes | NexScope proxy base URL |
NEXSCOPE_API_KEY | Yes | NexScope proxy API key |
references/display-rules.md — Output formattingWhen analyzing more items than you want to run in a single invocation, keep charts and reports aligned by saving each batch as raw JSON and then generating one merged result.
Step 1: run each batch with --output to save intermediate JSON.
python3 scripts/keyword_rank_tracker.py '{"keyword": "example"}' --output /tmp/batch1.json
python3 scripts/keyword_rank_tracker.py '{"keyword": "example 2"}' --output /tmp/batch2.json
Step 2: merge every batch JSON and generate the final unified chart.
python3 scripts/keyword_rank_tracker.py --merge /tmp/batch1.json /tmp/batch2.json --sort score --chart /tmp/final-charts
Use the merged JSON output and /tmp/final-charts/merged_ranking.png for the final report. Do not present per-batch charts as final charts when the text report has been globally re-ranked.
Compare Amazon competitor business metrics: price, reviews, BSR, sales, seller count, traffic. Triggers: competitor metrics, who performs best, price/BSR/review comparison. Use for business performance, not listing copy; use competitor-listing-analyzer for content structure.
Analyze Amazon listing content and structure: title, bullets, images, A+ content, and listing quality. Triggers: listing breakdown, reverse-engineer listings, title/bullet/image analysis. Use for content audits, not business metrics; use competitor-analyzer for price/BSR/sales.
Validate whether demand is real by comparing search volume with sales and buying intent. Triggers: is demand real, fake demand, inflated volume, are people buying, conversion gap. Use for demand proof, not broad market overview or niche go/no-go scoring.
Check visual/design patent similarity from product images. Triggers: design infringement, look-alike patent, visual similarity, design clearance. Use for appearance/design risk, not utility claims or legal-status checks.
Suggest product differentiation and USP using competitor/review evidence. Triggers: how to stand out, USP, competitive advantage, product improvement. Use for positioning and feature strategy, not raw competitor metrics or review monitoring.
Find visually similar Amazon products from an image. Triggers: reverse image search, find lookalikes, who else sells this, source by image. Use for marketplace lookalikes, not patent similarity or design infringement checks.