Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-keyword-expansion

ecommerce.amazon-keyword-expansion

Verified

Nexscope keyword expansion tool that expands a seed keyword into a list of related keywords with search volume, trends, PPC bids, ranking difficulty, and other metrics, covering 10 Amazon marketplaces including US, UK, DE, JP, etc. Trigger when the user mentions keyword expansion, keyword mining, long-tail keyword mining, related keywords, keyword suggestions, keyword discovery, PPC bid research, keyword competition, keyword discovery, Nexscope keywords, keyword expansion, keyword discovery, keyword scout, related keywords, long-tail keywords, keyword suggestions, PPC bid research, keyword competition, seed keyword expansion, keyword mining. Even if the user does not explicitly mention "Nexscope", if their need involves finding more related keywords and their search volume, competition, and other metrics starting from a seed keyword, this skill should also be triggered.

Nexscope -- Keyword by Keyword Expansion

This skill expands a seed keyword into a list of related keywords with search volume, trends, PPC bids, ranking difficulty, and other competitive metrics via the Nexscope data source, covering 10 Amazon marketplaces.

Core Concepts

The Nexscope Keyword by Keyword tool is one of the core tools for Amazon keyword research. Starting from a seed keyword, it mines a large number of related keywords and their competitive metrics. Main use cases include:

  • Keyword expansion/discovery: Input a core keyword and get hundreds of related keywords to expand your listing keyword library
  • Long-tail keyword mining: Use minWordCount to filter for 3+ word long-tail keywords, discovering low-competition, high-conversion opportunities
  • PPC bid research: View exact/broad match PPC bids and brand ad bids to plan advertising budgets
  • Competition assessment: Evaluate keyword ranking difficulty through easeOfRankingScore and organicProductCount
  • Trend analysis: View monthly and quarterly trend percentage changes to identify growing keywords

Data Fields

Output Fields (keywordInfoList)

FieldAPI NameDescriptionExample
KeywordnameKeyword textyoga mat thick
MarketplacecountryMarket codeus
Exact Search VolumemonthlySearchVolumeExactMonthly exact match search volume45000
Broad Search VolumemonthlySearchVolumeBroadMonthly broad match search volume120000
Monthly TrendmonthlyTrendMonth-over-month search volume change percentage15.3
Quarterly TrendquarterlyTrendQuarter-over-quarter search volume change percentage-5.2
Dominant CategorydominantCategoryCategory with the highest share in search resultsSports & Outdoors
Relevancy ScorerelevancyScoreRelevance score to the seed keyword856
Ease of RankingeaseOfRankingScoreRanking ease score (higher = easier)3
Organic ProductsorganicProductCountNumber of organic ranking products in search results342
Sponsored ProductssponsoredProductCountNumber of ad products in search results28
PPC Exact BidppcBidExactExact match PPC suggested bid (USD)1.25
PPC Broad BidppcBidBroadBroad match PPC suggested bid (USD)0.89
Brand Ad BidspBrandAdBidSponsored Brand ad suggested bid (USD)2.50
Recommended PromotionsrecommendedPromotionsRecommended promotional giveaway count150
Cost TokencostTokenTokens consumed by this call1

Supported Marketplaces

10 Amazon marketplaces: us (default), uk, de, in, ca, fr, it, es, mx, jp. When the user does not specify a marketplace, use us.

Marketplacemarketplace valueDescription
United StatesusAmazon.com
United KingdomukAmazon.co.uk
GermanydeAmazon.de
IndiainAmazon.in
CanadacaAmazon.ca
FrancefrAmazon.fr
ItalyitAmazon.it
SpainesAmazon.es
MexicomxAmazon.com.mx
JapanjpAmazon.co.jp

How to Invoke

  • API Endpoint: POST /tool-jungle-scout/keywords/by-keyword (complete params/response/error codes in references/api.md)
  • Python Script: python scripts/amazon_keyword_expansion.py '<JSON params>' [--inline]
  • Cost constraint: This tool consumes credits; the same session and parameter combination is called only once by default, with a 24h local cache in the script. On failure or empty results, do not automatically retry with different keywords, pagination, or postal codes; inform the user about additional consumption before continuing to search.

Output strategy (script default behavior):

  • Always write the full response to <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-junglescout-keyword-by-keyword-<timestamp>.json (<cwd> is the working directory at script execution time, i.e. the current project directory in Claude Code; <session> is taken from the SESSION_ID env var, auto-grouped by user task; do not write to /tmp, error if current directory is not writable)
  • Response body <= 8 KB: print full JSON to stdout after saving
  • Response body > 8 KB: print only summary to stdout after saving (top-level fields, common counts like total/costToken, length of largest list field + first 3 samples)
  • Add --inline to force full output to stdout (still saves to disk)

