Amazon Marketplace Intelligence

Amazon Product History MCP Tool

Retrieve Amazon product details by ASIN, including price, title, main image, listing date, material, weight, variant monthly sales, and up to 12 months of monthly sales history.

MCP tool name

nexscope_amazon_product_history

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-history/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-product-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_history",
    "arguments": {
      "history": 1,
      "asin": "B072MQ5BRX",
      "domain": "1"
    }
  }
}

REST API equivalent

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

Canonical detail URL

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

Arguments

Name	Type	Required	Meaning
`asin`	`string`	required	Amazon Standard Identification Number (ASIN), multiple ASINs separated by English commas, up to 5, max length 300 characters. Example: B0088PUEPK or B0088PUEPK,B00U26V4VQ,B07M68S376 Example: B072MQ5BRX
`domain`	`string`	required	Amazon domain ID. Options: 1 (United States), 2 (United Kingdom), 3 (Germany), 4 (France), 5 (Japan), 6 (Canada), 8 (Italy), 9 (Spain), 10 (India), 11 (Mexico), 12 (Brazil) Example: 1
`history`	`integer`	optional	Whether to include historical data and historical sales in the response. 1 = include price history, sales rank, historical sales and other time-series data (sales for previous months), 0 = return only basic product information. Default: 0 Example: 1

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Meaning
`total`	`integer`	optional	Total rows Example: 1
`perPage`	`integer`	optional	Items per page Example: 1
`sourceType`	`string`	optional	Source type: keepa Example: {}
`columns`	`array`	optional	Rendered columns Example: []
`costToken`	`integer`	optional	Token consumption Example: 1
`totalCount`	`integer`	optional	Total count Example: 1
`currentPage`	`integer`	optional	Current page number Example: 1
`type`	`string`	optional	Render style 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[].manufacturer`	`string`	optional	Manufacturer Example: {}
`products[].model`	`string`	optional	Model Example: {}
`products[].color`	`string`	optional	Color Example: {}
`products[].material`	`string`	optional	Product material, the primary material used in its construction Example: {}
`products[].price`	`number`	optional	Current price (in local currency, e.g., USD/EUR) Example: 1
`products[].primePrice`	`number`	optional	Prime price Example: 1
`products[].currency`	`string`	optional	Currency Example: {}
`products[].rating`	`number`	optional	Current rating (0.0-5.0, e.g., 4.5 stars) Example: 1
`products[].ratings`	`integer`	optional	Number of ratings Example: 1
`products[].reviewCount`	`integer`	optional	Number of reviews Example: 1
`products[].salesRank`	`integer`	optional	Sales rank Example: 1
`products[].salesRank30`	`integer`	optional	Average sales rank in last 30 days Example: 1
`products[].salesRank90`	`integer`	optional	Average sales rank in last 90 days Example: 1
`products[].salesRank180`	`integer`	optional	Average sales rank in last 180 days Example: 1
`products[].monthlySalesUnits`	`integer`	optional	Monthly sales units Example: 1
`products[].monthlySalesRevenue`	`number`	optional	Monthly sales revenue Example: 1
`products[].monthlySalesUnits1MonthAgo`	`integer`	optional	Monthly sales 1 month ago Example: 1
`products[].monthlySalesUnits2MonthsAgo`	`integer`	optional	Monthly sales 2 months ago Example: 1
`products[].monthlySalesUnits3MonthsAgo`	`integer`	optional	Monthly sales 3 months ago Example: 1
`products[].monthlySalesUnits4MonthsAgo`	`integer`	optional	Monthly sales 4 months ago Example: 1
`products[].monthlySalesUnits5MonthsAgo`	`integer`	optional	Monthly sales 5 months ago Example: 1
`products[].monthlySalesUnits6MonthsAgo`	`integer`	optional	Monthly sales 6 months ago Example: 1
`products[].monthlySalesUnits7MonthsAgo`	`integer`	optional	Monthly sales 7 months ago Example: 1
`products[].monthlySalesUnits8MonthsAgo`	`integer`	optional	Monthly sales 8 months ago Example: 1
`products[].monthlySalesUnits9MonthsAgo`	`integer`	optional	Monthly sales 9 months ago Example: 1
`products[].monthlySalesUnits10MonthsAgo`	`integer`	optional	Monthly sales 10 months ago Example: 1
`products[].monthlySalesUnits11MonthsAgo`	`integer`	optional	Monthly sales 11 months ago Example: 1
`products[].monthlySalesUnits12MonthsAgo`	`integer`	optional	Monthly sales 12 months ago Example: 1
`products[].availableDate`	`string`	optional	Listing time (yyyy-MM-dd HH:mm:ss) Example: 2026-01-01
`products[].lastUpdate`	`string`	optional	Last update time (yyyy-MM-dd HH:mm:ss) Example: 2026-01-01
`products[].imageUrl`	`string`	optional	Image URL (request address) Example: https://example.com/image.jpg
`products[].productImageUrls`	`array`	optional	Product image list Example: []
`products[].asinUrl`	`string`	optional	Amazon ASIN detail page URL Example: B072MQ5BRX
`products[].urlSlug`	`string`	optional	URL slug Example: https://example.com/image.jpg
`products[].itemLength`	`integer`	optional	Item length in millimeters, 0 or -1 if unavailable Example: 1
`products[].itemWidth`	`integer`	optional	Item width in millimeters, 0 or -1 if unavailable Example: 1
`products[].itemHeight`	`integer`	optional	Item height in millimeters, 0 or -1 if unavailable Example: 1
`products[].dimension`	`string`	optional	Dimensions Example: {}
`products[].dimensionsType`	`string`	optional	Dimensions type Example: {}
`products[].weight`	`string`	optional	Weight (grams) Example: {}
`products[].packageLength`	`integer`	optional	Package length (mm) Example: 1
`products[].packageWidth`	`integer`	optional	Package width (mm) Example: 1
`products[].packageHeight`	`integer`	optional	Package height (mm) Example: 1
`products[].packageWeight`	`string`	optional	Package weight (grams) Example: {}
`products[].packageDimensions`	`string`	optional	Package dimensions Example: {}
`products[].packageQuantity`	`integer`	optional	Quantity of items in the package, 0 or -1 if unavailable Example: 1
`products[].fulfillment`	`string`	optional	Fulfillment method (AMZ, FBA, FBM) Example: {}
`products[].fbaFees`	`number`	optional	FBA fulfillment fee (in local currency) Example: 1
`products[].referralFeePercentage`	`number`	optional	Referral fee percentage Example: 1
`products[].profit`	`number`	optional	Profit margin (percentage, e.g., 25.5 means 25.5%) Example: 1
`products[].buyBoxSellerId`	`string`	optional	Buy Box seller ID Example: example-id
`products[].sellerNum`	`integer`	optional	Number of sellers Example: 1
`products[].variationNum`	`integer`	optional	Number of variations Example: 1
`products[].parentAsin`	`string`	optional	Parent ASIN Example: B072MQ5BRX
`products[].rootCategory`	`integer`	optional	Root category ID Example: 1
`products[].categoryTree`	`string`	optional	Category tree Example: {}
`products[].categoryTreeId`	`string`	optional	Category tree ID Example: example-id
`products[].subcategories`	`array`	optional	Subcategory list, each element contains code (category ID), rank (ranking), label (category name) Example: []
`products[].isAdultProduct`	`boolean`	optional	Whether it is an adult product Example: false
`products[].isHazmat`	`boolean`	optional	Whether it is hazardous material Example: false
`products[].sourceType`	`string`	optional	Source type: keepa Example: {}
`products[].sourceTool`	`string`	optional	Source tool Example: {}
`errcode`	`integer`	optional	Upstream status code returned by the provider. Example: {}
`errmsg`	`string`	optional	Upstream status message returned by the provider. Example: {}
`code`	`string`	optional	Provider-specific status code. Example: {}
`msg`	`string`	optional	Provider-specific status message. 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: {}
`costTime`	`integer`	optional	Execution time reported by the upstream provider. 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

{
  "history": 1,
  "asin": "B072MQ5BRX",
  "domain": "1"
}

Example structuredContent

{
  "total": 1,
  "perPage": 1,
  "columns": [],
  "costToken": 1,
  "totalCount": 1,
  "currentPage": 1,
  "products": [
    {
      "asin": "B072MQ5BRX",
      "price": 1,
      "primePrice": 1,
      "rating": 1,
      "ratings": 1,
      "reviewCount": 1,
      "salesRank": 1,
      "salesRank30": 1,
      "salesRank90": 1,
      "salesRank180": 1,
      "monthlySalesUnits": 1,
      "monthlySalesRevenue": 1,
      "monthlySalesUnits1MonthAgo": 1,
      "monthlySalesUnits2MonthsAgo": 1,
      "monthlySalesUnits3MonthsAgo": 1,
      "monthlySalesUnits4MonthsAgo": 1,
      "monthlySalesUnits5MonthsAgo": 1,
      "monthlySalesUnits6MonthsAgo": 1,
      "monthlySalesUnits7MonthsAgo": 1,
      "monthlySalesUnits8MonthsAgo": 1,
      "monthlySalesUnits9MonthsAgo": 1,
      "monthlySalesUnits10MonthsAgo": 1,
      "monthlySalesUnits11MonthsAgo": 1,
      "monthlySalesUnits12MonthsAgo": 1,
      "availableDate": "2026-01-01",
      "lastUpdate": "2026-01-01",
      "imageUrl": "https://example.com/image.jpg",
      "productImageUrls": [],
      "asinUrl": "B072MQ5BRX",
      "urlSlug": "https://example.com/image.jpg",
      "itemLength": 1,
      "itemWidth": 1,
      "itemHeight": 1,
      "packageLength": 1,
      "packageWidth": 1,
      "packageHeight": 1,
      "packageQuantity": 1,
      "fbaFees": 1,
      "referralFeePercentage": 1,
      "profit": 1,
      "buyBoxSellerId": "example-id",
      "sellerNum": 1,
      "variationNum": 1,
      "parentAsin": "B072MQ5BRX",
      "rootCategory": 1,
      "categoryTreeId": "example-id",
      "subcategories": [],
      "isAdultProduct": false,
      "isHazmat": false
    }
  ]
}