Amazon Marketplace Intelligence

Amazon Market Research MCP Tool

Use SellerSprite market list capability to filter Amazon niche markets by category dimensions, supporting market size, competition, top concentration, seller structure, new product share, price/rating/margin ranges, and many other criteria for discovering viable markets and evaluating product selection directions.

MCP tool name
nexscope_amazon_market_research
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-research/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "amazon-market-research-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_research",
    "arguments": {
      "marketplace": "US",
      "size": 1,
      "newProduct": 1,
      "departmentKeyword": "phone case",
      "page": 1,
      "topNum": 1
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-research/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-market-research

Arguments

NameTypeRequiredMeaning
marketplacestringrequired
Site code, see [marketplace](#marketplace-options)
Example: US
nodeIdPathstringoptional
Category node ID path, e.g. 172282:281407
Example: {}
departmentKeywordstringoptional
Category keyword path, e.g. Electronics:Accessories & Supplies
Example: phone case
sellerLocationstringoptional
Seller location, multiple values comma-separated; see Seller Sprite table 1.3 for values
Example: {}
newProductintegeroptional
New product definition (months)
Example: 1
topNumintegeroptional
Top Listing count
Example: 1
monthstringoptional
Filter date: nearly or yyyyMM
Example: {}
pageintegeroptional
Page number, starting from 1
Example: 1
sizeintegeroptional
Results per page
Example: 1
orderFieldstringoptional
Sort field, see [orderField](#orderfield-options)
Example: {}
orderDescbooleanoptional
true descending, false ascending
Example: false
minAvgRevenue/maxAvgRevenuenumberoptional
Minimum / maximum average monthly sales revenue
Example: 1
minAvgUnits/maxAvgUnitsintegeroptional
Minimum / maximum average monthly sales volume
Example: 1
minGoodsCount/maxGoodsCountintegeroptional
Minimum / maximum product count
Example: 1
minSellers/maxSellersintegeroptional
Minimum / maximum seller count
Example: 1
minBrands/maxBrandsintegeroptional
Minimum / maximum brand count
Example: 1
minAvgSellers/maxAvgSellersnumberoptional
Minimum / maximum average seller count
Example: 1
minGoodsCrn/maxGoodsCrnnumberoptional
Minimum / maximum product concentration (decimal 0-1)
Example: 1
minSellerCrn/maxSellerCrnnumberoptional
Minimum / maximum seller concentration (decimal 0-1)
Example: 1
minBrandCrn/maxBrandCrnnumberoptional
Minimum / maximum brand concentration (decimal 0-1)
Example: 1
minAmazonSelfProportion/maxAmazonSelfProportionnumberoptional
Minimum / maximum Amazon self-operated share (decimal 0-1)
Example: 1
minFbaProportion/maxFbaProportionnumberoptional
Minimum / maximum FBA share (decimal 0-1)
Example: 1
minFbmProportion/maxFbmProportionnumberoptional
Minimum / maximum FBM share (decimal 0-1)
Example: 1
minEbcProportion/maxEbcProportionnumberoptional
Minimum / maximum A+ share (decimal 0-1)
Example: 1
minNewProportion/maxNewProportionnumberoptional
Minimum / maximum new product share (scale may differ from other ratio fields; refer to tool schema / actual network behavior)
Example: 1
minAvgPrice/maxAvgPricenumberoptional
Minimum / maximum average price
Example: 1
minAvgRating/maxAvgRatingnumberoptional
Minimum / maximum average rating value
Example: 1
minAvgRatings/maxAvgRatingsintegeroptional
Minimum / maximum average review count
Example: 1
minAvgProfit/maxAvgProfitnumberoptional
Minimum / maximum average gross margin (input N means N%, 0-100)
Example: 1
minAvgBsr/maxAvgBsrintegeroptional
Minimum / maximum average BSR rank
Example: 1
minNewCount/maxNewCountintegeroptional
Minimum / maximum new product count
Example: 1
minNewAvgPrice/maxNewAvgPricenumberoptional
Minimum / maximum new product average price
Example: 1
minNewAvgRating/maxNewAvgRatingnumberoptional
Minimum / maximum new product average star rating
Example: 1
minNewAvgRatings/maxNewAvgRatingsintegeroptional
Minimum / maximum new product average review count
Example: 1
minNewAvgUnits/maxNewAvgUnitsnumberoptional
Minimum / maximum new product average monthly sales
Example: 1
minNewAvgRevenue/maxNewAvgRevenuenumberoptional
Minimum / maximum new product average monthly revenue
Example: 1
minTopAvgUnits/maxTopAvgUnitsintegeroptional
Minimum / maximum top listing average monthly sales
Example: 1
minTopAvgRevenue/maxTopAvgRevenuenumberoptional
Minimum / maximum top listing average monthly revenue
Example: 1
minTopAvgBsr/maxTopAvgBsrintegeroptional
Minimum / maximum top listing average BSR
Example: 1
minWeight/maxWeightnumberoptional
Minimum / maximum weight
Example: 1
minVolume/maxVolumenumberoptional
Minimum / maximum volume
Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
totalintegeroptional
Total record count
Example: 1
marketplacestringoptional
Site code
Example: US
dataarrayoptional
Category market list (corresponds to third-party data.items)
Example: []
columnsarrayoptional
Render columns
Example: []
costTokenintegeroptional
Tokens consumed
Example: 1
typestringoptional
Render style
Example: {}
data[].nodeIdstringoptional
Node ID
Example: example-id
data[].nodeIdPathstringoptional
Node ID path
Example: {}
data[].nodeLabelNamestringoptional
Node name
Example: {}
data[].nodeLabelPathstringoptional
Node name path
Example: {}
data[].nodeLabelLocalestringoptional
Node name translation
Example: {}
data[].nodeLabelPathLocalestringoptional
Node name path translation
Example: {}
data[].marketplacestringoptional
Market identifier
Example: US
data[].currencystringoptional
Currency type for this market
Example: {}
data[].rankingintegeroptional
Rank
Example: 1
data[].totalProductsintegeroptional
Total product count
Example: 1
data[].topProductsintegeroptional
Sample count
Example: 1
data[].sellersintegeroptional
Seller count
Example: 1
data[].brandsintegeroptional
Brand count
Example: 1
data[].avgSellersnumberoptional
Average seller count
Example: 1
data[].avgUnitsintegeroptional
Average monthly sales volume
Example: 1
data[].totalUnitsintegeroptional
Total monthly sales volume
Example: 1
data[].avgRevenuenumberoptional
Average monthly sales revenue
Example: 1
data[].totalRevenuenumberoptional
Total monthly sales revenue
Example: 1
data[].avgPricenumberoptional
Average price
Example: 1
data[].avgRatingnumberoptional
Average rating value
Example: 1
data[].avgRatingsintegeroptional
Average review count
Example: 1
data[].avgBsrintegeroptional
Average BSR
Example: 1
data[].avgProfitnumberoptional
Average profit margin (%)
Example: 1
data[].fbaProportionnumberoptional
FBA share (%)
Example: 1
data[].fbmProportionnumberoptional
FBM share (%)
Example: 1
data[].amazonSelfProportionnumberoptional
Amazon self-operated share (%)
Example: 1
data[].ebcProportionnumberoptional
A+ product share (%)
Example: 1
data[].returnRationumberoptional
Return rate (%)
Example: 1
data[].avgReturnRationumberoptional
Category average return rate (%)
Example: 1
data[].searchToPurchaseRationumberoptional
Search-to-purchase ratio (per mille)
Example: 1
data[].sellerNationstringoptional
Most common seller location code
Example: {}
data[].sellerNationLabelstringoptional
Most common seller location label
Example: {}
data[].sellerProportionnumberoptional
Most common seller location share (%)
Example: 1
data[].avgWeightnumberoptional
Average weight (pound)
Example: 1
data[].baseAvgWeightnumberoptional
Average weight (g)
Example: 1
data[].avgVolumenumberoptional
Average volume (in³)
Example: 1
data[].baseAvgVolumenumberoptional
Average volume (cm³)
Example: 1
data[].top10Imagesarrayoptional
Top 10 product images, elements see table below
Example: []
top10images[].imagestringoptional
Image link
Example: https://example.com/image.jpg
top10images[].asinstringoptional
ASIN
Example: B072MQ5BRX
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "marketplace": "US",
  "size": 1,
  "newProduct": 1,
  "departmentKeyword": "phone case",
  "page": 1,
  "topNum": 1
}

Example structuredContent

{
  "total": 1,
  "marketplace": "US",
  "data": [
    {
      "nodeId": "example-id",
      "marketplace": "US",
      "ranking": 1,
      "totalProducts": 1,
      "topProducts": 1,
      "sellers": 1,
      "brands": 1,
      "avgSellers": 1,
      "avgUnits": 1,
      "totalUnits": 1,
      "avgRevenue": 1,
      "totalRevenue": 1,
      "avgPrice": 1,
      "avgRating": 1,
      "avgRatings": 1,
      "avgBsr": 1,
      "avgProfit": 1,
      "fbaProportion": 1,
      "fbmProportion": 1,
      "amazonSelfProportion": 1,
      "ebcProportion": 1,
      "returnRatio": 1,
      "avgReturnRatio": 1,
      "searchToPurchaseRatio": 1,
      "sellerProportion": 1,
      "avgWeight": 1,
      "baseAvgWeight": 1,
      "avgVolume": 1,
      "baseAvgVolume": 1,
      "top10Images": []
    }
  ],
  "columns": [],
  "costToken": 1,
  "top10images": [
    {
      "image": "https://example.com/image.jpg",
      "asin": "B072MQ5BRX"
    }
  ]
}