Data reading tip: Check the summary first to decide if it's enough; when specific fields are needed, prefer using jq or ConvertFrom-Json to extract from the saved json file on demand, avoiding loading the entire JSON into context.

How to Build Queries

Required parameters: marketplace, searchTerms (single seed keyword string).

Principles for Building API Calls

  1. Marketplace mapping: "US marketplace" -> us, "Japan marketplace" -> jp, "Germany marketplace" -> de; default to us when unspecified
  2. Seed keyword: Pass the user-provided keyword as-is (lowercase English preferred), only a single keyword is supported
  3. Result count: Default return count is limited; if the user needs more results, set needCount
  4. Sort selection: Default sort by exact search volume descending (-monthly_search_volume_exact); switch sort field based on user intent
  5. Filtering: Make full use of min/max parameters to narrow results and avoid returning irrelevant low-quality keywords

Common Query Scenarios

1. Expand seed keyword -- get related keyword list

{
  "marketplace": "us",
  "searchTerms": "yoga mat"
}

2. Mine long-tail keywords (3+ words)

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "minWordCount": 3,
  "needCount": 50
}

3. Low-competition keyword discovery

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "maxOrganicProductCount": 200,
  "minMonthlySearchVolumeExact": 1000,
  "sort": "-ease_of_ranking_score"
}

4. High search volume keyword filtering

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "minMonthlySearchVolumeExact": 10000,
  "sort": "-monthly_search_volume_exact",
  "needCount": 30
}

5. PPC bid research -- sort by broad bid

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "minMonthlySearchVolumeExact": 500,
  "sort": "ppc_bid_broad",
  "needCount": 30
}

6. Germany marketplace broad search volume keywords

{
  "marketplace": "de",
  "searchTerms": "yogamatte",
  "minMonthlySearchVolumeBroad": 5000,
  "sort": "-monthly_search_volume_broad"
}

Display Rules

  1. Table priority: Display keyword lists in tables with core columns: Keyword, Exact Search Volume, Broad Search Volume, Monthly Trend, PPC Exact Bid, Ease of Ranking
  2. Contextual column trimming: Choose columns based on user intent -- PPC research scenarios focus on bid columns, expansion scenarios focus on search volume and trends
  3. Trend annotation: Mark positive monthly and quarterly trends with up arrow, negative with down arrow
  4. Ranking difficulty interpretation: easeOfRankingScore 1-3 = difficult, 4-6 = medium, 7-10 = easy
  5. Data insights: Provide a brief summary after the table, e.g., which category high-search-volume keywords concentrate in, competitive advantages of long-tail keywords
  6. Error handling: When a query fails, explain the reason based on the error response and suggest adjusting parameters

Important Limitations

  • One keyword per call: searchTerms only accepts one seed keyword; multiple keywords require separate calls
  • Data period: Search volume is a monthly estimated value, not real-time data
  • Marketplace limits: Only covers 10 Amazon marketplaces, excluding Australia, Netherlands, etc.
  • Fixed sort fields: Only supports predefined sort fields; custom combination sorting is not supported

User Expression & Scenario Quick Reference

Applicable -- Keyword expansion and competition analysis:

User SaysScenario
"Expand this keyword for me"Seed keyword expansion
"What related keywords does this term have"Related keyword mining
"Find some long-tail keywords"Long-tail keyword filtering (minWordCount >= 3)
"Which keywords have low competition"Low-competition keywords (ranking difficulty + product count filtering)
"What's the PPC bid for this keyword"PPC bid data query
"Related keywords with high search volume"High search volume keyword filtering
"What related keywords are there on the Germany marketplace"Non-US marketplace keyword expansion
"Help me with keyword research"Comprehensive keyword research

Not applicable -- Beyond keyword expansion scope:

  • Keyword historical search volume trends (requires the keyword-history tool)
  • ABA search term rankings (requires the ABA tool)
  • Product search or listing analysis
  • Non-Amazon platform keyword data
  • ASIN reverse keyword lookup

Boundary judgment: When users say "keywords", "keyword expansion", or "keyword research", if they want to expand a seed keyword into a list of related keywords with metrics, this skill applies. If they want to see a single keyword's historical search volume trend over time, use the keyword-history skill instead.

Authentication

Set the NEXSCOPE_API_KEY environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.

API Key request rate

All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.

If an execution request returns HTTP 429 with outer code 13012, the request-rate allowance was exceeded. Honor the returned Retry-After before considering another request. Outer code 13013 means the concurrent-request limit was exceeded, not the rate limit; honor its Retry-After when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall