Amazon Marketplace Intelligence

Amazon Market Product Detail MCP Tool

Query Amazon product detail and historical trends by ASIN using Sorftime data, covering 14 marketplaces.

MCP tool name

nexscope_amazon_market_product_detail

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-market-product-detail/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-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_market_product_detail",
    "arguments": {
      "includeTrend": 1,
      "queryTrendStartDate": "2026-01-01",
      "queryTrendEndDate": "2026-01-15",
      "marketplace": "us",
      "asin": "B072MQ5BRX"
    }
  }
}

REST API equivalent

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

Canonical detail URL

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

Arguments

Name	Type	Required	Meaning
`asin`	`string`	required	Amazon Standard Identification Number (ASIN), supports multiple (max 10), comma-separated. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ Example: B072MQ5BRX
`marketplace`	`string`	required	Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa Example: us
`includeTrend`	`integer`	optional	Whether to include trend data. 1: include (default); 2: exclude Example: 1
`queryTrendStartDate`	`string`	optional	Trend start date, format yyyy-MM-dd. Default returns only the last 15 days; querying more than 15 days doubles the cost Example: 2026-01-01
`queryTrendEndDate`	`string`	optional	Trend end date, format yyyy-MM-dd Example: 2026-01-15

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
`costTime`	`integer`	optional	Latency (ms) Example: 1
`costToken`	`integer`	optional	Tokens consumed Example: 1
`requestConsumed`	`integer`	optional	Requests consumed Example: 1
`sourceType`	`string`	optional	Source type: sorftime Example: {}
`type`	`string`	optional	Render style Example: {}
`columns`	`array`	optional	Render columns Example: []
`products`	`array`	optional	Product detail 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[].ebcPhoto`	`array`	optional	A+ image list Example: []
`products[].storeName`	`string`	optional	Store name Example: {}
`products[].description`	`string`	optional	Five bullet points Example: {}
`products[].productBadge`	`array`	optional	Product badges, e.g. Amazon Choice, Best Seller, New Release, etc. Example: []
`products[].lastUpdate`	`string`	optional	Update time, most recent ASIN data collection time (format yyyy-MM-dd) Example: 2026-01-01
`products[].offSale`	`boolean`	optional	Whether delisted. true = unavailable, false = available Example: false
`products[].productType`	`string`	optional	Category, Amazon product category node name Example: {}
`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[].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[].variationASIN`	`array`	optional	Child ASIN list, empty if no variants Example: []
`products[].attribute`	`array`	optional	Product attributes, variant attributes if variants exist. Each entry contains asin (child ASIN), name (attribute name), value (attribute value) Example: []
`products[].price`	`number`	optional	Selling 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[].platformFee`	`number`	optional	Platform commission, in local currency (e.g. USD) 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[].shipCost`	`number`	optional	FBM shipping cost, in local currency (e.g. USD) Example: 1
`products[].shipsFrom`	`string`	optional	Ship-from location Example: {}
`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	Official monthly sales volume, Amazon published ASIN monthly sales, latest value from the last 7 calendar days, 0 if unavailable 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[].availableDate`	`string`	optional	Listing time, format yyyy-MM-dd Example: 2026-01-01
`products[].onlineDays`	`integer`	optional	Days since listing Example: 1
`products[].rating`	`number`	optional	Current rating (0.0-5.0, e.g. 4.70) Example: 1
`products[].ratings`	`integer`	optional	Number of ratings Example: 1
`products[].fiveStarRatings`	`number`	optional	5-star percentage, e.g. 57.7 means 57.7% Example: 1
`products[].fourStarRatings`	`number`	optional	4-star percentage Example: 1
`products[].threeStarRatings`	`number`	optional	3-star percentage Example: 1
`products[].twoStarRatings`	`number`	optional	2-star percentage Example: 1
`products[].oneStarRatings`	`number`	optional	1-star percentage 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
`products[].feature`	`object`	optional	Product feature ratings, features and star ratings collected by Amazon for this product, e.g. {"Battery life":4.0} Example: {}
`products[].productInfo`	`object`	optional	Product information, structured data from the Product Information section in the Listing Example: {}
`products[].property`	`object`	optional	Attribute list, including variant attributes and Bullet Points header descriptions Example: {}
`products[].brandPromotion`	`string`	optional	Brand promotion Example: {}
`products[].dealType`	`string`	optional	Deal label Example: {}
`products[].extraSavings`	`array`	optional	Associated promotions, e.g. [{Asin:xxx, Text:"Save 5%..."}] Example: []
`products[].rankTrend`	`array`	optional	BSR trend, main category rank change history, interleaved format [date, rank, ...] Example: []
`products[].bsrRankTrend`	`array`	optional	Subcategory rank trend, JSON format [{NodeId:xxx, Rank:[date, rank, ...]}] Example: []
`products[].listingSalesVolumeOfDailyTrend`	`array`	optional	Daily sales volume trend, value -1 means unable to estimate Example: []
`products[].listingSalesOfDailyTrend`	`array`	optional	Daily sales revenue trend, in local currency smallest unit (e.g. cents), value -1 means unable to estimate Example: []
`products[].listingSalesVolumeOfMonthTrend`	`array`	optional	Monthly sales volume trend (last 30 days), value -1 means unable to estimate Example: []
`products[].listingSalesOfMonthTrend`	`array`	optional	Monthly sales revenue trend, in local currency smallest unit (e.g. cents) Example: []
`products[].priceTrend`	`array`	optional	Selling price trend, before coupon, in local currency smallest unit, -1 means no price available for that day Example: []
`products[].listPriceTrend`	`array`	optional	Original price trend (strikethrough price history), in local currency smallest unit, -1 means no price available for that day Example: []
`products[].dealTrend`	`array`	optional	Deal trend, value 1 = has deal, 0 = no deal Example: []
`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: {}
`sourceTool`	`string`	optional	Provider-specific source tool name. Example: {}
`page`	`integer`	optional	Current page returned by the upstream provider. 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

