Amazon Marketplace Intelligence

Amazon Product Database Search MCP Tool

Advanced Amazon product search and filtering powered by Keepa data, supporting multi-dimensional criteria including category, price, monthly sales, keywords, BSR rank, review count, rating, package dimensions, weight, fulfillment type, and more.

MCP tool name

nexscope_amazon_product_database_search

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-product-database-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-product-database-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_database_search",
    "arguments": {
      "domain": "1",
      "keyword": "phone case",
      "page": 1,
      "perPage": 50
    }
  }
}

REST API equivalent

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

Canonical detail URL

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

Arguments

Name	Type	Required	Meaning
`domain`	`string`	required	Amazon domain ID: 1=United States, 2=United Kingdom, 3=Germany, 4=France, 5=Japan, 6=Canada, 8=Italy, 9=Spain, 10=India, 11=Mexico Example: 1
`keyword`	`string`	optional	Title keyword (case-insensitive; spaces mean AND tokenization; wrap keywords containing spaces in double quotes; prefix - for exclusion; & symbol is replaced with space; up to 50 keywords, max 1000 characters) Example: phone case
`rootCategory`	`array`	optional	Root category IDs (up to 50), only include products in these root categories Example: []
`rootCategoryNames`	`array`	optional	Root category names (up to 50), used when rootCategory is empty; the system automatically looks up corresponding category IDs Example: []
`categoriesInclude`	`array`	optional	Subcategory IDs to include only (up to 50), only include products directly listed in these subcategories Example: []
`categoriesIncludeNames`	`array`	optional	Subcategory names to include (up to 50), used when categoriesInclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths (separated by : or >) for more accurate results Example: []
`categoriesExclude`	`array`	optional	Subcategory IDs to exclude (up to 50) Example: []
`categoriesExcludeNames`	`array`	optional	Subcategory names to exclude (up to 50), used when categoriesExclude is empty; the system automatically looks up corresponding category IDs. Supports full category paths for more accurate results Example: []
`currentSalesGte/currentSalesLte`	`integer`	optional	Current sales rank range (lower value = better ranking) Example: 1
`avg90SalesGte/avg90SalesLte`	`integer`	optional	90-day average sales rank range Example: 1
`deltaPercent90SalesGte/deltaPercent90SalesLte`	`integer`	optional	90-day sales rank change percentage range Example: 1
`monthlySoldGte/monthlySoldLte`	`integer`	optional	Units sold / monthly sales range Example: 1
`srAvgGte/srAvgLte`	`integer`	optional	Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) Example: 1
`srAvgMonth`	`string`	optional	Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months) Example: {}
`currentNewGte/currentNewLte`	`integer`	optional	Current new price range (in minor currency unit) Example: 1
`currentBuyBoxShippingGte/currentBuyBoxShippingLte`	`integer`	optional	Current Buy Box price with shipping range (in minor currency unit) Example: 1
`currentCountReviewsGte/currentCountReviewsLte`	`integer`	optional	Current review count range Example: 1
`currentRatingGte/currentRatingLte`	`number`	optional	Current rating range (0.0-5.0) Example: 1
`packageLengthGte/packageLengthLte`	`integer`	optional	Package length range (mm) Example: 1
`packageWidthGte/packageWidthLte`	`integer`	optional	Package width range (mm) Example: 1
`packageHeightGte/packageHeightLte`	`integer`	optional	Package height range (mm) Example: 1
`packageWeightGte/packageWeightLte`	`integer`	optional	Package weight range (grams) Example: 1
`brand`	`array`	optional	Brand (OR match) Example: []
`color`	`array`	optional	Color (OR match), filter products with specified colors Example: []
`size`	`array`	optional	Size (OR match), filter products with specified sizes Example: []
`availableDateGte/availableDateLte`	`string`	optional	Product listing time range (date format: yyyy-MM-dd) Example: 2026-01-01
`buyBoxIsAmazon`	`boolean`	optional	Whether the Buy Box seller is Amazon Example: false
`buyBoxIsFBA`	`boolean`	optional	Whether the Buy Box is FBA Example: false
`isHazMat`	`boolean`	optional	Whether it is hazardous material Example: false
`variationCountGte/variationCountLte`	`integer`	optional	Variation count range Example: 1
`currentCountNewGte/currentCountNewLte`	`integer`	optional	Current new offer count range Example: 1
`outOfStockPercentage90Gte/outOfStockPercentage90Lte`	`integer`	optional	90-day out-of-stock percentage range Example: 1
`singleVariation`	`boolean`	optional	Return only one variation; when set to true, multi-variation products will only return one variation Example: false
`productType`	`array`	optional	Product type filter (default [0,1,2]): 0=standard product, 1=downloadable product, 2=eBook, 5=variant parent ASIN Example: []
`history`	`integer`	optional	Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0) Example: 1
`rating`	`integer`	optional	Whether to fetch rating info (1=fetch, 0=do not fetch, default 1) Example: 1
`page`	`integer`	optional	Page number (starting from 1, default 1) Example: 1
`perPage`	`integer`	optional	Maximum results per page (min 50, max 100, default 50) Example: 50
`sort`	`array`	optional	Sort (up to 3): array of objects, each containing {"fieldName": "...", "sortDirection": "asc\ Example: []

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
`currentPage`	`integer`	optional	Current page number Example: 1
`totalCount`	`integer`	optional	Total count Example: 1
`sourceType`	`string`	optional	Source type: keepa Example: {}
`type`	`string`	optional	Render style Example: {}
`columns`	`array`	optional	Rendered columns Example: []
`costToken`	`integer`	optional	Token consumption Example: 1
`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[].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[].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
`monthlySalesUnits1MonthAgo..monthlySalesUnits12MonthsAgo`	`integer`	optional	Monthly sales units for each of the last 12 months Example: 1
`products[].rating`	`number`	optional	Current rating (0.0-5.0) Example: 1
`products[].ratings`	`integer`	optional	Number of ratings Example: 1
`products[].reviewCount`	`integer`	optional	Number of reviews 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[].categoryTree`	`string`	optional	Category tree Example: {}
`products[].categoryTreeId`	`string`	optional	Category tree ID Example: example-id
`products[].rootCategory`	`integer`	optional	Root category ID Example: 1
`products[].subcategories`	`array`	optional	Subcategory list, containing code (category ID), rank (ranking), label (category name) Example: []
`products[].fulfillment`	`string`	optional	Fulfillment method (AMZ, FBA, FBM) Example: {}
`products[].buyBoxSellerId`	`string`	optional	Buy Box seller ID Example: example-id
`products[].sellerNum`	`integer`	optional	Number of sellers Example: 1
`products[].parentAsin`	`string`	optional	Parent ASIN Example: B072MQ5BRX
`products[].variationNum`	`integer`	optional	Number of variations Example: 1
`products[].color`	`string`	optional	Color Example: {}
`products[].dimension`	`string`	optional	Dimensions Example: {}
`products[].dimensionsType`	`string`	optional	Dimensions type Example: {}
`products[].material`	`string`	optional	Product material, the primary material used in its construction Example: {}
`products[].weight`	`string`	optional	Weight (grams) Example: {}
`products[].packageWeight`	`string`	optional	Package 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[].packageDimensions`	`string`	optional	Package dimensions Example: {}
`products[].packageQuantity`	`integer`	optional	Quantity of items in the package, 0 or -1 if unavailable Example: 1
`products[].itemLength`	`integer`	optional	Item length (mm), 0 or -1 if unavailable Example: 1
`products[].itemWidth`	`integer`	optional	Item width (mm), 0 or -1 if unavailable Example: 1
`products[].itemHeight`	`integer`	optional	Item height (mm), 0 or -1 if unavailable Example: 1
`products[].isAdultProduct`	`boolean`	optional	Whether it is an adult product Example: false
`products[].isHazmat`	`boolean`	optional	Whether it is hazardous material Example: false
`products[].referralFeePercentage`	`number`	optional	Referral fee percentage Example: 1
`products[].fbaFees`	`number`	optional	FBA fulfillment fee (in local currency) Example: 1
`products[].profit`	`number`	optional	Profit margin (percentage, e.g., 25.5 means 25.5%) Example: 1
`products[].urlSlug`	`string`	optional	URL slug Example: https://example.com/image.jpg
`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

{
  "domain": "1",
  "keyword": "phone case",
  "page": 1,
  "perPage": 50
}

Example structuredContent

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