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

Legacy MCP endpoint

/api/skill-api/v1/mcp

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,
      "queryValue": "B072MQ5BRX",
      "queryType": 1,
      "marketplace": "us",
      "queryMode": 1
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

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	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

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

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

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

Example structuredContent

{
  "data": {
    "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
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}