Amazon Marketplace Intelligence

Amazon Market Product Search MCP Tool

Multi-dimensional Amazon product search and filtering based on Sorftime data, covering 14 marketplaces, with support for historical monthly snapshot lookback.

MCP tool name

nexscope_amazon_market_product_search

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-search/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-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_product_search",
    "arguments": {
      "page": 1,
      "queryMode": 1,
      "marketplace": "us",
      "queryType": 1,
      "queryValue": "B072MQ5BRX"
    }
  }
}

REST API equivalent

POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-search/run

Canonical detail URL

https://www.nexscope.ai/mcp-map/amazon-market-product-search

Arguments

Name	Type	Required	Meaning
`marketplace`	`string`	required	Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa Example: us
`queryMode`	`integer`	optional	Query mode. 1: single condition query (default); 2: multi-condition combined query (AND relationship) Example: 1
`queryType`	`integer`	optional	Query type (1-16), only effective when queryMode=1. See the complete Query Types description in SKILL.md Example: 1
`queryValue`	`string`	optional	Query condition value, format varies by queryMode and queryType. See the format description for each queryType in SKILL.md Example: phone case
`page`	`integer`	optional	Page number, default 1. Max 100 products per page Example: 1
`queryMonth`	`string`	optional	Historical month lookback, format yyyy-MM. When not specified, queries real-time data Example: 2026-01

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Meaning
`code`	`integer`	optional	Response code (200 indicates success) Example: 1
`msg`	`string`	optional	Response message Example: {}
`total`	`integer`	optional	Total result count Example: 1
`page`	`integer`	optional	Current page number Example: 1
`pageCount`	`integer`	optional	Total page count (max 200 pages) Example: 1
`costTime`	`integer`	optional	Latency (ms) Example: 1
`costToken`	`integer`	optional	Tokens consumed Example: 1
`requestConsumed`	`integer`	optional	Requests consumed Example: 1
`type`	`string`	optional	Render style Example: {}
`columns`	`array`	optional	Render columns Example: []
`products`	`array`	optional	Product list (see below) Example: []
`products[].asin`	`string`	optional	ASIN Example: B072MQ5BRX
`products[].title`	`string`	optional	Product title Example: {}
`products[].brand`	`string`	optional	Brand Example: {}
`products[].asinUrl`	`string`	optional	Product link, Amazon Listing detail page URL Example: B072MQ5BRX
`products[].imageUrl`	`string`	optional	Main image URL Example: https://example.com/image.jpg
`products[].productImageUrls`	`array`	optional	Main image list (all product image URLs) Example: []
`products[].parentAsin`	`string`	optional	Parent ASIN, the parent ASIN if variants exist, null if no variants Example: B072MQ5BRX
`products[].variationNum`	`integer`	optional	Number of variations Example: 1
`products[].weight`	`string`	optional	Weight, unit g Example: {}
`products[].size`	`array`	optional	Dimensions, outer packaging [longest side, second longest side, shortest side], unit cm Example: []
`products[].price`	`number`	optional	Current price, before coupon, in local currency (e.g. USD) Example: 1
`products[].oldPrice`	`number`	optional	Strikethrough price, in local currency (e.g. USD) Example: 1
`products[].salesPrice`	`number`	optional	Final price, actual price after coupon deduction, in local currency (e.g. USD) Example: 1
`products[].coupon`	`integer`	optional	Coupon policy. Value >= 0 = deduction amount (e.g. 500 = $5), value < 0 = discount percentage (e.g. -10 = 10% discount) Example: 1
`products[].fbaFees`	`number`	optional	FBA fees, in local currency (e.g. USD) Example: 1
`products[].fbaDetail`	`array`	optional	FBA detail. First item is delivery fee, subsequent items are month:storage fee, e.g. [475,"1-9:5","10-12:15"] Example: []
`products[].platformFee`	`number`	optional	Platform commission, in local currency (e.g. USD) Example: 1
`products[].profitAmount`	`number`	optional	Profit, final price - FBA fee - commission, in local currency (e.g. USD) Example: 1
`products[].profitRate`	`number`	optional	Profit margin, e.g. 25.83 means 25.83% Example: 1
`products[].monthlySalesUnits`	`integer`	optional	Monthly sales volume, last 30 days Listing-level (does not split by variant), recommended for evaluating sales, value -1 means unable to estimate Example: 1
`products[].monthlySalesRevenue`	`number`	optional	Monthly sales revenue, estimated value, in local currency (e.g. USD), value -1 means unable to estimate Example: 1
`products[].listingSalesVolumeOfDaily`	`integer`	optional	Daily sales volume, Listing-level (does not split by variant), value -1 means unable to estimate Example: 1
`products[].listingSalesOfDaily`	`number`	optional	Daily sales revenue, in local currency (e.g. USD), value -1 means unable to estimate Example: 1
`products[].salesRank`	`integer`	optional	BSR rank, main category rank Example: 1
`products[].category`	`array`	optional	Main category, [category name, NodeId] Example: []
`products[].bsrCategory`	`array`	optional	Subcategory rank list, each entry containing nodeId (node ID), name (category name), rank (rank), date (date, format yyyyMMdd) Example: []
`products[].rating`	`number`	optional	Current rating (0.0-5.0, e.g. 4.8) Example: 1
`products[].ratings`	`integer`	optional	Number of ratings Example: 1
`products[].availableDate`	`string`	optional	Listing time, format yyyy-MM-dd Example: 2026-01-01
`products[].onlineDays`	`integer`	optional	Days since listing Example: 1
`products[].buyboxSeller`	`string`	optional	Buybox seller name Example: {}
`products[].buyBoxSellerId`	`string`	optional	Buybox seller ID Example: example-id
`products[].buyboxSellerAddress`	`string`	optional	Seller location, Buybox seller nationality (two-letter code e.g. CN, US), null if Amazon's own Example: {}
`products[].isFBA`	`boolean`	optional	Whether FBA, whether Buybox seller uses FBA logistics Example: false
`products[].sellerNum`	`integer`	optional	Number of sellers Example: 1
`products[].aPlus`	`boolean`	optional	Has A+ Example: false
`products[].hasVideo`	`boolean`	optional	Has video Example: false
`products[].hasBrandStore`	`boolean`	optional	Has brand store Example: false
`errcode`	`integer`	optional	Upstream status code returned by the provider. Example: {}
`errmsg`	`string`	optional	Upstream status message returned by the provider. Example: {}
`message`	`string`	optional	Provider-specific message. Example: {}
`title`	`string`	optional	Provider-specific response title. Example: {}
`sourceType`	`string`	optional	Provider-specific source platform type. Example: {}
`sourceTool`	`string`	optional	Provider-specific source tool name. Example: {}
`pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: {}
`pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: {}
`totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: {}
`dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: {}

