Amazon Marketplace Intelligence

Amazon Broad Product Search MCP Tool

Use SellerSprite data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces.

MCP tool name

nexscope_amazon_broad_product_search

Equivalent REST API path

https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-broad-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-broad-product-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_broad_product_search",
    "arguments": {
      "keyword": "phone case",
      "size": 20,
      "page": 1,
      "marketplace": "US",
      "matchType": 1
    }
  }
}

REST API equivalent

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

Canonical detail URL

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

Arguments

Name	Type	Required	Meaning
`chatId`	`string`	optional	Chat ID, maxLength 1000 Example: example-id
`uid`	`string`	optional	User ID, maxLength 1000 Example: example-id
`requestId`	`string`	optional	Push ID, maxLength 1000 Example: example-id
`teamId`	`string`	optional	Team ID, maxLength 1000 Example: example-id
`keyword`	`string`	optional	Search keyword; translate to the corresponding country's language whenever possible, e.g. use English keywords for the US, German keywords for Germany, etc.; maxLength 10240 Example: phone case
`matchType`	`integer`	optional	Match type: 1 = phrase match (default), 2 = fuzzy match, 3 = exact match Example: 1
`excludeKeywords`	`string`	optional	Exclude keywords; maxLength 10240 Example: phone case
`marketplace`	`string`	optional	Marketplace site code, default US. Only US, UK, DE, FR, JP, CA, IT, ES, MX, IN are allowed (must match this enum; AU, TR, and other unlisted sites are not supported) Example: US
`nodeLabel`	`string`	optional	Amazon category name; maxLength 1000 Example: {}
`nodeIdPath`	`string`	optional	Amazon category node ID; maxLength 1000 Example: {}
`filterSubNode`	`boolean`	optional	Whether to filter subcategory nodes; only effective when nodeLabel or nodeIdPath has a value; pass JSON boolean true / false Example: false
`dataSnapshotMonth`	`string`	optional	Product data snapshot month, format yyyyMM (e.g. 202412 for December 2024 data snapshot), or nearly for last 30 days real-time data. Default: nearly. Used for historical analysis and period comparison; only supports existing historical snapshots, future dates are not supported; maxLength 1000 Example: {}
`minPrice`	`number`	optional	Minimum price (>= 0) Example: 1
`maxPrice`	`number`	optional	Maximum price (>= 0) Example: 1
`minProfit`	`number`	optional	Minimum gross margin, unit % (1-100) Example: 1
`maxProfit`	`number`	optional	Maximum gross margin, unit % (1-100) Example: 1
`minRevenue`	`number`	optional	Minimum monthly sales revenue (>= 0) Example: 1
`maxRevenue`	`number`	optional	Maximum monthly sales revenue (>= 0) Example: 1
`minFba`	`number`	optional	Minimum FBA shipping fee (>= 0) Example: 1
`maxFba`	`number`	optional	Maximum FBA shipping fee (>= 0) Example: 1
`minUnits`	`integer`	optional	Minimum monthly sales volume (>= 0) Example: 1
`maxUnits`	`integer`	optional	Maximum monthly sales volume (>= 0) Example: 1
`minAmzUnit`	`integer`	optional	Minimum variant last-30-day sales volume (only supported when dataSnapshotMonth is a "last 30 days" type query); minimum 0 Example: 1
`maxAmzUnit`	`integer`	optional	Maximum variant last-30-day sales volume (only supported for last 30 days queries); minimum 0 Example: 1
`minUnitsGrowthRate`	`number`	optional	Minimum monthly sales volume growth rate, unit % Example: 1
`maxUnitsGrowthRate`	`number`	optional	Maximum monthly sales volume growth rate, unit % Example: 1
`minBsr`	`integer`	optional	Lowest main category BSR rank Example: 1
`maxBsr`	`integer`	optional	Highest main category BSR rank Example: 1
`minBsrGrowthRate`	`number`	optional	Minimum BSR growth rate, unit % Example: 1
`maxBsrGrowthRate`	`number`	optional	Maximum BSR growth rate, unit % Example: 1
`minBsrGrowthCount`	`integer`	optional	Minimum BSR growth count Example: 1
`maxBsrGrowthCount`	`integer`	optional	Maximum main category BSR growth count Example: 1
`minSubNodeBsrRank`	`integer`	optional	Lowest subcategory BSR rank (requires filterSubNode = true) Example: 1
`maxSubNodeBsrRank`	`integer`	optional	Highest subcategory BSR rank (requires filterSubNode = true) Example: 1
`minRating`	`number`	optional	Minimum rating value (0-5) Example: 1
`maxRating`	`number`	optional	Maximum rating value (0-5), 3.8-4.3 is the product improvement opportunity range Example: 1
`minRatings`	`integer`	optional	Minimum review count (0-10000) Example: 1
`maxRatings`	`integer`	optional	Maximum review count (0-10000) Example: 1
`minRatingsGrowthCount`	`integer`	optional	Minimum monthly new review count (>= 0) Example: 1
`maxRatingsGrowthCount`	`integer`	optional	Maximum monthly new review count (>= 0) Example: 1
`minListingQualityScore`	`number`	optional	Minimum Listing page quality score (>= 0) Example: 1
`maxListingQualityScore`	`number`	optional	Maximum Listing page quality score (>= 0) Example: 1
`minVariations`	`integer`	optional	Minimum number of variations Example: 1
`maxVariations`	`integer`	optional	Maximum number of variations Example: 1
`minWeights`	`number`	optional	Minimum weight (>= 0) Example: 1
`maxWeights`	`number`	optional	Maximum weight (>= 0) Example: 1
`weightUnit`	`string`	optional	Weight unit: g, kg, oz, lb. This field must be specified if the parameters include weight filtering Example: {}
`dimensionType`	`string`	optional	Package dimension type (codes vary by site, see below) Example: {}
`minSellers`	`integer`	optional	Minimum number of sellers Example: 1
`maxSellers`	`integer`	optional	Maximum number of sellers Example: 1
`badgeBestSeller`	`string`	optional	Best Seller badge filter: Y, N, or empty (all) Example: {}
`badgeAmazonsChoice`	`string`	optional	Amazon's Choice badge filter: Y, N, or empty (all) Example: {}
`badgeNewRelease`	`string`	optional	New Release badge filter: Y, N, or empty (all) Example: {}
`fulfillment`	`string`	optional	Fulfillment method: single select AMZ / FBA / FBM, or multi-select such as AMZ,FBA, FBA,FBM, AMZ,FBA,FBM, etc.; multiple conditions use comma separation; empty means no limit Example: {}
`showVariation`	`string`	optional	Whether to query variants: Y or N, default N Example: {}
`hideUnlistedProduct`	`boolean`	optional	Whether to hide delisted products, default true Example: false
`listedWithinLastMonths`	`integer`	optional	Time since listing (months), only allowed: 1, 3, 6, 12, 24 (must match these enum values; do not pass other integers) Example: 1
`sellerNation`	`string`	optional	Seller location code (e.g. US, CN, HK), multiple conditions comma-separated, default no limit Example: {}
`includeSellers`	`string`	optional	Include sellers; maxLength 10240 Example: {}
`excludeSellers`	`string`	optional	Exclude sellers; maxLength 10240 Example: {}
`includeBrands`	`string`	optional	Include brands; maxLength 10240 Example: {}
`excludeBrands`	`string`	optional	Exclude brands; maxLength 10240 Example: {}
`order`	`object`	optional	Sort configuration; if passed, it is recommended to provide both field and desc (both are required in the sub-schema) Example: {}
`order.field`	`string`	optional	Sort field: total_units (monthly sales), total_amount (monthly revenue), bsr_rank, price, rating, reviews, profit, reviews_rate, available_date, questions, total_units_growth, total_amount_growth, reviews_increasement, bsr_rank_cv, bsr_rank_cr, amz_unit (variant sales). Default total_units. Pass an empty string "" to not sort by the above business fields (full query sort semantics are handled by the server) Example: {}
`order.desc`	`string`	optional	"true" descending, "false" ascending; default "true"; maxLength 1000 Example: {}
`page`	`integer`	optional	Page number, starting from 1, default 1 Example: 1
`size`	`integer`	optional	Results per page (10-100), default 20 Example: 20

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Meaning
`total`	`integer`	optional	Total matching product count Example: 1
`products`	`array`	optional	Product list (see product object fields below) Example: []
`columns`	`array`	optional	Render column definitions Example: []
`keyword`	`string`	optional	Search keyword used (if any) Example: phone case
`products[].nodeIdPath`	`string`	optional	Searched category node Example: {}
`products[].nodeLabel`	`string`	optional	Amazon category name Example: {}
`dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`sourceType`	`string`	optional	Source type (e.g. "amazon") Example: {}
`type`	`string`	optional	Render style Example: {}
`message`	`string`	optional	Additional message or error info Example: {}
`costToken`	`integer`	optional	Tokens consumed Example: 1
`products[].asin`	`string`	optional	Amazon ASIN Example: B072MQ5BRX
`products[].title`	`string`	optional	Product title Example: {}
`products[].asinUrl`	`string`	optional	Amazon product detail page URL Example: B072MQ5BRX
`products[].imageUrl`	`string`	optional	Product image URL Example: https://example.com/image.jpg
`products[].price`	`number`	optional	Current price Example: 1
`products[].averagePrice`	`number`	optional	Average price Example: 1
`products[].primePrice`	`number`	optional	Prime price, -1 means not available Example: 1
`products[].currency`	`string`	optional	Currency Example: {}
`products[].monthlySalesUnits`	`integer`	optional	Monthly sales volume Example: 1
`products[].monthlySalesRevenue`	`number`	optional	Monthly sales revenue Example: 1
`products[].monthlySalesUnitsGrowthRate`	`number`	optional	Monthly sales volume growth rate Example: 1
`products[].bsr`	`integer`	optional	BSR rank Example: 1
`products[].bsrGrowthRate`	`number`	optional	BSR growth rate Example: 1
`products[].rating`	`number`	optional	Rating Example: 1
`products[].ratings`	`integer`	optional	Review count Example: 1
`products[].ratingsRate`	`number`	optional	Review rate Example: 1
`products[].profit`	`number`	optional	Gross margin (%) Example: 1
`products[].fba`	`number`	optional	FBA shipping fee Example: 1
`products[].sellerNum`	`integer`	optional	Number of sellers Example: 1
`products[].sellerId`	`string`	optional	BuyBox seller ID Example: example-id
`products[].sellerName`	`string`	optional	BuyBox seller name Example: {}
`products[].sellerNation`	`string`	optional	BuyBox seller nationality Example: {}
`products[].brand`	`string`	optional	Brand Example: {}
`products[].brandUrl`	`string`	optional	Brand page URL Example: https://example.com/image.jpg
`products[].fulfillment`	`string`	optional	Fulfillment method (AMZ / FBA / FBM) Example: {}
`products[].availableDate`	`string`	optional	Listing time (timestamp) Example: 2026-01-01
`products[].availableDateString`	`string`	optional	Listing date (formatted string) Example: 2026-01-01
`products[].variationNum`	`integer`	optional	Number of variations Example: 1
`products[].variant30DayUnits`	`integer`	optional	Variant monthly sales (units) Example: 1
`products[].variant30DayRevenue`	`number`	optional	Variant monthly sales revenue (amount) Example: 1
`products[].variant30DayUpdatedAt`	`string`	optional	Variant data update time Example: 2026-01-01
`products[].weight`	`string`	optional	Weight Example: {}
`products[].packageWeight`	`string`	optional	Package weight Example: {}
`products[].dimension`	`string`	optional	Dimensions Example: {}
`products[].packageDimensions`	`string`	optional	Package dimensions Example: {}
`products[].dimensionsType`	`string`	optional	Dimension type Example: {}
`products[].packageDimensionType`	`string`	optional	Package dimension type Example: {}
`products[].listingQualityScore`	`number`	optional	Listing quality score Example: 1
`products[].deliveryPrice`	`number`	optional	Seller shipping fee, -1 means not available Example: 1
`products[].nodeLabelPath`	`string`	optional	Category path Example: {}
`products[].nodeIdPath`	`string`	optional	Node ID path Example: {}
`products[].nodeId`	`integer`	optional	Node ID Example: 1
`products[].dataSnapshotMonth`	`string`	optional	Data query month Example: {}
`products[].badgeBestSeller`	`string`	optional	Best Seller badge (Y/N) Example: {}
`products[].badgeAmazonChoice`	`string`	optional	Amazon's Choice badge (Y/N) Example: {}
`products[].badgeNewRelease`	`string`	optional	New Release badge (Y/N) Example: {}
`products[].badgeVideo`	`string`	optional	Video introduction (Y/N) Example: {}
`products[].badgeEbc`	`string`	optional	A+ page (Y/N) Example: {}
`products[].badge`	`object`	optional	Badge summary object, containing: bestSeller, amazonChoice, newRelease, video, ebc Example: {}
`products[].subcategories`	`array`	optional	Subcategory list, each entry containing code (category code), rank (rank), label (name) Example: []
`products[].sku`	`string`	optional	SKU Example: {}
`products[].keyword`	`string`	optional	Matching keyword Example: phone case
`products[].sourceType`	`string`	optional	Source type Example: {}
`products[].sourceTool`	`string`	optional	Source tool identifier 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: {}
`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: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "size": 20,
  "page": 1,
  "marketplace": "US",
  "matchType": 1
}

Example structuredContent

{
  "total": 1,
  "products": [
    {
      "asin": "B072MQ5BRX",
      "asinUrl": "B072MQ5BRX",
      "imageUrl": "https://example.com/image.jpg",
      "price": 1,
      "averagePrice": 1,
      "primePrice": 1,
      "monthlySalesUnits": 1,
      "monthlySalesRevenue": 1,
      "monthlySalesUnitsGrowthRate": 1,
      "bsr": 1,
      "bsrGrowthRate": 1,
      "rating": 1,
      "ratings": 1,
      "ratingsRate": 1,
      "profit": 1,
      "fba": 1,
      "sellerNum": 1,
      "sellerId": "example-id",
      "brandUrl": "https://example.com/image.jpg",
      "availableDate": "2026-01-01",
      "availableDateString": "2026-01-01",
      "variationNum": 1,
      "variant30DayUnits": 1,
      "variant30DayRevenue": 1,
      "variant30DayUpdatedAt": "2026-01-01",
      "listingQualityScore": 1,
      "deliveryPrice": 1,
      "nodeId": 1,
      "badge": {},
      "subcategories": [],
      "keyword": "phone case"
    }
  ],
  "columns": [],
  "keyword": "phone case",
  "costToken": 1
}