SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-junglescout-keyword-by-asin

linkfox-junglescout-keyword-by-asin

Marketing & growth

View repository

Updated 10-15 09:05

About this skill

Jungle Scout — Reverse Keyword Lookup by ASIN

This skill queries keywords associated with given ASINs via the Jungle Scout data source, returning keyword search volume, competition metrics, PPC bids, ranking positions, and relevancy scores across 10 Amazon marketplaces. It supports up to 10 ASINs per call.

Core Concepts

The Jungle Scout ASIN reverse keyword lookup tool retrieves all the keywords these ASINs appear for in Amazon search results, along with detailed metrics, by entering competitor or target ASINs. Sellers can use this tool for:

  • Competitor keyword analysis: See which keywords competitors rank for organically/in ads
  • Keyword expansion: Reverse-mine high-potential keywords from known ASINs
  • Advertising reference: Get keywords' PPC bids (exact/broad match) and Sponsored Brands ad bids
  • Competitive landscape assessment: Judge keyword competition difficulty using the Ease of Ranking Score and competitor ranking data
  • Traffic structure analysis: Understand which keywords an ASIN's traffic comes from and the search volume and ranking of each keyword

Data dimensions: Each record represents a keyword and includes complete metrics such as search volume, trend, ranking, bid, and competition.

Data Fields

Output Fields

Field API Name Description Example
Keyword name Search keyword yoga mat
Marketplace country Marketplace code us
Exact search volume monthlySearchVolumeExact Monthly exact-match search volume 85420
Broad search volume monthlySearchVolumeBroad Monthly broad-match search volume 125000
Monthly trend monthlyTrend Month-over-month trend (%) 15.5
Quarterly trend quarterlyTrend Quarterly trend (%) 8.2
Main category dominantCategory Keyword main category Sports & Outdoors
Relevance relevancyScore Relevance of the keyword to the ASIN (0-100) 92
Ranking difficulty easeOfRankingScore Ease of ranking (0-100, higher is easier) 45
Organic rank organicRank The ASIN's organic search ranking 5
Ad rank sponsoredRank The ASIN's ad ranking 3
Overall rank overallRank Overall ranking position 4
Organic result count organicProductCount Total number of products in organic search results 2000
Ad result count sponsoredProductCount Total number of products in ad slots 48
PPC exact bid ppcBidExact Exact-match PPC suggested bid (USD) 1.25
PPC broad bid ppcBidBroad Broad-match PPC suggested bid (USD) 0.95
SB ad bid spBrandAdBid Sponsored Brands ad suggested bid (USD) 2.10
Recommended promotion count recommendedPromotions Recommended promotion volume 5
Top ASIN primaryAsin The highest-ranked ASIN for this keyword B0XXXXXXXX
Organic relative position relativeOrganicPosition The relative position of the queried ASIN's organic ranking 0.12
Ad relative position relativeSponsoredPosition The relative position of the queried ASIN's ad ranking 0.08
Number of organically ranked ASINs organicRankingAsinsCount Number of queried ASINs with an organic ranking 3
Number of ad-ranked ASINs sponsoredRankingAsinsCount Number of queried ASINs with ad rankings 2
Average organic rank of competitors avgCompetitorOrganicRank Average organic rank of queried ASINs 12.5
Average ad rank of competitors avgCompetitorSponsoredRank Average ad rank of queried ASINs 8.3
Lowest organic rank among variants variationLowestOrganicRank Best organic rank among variants 3
Lowest ad rank among variants variationLowestSponsoredRank Best ad rank among variants 2
Competitor organic rank details competitorOrganicRank Array of organic ranks for each ASIN [{asin, organicRank}]
Competitor ad rank details competitorSponsoredRank Array of ad ranks for each ASIN [{asin, sponsoredRank}]
Update time updatedAt Last data update time 2026-04-10
Token consumption costToken Number of tokens consumed by this call 10

Supported Marketplaces

us (United States), uk (United Kingdom), de (Germany), in (India), ca (Canada), fr (France), it (Italy), es (Spain), mx (Mexico), jp (Japan)

Default marketplace is us. Use us when the user doesn't specify a marketplace.

Invocation method

  • API endpoint：POST /tool-jungle-scout/keywords/by-asin(For full parameters/response/error codes, see references/api.md）
  • Python script：python scripts/junglescout_keyword_by_asin.py '<JSON 参数>' [--inline]
  • Cost constraints: This tool consumes compute; by default, the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, do not automatically try different keywords, paginate, or change zip codes in continuous probing; if further retrieval is needed, first explain to the user that additional consumption will be incurred.

Output strategy (default script behavior)：

  • Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-keyword-by-asin-<timestamp>.json（<cwd> is the working directory when the script runs, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;Writing to /tmp is prohibited, and if the current directory is not writable, report an error)
  • Response body ≤ 8 KB: after writing to disk, print the full JSON to stdout
  • Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, length of the largest list field + first 3 samples)
  • Add --inline to force full printing to stdout (also written to disk)

