Amazon Marketplace Intelligence

Amazon Search MCP Tool

Simulates a real user searching on Amazon's storefront to get real-time keyword ranking and search results page data.

MCP tool name
nexscope_amazon_search
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-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-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_search",
    "arguments": {
      "keyword": "phone case",
      "page": 1
    }
  }
}
REST API equivalent
POST /api/skill-api/v1/runhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/amazon-search

Arguments

NameTypeRequiredMeaning
keywordstringoptional
Keyword; please translate to the language of the target country whenever possible, e.g., use English keywords for the US, German keywords for Germany, etc. (max length 1024)
Example: phone case
amazonDomainstringoptional
Amazon country site, default amazon.com
Example: {}
nodestringoptional
Amazon category node (max length 1000)
Example: {}
languagestringoptional
Language/region code, e.g., en_US, de_DE, ja_JP, fr_FR (max length 1000)
Example: {}
sortstringoptional
Sort order: relevanceblender (Featured, default), price-asc-rank (Price low to high), price-desc-rank (Price high to low), review-rank (Avg. customer review), date-desc-rank (Newest arrivals), exact-aware-popularity-rank (Best sellers)
Example: {}
pageintegeroptional
Page number (starting from 1, ~20 items per page), default 1
Example: 1
deliveryZipstringoptional
Delivery zip code, used to simulate Amazon frontend address. It is recommended to use commonly used zip codes for major cities in the target country, e.g., New York zip code 10001 for the US site (max length 1000)
Example: {}
devicestringoptional
Device type: desktop, mobile, tablet, default desktop (max length 1000)
Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
totalintegeroptional
Total rows
Example: 1
keywordstringoptional
Search keyword
Example: phone case
typestringoptional
Render style
Example: {}
columnsarrayoptional
Rendered column definitions
Example: []
costTokenintegeroptional
Token consumption
Example: 1
productsarrayoptional
Search result list (see below)
Example: []
products[].asinstringoptional
ASIN
Example: B072MQ5BRX
products[].titlestringoptional
Title
Example: {}
products[].brandstringoptional
Brand
Example: {}
products[].pricenumberoptional
Price
Example: 1
products[].extractedPricenumberoptional
Parsed price
Example: 1
products[].oldPricenumberoptional
Strikethrough price
Example: 1
products[].extractedOldPricenumberoptional
Parsed strikethrough price
Example: 1
products[].currencystringoptional
Currency
Example: {}
products[].priceUnitstringoptional
Price unit
Example: {}
products[].extractedPriceUnitnumberoptional
Parsed price unit
Example: 1
products[].ratingnumberoptional
Rating
Example: 1
products[].ratingsintegeroptional
Number of ratings
Example: 1
products[].positionintegeroptional
Position
Example: 1
products[].sponsoredbooleanoptional
Whether sponsored
Example: false
products[].imageUrlstringoptional
Thumbnail
Example: https://example.com/image.jpg
products[].asinUrlstringoptional
Link
Example: B072MQ5BRX
products[].deliverystringoptional
Delivery information
Example: {}
products[].fulfillmentstringoptional
Fulfillment information (e.g., FBA)
Example: {}
products[].availableDatestringoptional
Listing time
Example: 2026-01-01
products[].monthlySalesUnitsintegeroptional
Monthly sales units
Example: 1
products[].monthlySalesRevenuestringoptional
Monthly sales revenue
Example: {}
products[].sellerNationstringoptional
Seller nationality
Example: {}
products[].dimensionstringoptional
Dimensions
Example: {}
products[].weightstringoptional
Weight
Example: {}
products[].optionsstringoptional
Options
Example: {}
products[].offersstringoptional
Offer information
Example: {}
products[].badgesstringoptional
Amazon frontend search badges
Example: {}
products[].tagsstringoptional
Tags
Example: {}
products[].snapEbtEligiblebooleanoptional
SNAP/EBT eligibility
Example: false
products[].sourceTypestringoptional
Source type: amazon
Example: {}
products[].sourceToolstringoptional
Source tool
Example: {}
products[].keywordstringoptional
Keyword
Example: phone case
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
messagestringoptional
Provider-specific message.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "page": 1
}

Example structuredContent

{
  "total": 1,
  "keyword": "phone case",
  "columns": [],
  "costToken": 1,
  "products": [
    {
      "asin": "B072MQ5BRX",
      "price": 1,
      "extractedPrice": 1,
      "oldPrice": 1,
      "extractedOldPrice": 1,
      "extractedPriceUnit": 1,
      "rating": 1,
      "ratings": 1,
      "position": 1,
      "sponsored": false,
      "imageUrl": "https://example.com/image.jpg",
      "asinUrl": "B072MQ5BRX",
      "availableDate": "2026-01-01",
      "monthlySalesUnits": 1,
      "snapEbtEligible": false,
      "keyword": "phone case"
    }
  ]
}