Examples

Example arguments

{
  "page": 1,
  "queryMode": 1,
  "marketplace": "us",
  "queryType": 1,
  "queryValue": "B072MQ5BRX"
}

Example structuredContent

{
  "code": 1,
  "total": 1,
  "page": 1,
  "pageCount": 1,
  "costTime": 1,
  "costToken": 1,
  "requestConsumed": 1,
  "columns": [],
  "products": [
    {
      "asin": "B072MQ5BRX",
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "parentAsin": "B072MQ5BRX",
      "variationNum": 1,
      "size": [],
      "price": 1,
      "oldPrice": 1,
      "salesPrice": 1,
      "coupon": 1,
      "fbaFees": 1,
      "fbaDetail": [],
      "platformFee": 1,
      "profitAmount": 1,
      "profitRate": 1,
      "monthlySalesUnits": 1,
      "monthlySalesRevenue": 1,
      "listingSalesVolumeOfDaily": 1,
      "listingSalesOfDaily": 1,
      "salesRank": 1,
      "category": [],
      "bsrCategory": [],
      "rating": 1,
      "ratings": 1,
      "availableDate": "2026-01-01",
      "onlineDays": 1,
      "buyBoxSellerId": "example-id",
      "isFBA": false,
      "sellerNum": 1,
      "aPlus": false,
      "hasVideo": false,
      "hasBrandStore": false
    }
  ]
}