{
  "includeTrend": 1,
  "queryTrendStartDate": "2026-01-01",
  "queryTrendEndDate": "2026-01-15",
  "marketplace": "us",
  "asin": "B072MQ5BRX"
}

Example structuredContent

{
  "code": 1,
  "total": 1,
  "costTime": 1,
  "costToken": 1,
  "requestConsumed": 1,
  "columns": [],
  "products": [
    {
      "asin": "B072MQ5BRX",
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "ebcPhoto": [],
      "productBadge": [],
      "lastUpdate": "2026-01-01",
      "offSale": false,
      "size": [],
      "parentAsin": "B072MQ5BRX",
      "variationNum": 1,
      "variationASIN": [],
      "attribute": [],
      "price": 1,
      "coupon": 1,
      "platformFee": 1,
      "fbaFees": 1,
      "fbaDetail": [],
      "shipCost": 1,
      "profitAmount": 1,
      "profitRate": 1,
      "monthlySalesUnits": 1,
      "salesRank": 1,
      "category": [],
      "bsrCategory": [],
      "availableDate": "2026-01-01",
      "onlineDays": 1,
      "rating": 1,
      "ratings": 1,
      "fiveStarRatings": 1,
      "fourStarRatings": 1,
      "threeStarRatings": 1,
      "twoStarRatings": 1,
      "oneStarRatings": 1,
      "buyBoxSellerId": "example-id",
      "isFBA": false,
      "sellerNum": 1,
      "aPlus": false,
      "hasVideo": false,
      "hasBrandStore": false,
      "feature": {},
      "productInfo": {},
      "property": {},
      "extraSavings": [],
      "rankTrend": [],
      "bsrRankTrend": [],
      "listingSalesVolumeOfDailyTrend": [],
      "listingSalesOfDailyTrend": [],
      "listingSalesVolumeOfMonthTrend": [],
      "listingSalesOfMonthTrend": [],
      "priceTrend": [],
      "listPriceTrend": [],
      "dealTrend": []
    }
  ]
}