Data reading suggestions: First look at the summary to determine whether it is sufficient; when specific fields are needed, prefer using jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide resolution:

Abnormal situations

  • API Key not configured: The environment variable is not configured with LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
  • Response 401 or 402 status code
  • Response indicates insufficient compute or balance: The message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with similar meaning.

How to Build Queries

Required parameters: marketplace and asins. All other parameters are optional filters for narrowing results.

Principles for Building API Calls

  1. Site mapping: User says "US site" → us, "Japan site" → jp, "Germany site" → de; if unspecified, default to us
  2. ASIN format: Standard 10-character Amazon ASIN (starting with B0), passed in as an array, up to 10
  3. Search volume filtering: User says "search volume greater than 10,000" → minMonthlySearchVolumeExact: 10000; "search volume 1000 to 5000" → min: 1000, max: 5000
  4. Sort selection: Default is descending by exact search volume (-monthly_search_volume_exact); user requests "sort by relevance" → sort: -relevancy_score
  5. Result count: If the user says "give me the top 50" → needCount: 50; if unspecified, set appropriately based on the scenario (e.g., 30-100)
  6. Include variants: Set includeVariants: true

Common Query Scenarios

1. View the core traffic keywords for a competitor ASIN

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "needCount": 50,
  "sort": "-monthly_search_volume_exact"
}

2. Common keywords across multiple ASINs (competitor comparison)

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX", "B0YYYYYYYY", "B0ZZZZZZZZ"],
  "needCount": 100,
  "sort": "-relevancy_score"
}

3. Filter high-search-volume, low-competition keywords

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "minMonthlySearchVolumeExact": 5000,
  "maxOrganicProductCount": 500,
  "needCount": 50,
  "sort": "-ease_of_ranking_score"
}

4. Find long-tail keywords (multi-word combinations)

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "minWordCount": 3,
  "minMonthlySearchVolumeExact": 500,
  "needCount": 80,
  "sort": "-monthly_search_volume_exact"
}

5. Analysis of competitor advertising keywords for the Japan marketplace

{
  "marketplace": "jp",
  "asins": ["B0XXXXXXXX"],
  "needCount": 50,
  "sort": "-ppc_bid_exact"
}

6. Full keyword mining including variants

{
  "marketplace": "de",
  "asins": ["B0XXXXXXXX"],
  "includeVariants": true,
  "needCount": 200,
  "sort": "-monthly_search_volume_exact"
}

Display Rules

  1. Table display is primary: Display the keyword list in table form; core columns include: keyword, exact search volume, organic rank, sponsored rank, relevance, PPC bid
  2. Streamline columns as needed: Select which columns to display based on user intent. Competitor analysis focuses on rank and search volume; advertising analysis focuses on PPC bid and sponsored rank
  3. Rank highlighting: Highlight keywords with an organic rank in the top 10 and a sponsored rank in the top 5 to help users quickly identify core traffic keywords
  4. Trend annotation: Mark growth when the monthly/quarterly trend is positive, and mark decline when negative
  5. Competitor comparison: When multiple ASINs are entered, display a comparison of each ASIN's rank for the keyword
  6. Error handling: When a query fails, explain the reason based on the error response and suggest adjusting parameters

Important Limitations

  • ASIN count limit: Up to 10 ASINs per query
  • Data timeliness: Data is updated regularly; theupdatedAt field marks the last update time
  • Search volume type: Provide both exact match and broad match search volumes
  • Required parameters：marketplace and asins are both required
  • Rank data: Rank is the position of the ASIN in the search results for the corresponding keyword; it is not real-time data

User Expression & Scenario Quick Reference

Applicable - Reverse lookup and expansion of keywords via ASIN:

User Says Scenario
"What traffic keywords does this ASIN have" Single ASIN keyword reverse lookup
"What keywords do competitors use" Competitor keyword analysis
"Help me compare the keywords of these ASINs" Multi-ASIN keyword comparison
"What words can be searched to find this product" ASIN reverse search term query
"Find some words with high search volume and low competition" High-search-volume, low-competition keyword filtering
"What advertising keywords does this ASIN have" ASIN advertising keyword analysis
"Help me expand the keywords" ASIN-based keyword expansion

Not applicable - Beyond the scope of ASIN reverse keyword lookup:

  • Historical trend of keyword search volume (requires a keyword historical search volume tool)
  • ABA search term ranking (requires an ABA tool)
  • Product sales estimation, listing optimization suggestions
  • Keyword advertising campaign execution (only provides bidding reference data)
  • Keyword data for non-Amazon platforms

Boundary judgment: When users say "关键词", "流量词", or "搜索词", if they provide specific ASINs and want to know what keywords those ASINs rank for, this skill applies. If they want to search keywords by text or check historical search volume trends, other skills are more suitable.

Computing power consumption rules

Billed according to dynamic rules: computing power consumed = actual number of pages queried × 63.75.

Important: The service for this skill is calculated dynamically by a multiplier and may consume a large amount of computing power at once. The user must be reminded, and the user decides whether to continue.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.