Amazon History KP
Amazon Product Database Search MCP
Find Amazon products using detailed price, sales, size, and shipping filters. Call via REST API or MCP with your Nexscope API key.
Amazon Product Database Search AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Search The Amazon Product Database
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE].
2. Choose Root Categories By ID
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Use root categories [CATEGORY_IDS], with no more than 50 IDs.
3. Choose Root Categories By Name
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Use root categories [CATEGORY_NAMES_OR_PATHS], with no more than 50 names, and let the service resolve their IDs. Leave the corresponding ID list empty.
4. Choose Included Subcategories By ID
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Use included subcategories [CATEGORY_IDS], with no more than 50 IDs.
5. Choose Included Subcategories By Name
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Use included subcategories [CATEGORY_NAMES_OR_PATHS], with no more than 50 names, and let the service resolve their IDs. Leave the corresponding ID list empty.
6. Choose Excluded Subcategories By ID
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Use excluded subcategories [CATEGORY_IDS], with no more than 50 IDs.
7. Choose Excluded Subcategories By Name
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Use excluded subcategories [CATEGORY_NAMES_OR_PATHS], with no more than 50 names, and let the service resolve their IDs. Leave the corresponding ID list empty.
8. Find A Specific Product Size
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products matching any of these sizes: [PRODUCT_SIZES].
9. Find Standard Physical Products
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Limit the product type to standard physical products.
10. Find Downloadable Products
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Limit the product type to downloadable products.
11. Find EBooks
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Limit the product type to eBooks.
12. Find Parent ASINs
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Limit the product type to variant parent ASINs.
13. Review Several Result Pages
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Collect up to 3 pages for this research task. Request 50 results per page. Stop sooner if there is no next page, an empty result or an error. Deduplicate matching identifiers and do not describe the sample as the full market.
14. Find Products From A Brand
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products from [BRAND].
15. Find Products In Selected Colors
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products matching any of these colors: [COLORS].
16. Find Products By Current Sales Rank
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with current sales rank between [LOWER_LIMIT] and [UPPER_LIMIT].
17. Find Products By 90-Day Average Sales Rank
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with 90-day average sales rank between [LOWER_LIMIT] and [UPPER_LIMIT].
18. Find Products By 90-Day Sales Rank Change Percentage
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with 90-day sales rank change percentage between [LOWER_LIMIT] and [UPPER_LIMIT] percent.
19. Find Products By Units Sold / Monthly Sales
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with units sold / monthly sales between [LOWER_LIMIT] and [UPPER_LIMIT].
20. Find Products By Historical Monthly Sales Rank
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with historical monthly sales rank between [LOWER_LIMIT] and [UPPER_LIMIT]. Use [HISTORICAL_MONTH] within the last 36 months.
21. Find Products By Current New Price
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with current new price between [LOWER_LIMIT] and [UPPER_LIMIT] in the marketplace’s minor currency units.
22. Find Products By Current Buy Box Price With Shipping
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with current buy box price with shipping between [LOWER_LIMIT] and [UPPER_LIMIT] in the marketplace’s minor currency units.
23. Find Products By Current Review Count
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with current review count between [LOWER_LIMIT] and [UPPER_LIMIT].
24. Find Products By Current Rating
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with current rating between [LOWER_LIMIT] and [UPPER_LIMIT].
25. Find Products By Package Length
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with package length between [LOWER_LIMIT] and [UPPER_LIMIT] millimeters.
26. Find Products By Package Width
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with package width between [LOWER_LIMIT] and [UPPER_LIMIT] millimeters.
27. Find Products By Package Height
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with package height between [LOWER_LIMIT] and [UPPER_LIMIT] millimeters.
28. Find Products By Package Weight
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with package weight between [LOWER_LIMIT] and [UPPER_LIMIT] grams.
29. Find Products By Product Launch Dates
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Limit the results to product launch dates between [START_DATE] and [END_DATE]. Preserve the recorded dates rather than assuming they are the request time.
30. Find Products By Variation Count
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with variation count between [LOWER_LIMIT] and [UPPER_LIMIT].
31. Find Products By Current New Offer Count
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with current new offer count between [LOWER_LIMIT] and [UPPER_LIMIT].
32. Find Products By 90-Day Out-Of-Stock Percentage
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Keep products with 90-day out-of-stock percentage between [LOWER_LIMIT] and [UPPER_LIMIT] percent.
33. Find Products By Buy Box Seller
Prompt: Search for [KEYWORD] in [MARKETPLACE] and keep products whose Buy Box seller is [AMAZON_OR_ANOTHER_SELLER].
34. Find Products By Buy Box Fulfillment
Prompt: Search for [KEYWORD] in [MARKETPLACE] and keep Buy Box offers that [USE_OR_DO_NOT_USE] FBA.
35. Filter Products By Hazardous-Material Status
Prompt: Find [HAZARDOUS_OR_NON_HAZARDOUS] products matching [KEYWORD] in [MARKETPLACE], using the status returned by the source.
36. Review Product Variations
Prompt: Search for [KEYWORD] in [MARKETPLACE]. [LIMIT_OR_DO_NOT_LIMIT] the results to one variation per multi-variation product.
37. Research Product Ratings
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. [FETCH_OR_SKIP] the optional product rating information.
38. Get Product Information Without History
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Return product information without historical data.
39. Check Historical Product Data
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Include the available product history and historical sales, retaining the source’s dates and estimates.
40. Prioritize Results By Listing Dates
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing listing date. Use [ASCENDING_OR_DESCENDING] order.
41. Prioritize Results By Sales And Conversions
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing current sales rank or monthly units sold. Use [ASCENDING_OR_DESCENDING] order.
42. Prioritize Results By Customer Feedback
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing rating or review count. Use [ASCENDING_OR_DESCENDING] order.
43. Prioritize Results By Price, Revenue And Costs
Prompt: Find Amazon products matching [KEYWORD] in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing Buy Box price including shipping or new-offer price. Use [ASCENDING_OR_DESCENDING] order.
44. Rank A Sourcing Shortlist By Several Priorities
Prompt: Rank products matching [KEYWORD] in [MARKETPLACE] by monthly units sold from highest to lowest, then by new-offer price from lowest to highest, then by review count from lowest to highest. Use these three priorities in this order.
What You Need to Provide
Replace the bracketed placeholders with your own research inputs. Keep source estimates, reporting periods and missing information explicit.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_amazon_product_database_searchhttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"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
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
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 | integer | optional | Current sales rank range (lower value = better ranking) (lower bound) Example: 1 |
currentSalesLte | integer | optional | Current sales rank range (lower value = better ranking) (upper bound) Example: 1 |
avg90SalesGte | integer | optional | 90-day average sales rank range (lower bound) Example: 1 |
avg90SalesLte | integer | optional | 90-day average sales rank range (upper bound) Example: 1 |
deltaPercent90SalesGte | integer | optional | 90-day sales rank change percentage range (lower bound) Example: 1 |
deltaPercent90SalesLte | integer | optional | 90-day sales rank change percentage range (upper bound) Example: 1 |
monthlySoldGte | integer | optional | Units sold / monthly sales range (lower bound) Example: 1 |
monthlySoldLte | integer | optional | Units sold / monthly sales range (upper bound) Example: 1 |
srAvgGte | integer | optional | Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) (lower bound) Example: 1 |
srAvgLte | integer | optional | Historical sales rank range (positive integer, lower value = better ranking, used for the month specified by srAvgMonth) (upper bound) Example: 1 |
srAvgMonth | string | optional | Historical sales rank - selected month (format: YYYYMM, e.g., 202511 for November 2025, within the last 36 months) |
currentNewGte | integer | optional | Current new price range (in minor currency unit) (lower bound) Example: 1 |
currentNewLte | integer | optional | Current new price range (in minor currency unit) (upper bound) Example: 1 |
currentBuyBoxShippingGte | integer | optional | Current Buy Box price with shipping range (in minor currency unit) (lower bound) Example: 1 |
currentBuyBoxShippingLte | integer | optional | Current Buy Box price with shipping range (in minor currency unit) (upper bound) Example: 1 |
currentCountReviewsGte | integer | optional | Current review count range (lower bound) Example: 1 |
currentCountReviewsLte | integer | optional | Current review count range (upper bound) Example: 1 |
currentRatingGte | number | optional | Current rating range (0.0-5.0) (lower bound) Example: 1 |
currentRatingLte | number | optional | Current rating range (0.0-5.0) (upper bound) Example: 1 |
packageLengthGte | integer | optional | Package length range (mm) (lower bound) Example: 1 |
packageLengthLte | integer | optional | Package length range (mm) (upper bound) Example: 1 |
packageWidthGte | integer | optional | Package width range (mm) (lower bound) Example: 1 |
packageWidthLte | integer | optional | Package width range (mm) (upper bound) Example: 1 |
packageHeightGte | integer | optional | Package height range (mm) (lower bound) Example: 1 |
packageHeightLte | integer | optional | Package height range (mm) (upper bound) Example: 1 |
packageWeightGte | integer | optional | Package weight range (grams) (lower bound) Example: 1 |
packageWeightLte | integer | optional | Package weight range (grams) (upper bound) 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 | string | optional | Product listing time range (date format: yyyy-MM-dd) (lower bound) Example: 2026-01-01 |
availableDateLte | string | optional | Product listing time range (date format: yyyy-MM-dd) (upper bound) 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 | integer | optional | Variation count range (lower bound) Example: 1 |
variationCountLte | integer | optional | Variation count range (upper bound) Example: 1 |
currentCountNewGte | integer | optional | Current new offer count range (lower bound) Example: 1 |
currentCountNewLte | integer | optional | Current new offer count range (upper bound) Example: 1 |
outOfStockPercentage90Gte | integer | optional | 90-day out-of-stock percentage range (lower bound) Example: 1 |
outOfStockPercentage90Lte | integer | optional | 90-day out-of-stock percentage range (upper bound) 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: [
0,
1,
2
] |
history | integer | optional | Whether to include historical data / historical sales in the response (1=include, 0=exclude, default 0) Example: 0 |
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 | Up to 3 sort rules, each with fieldName and sortDirection (asc or desc); supported fields: availableDate, currentSales, monthlySold, currentRating, currentCountReviews, currentBuyBoxShipping, currentNew Example: [] |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Total number of rows. |
perPage | integer | optional | Quantity per page. |
currentPage | integer | optional | Current page number. |
totalCount | integer | optional | Total quantity. |
sourceType | string | optional | Source type: `kp`. |
type | string | optional | Rendering style. |
columns | array | optional | Rendered columns. |
costToken | integer | optional | Consume token. |
products | array | optional | Product list, element fields are shown in the table below. |
asin | string | optional | ASIN。 |
title | string | optional | Product title. |
brand | string | optional | brand. |
manufacturer | string | optional | manufacturer. |
model | string | optional | model. |
price | number | optional | Current price in local currency. |
primePrice | number | optional | Prime Price. |
currency | string | optional | Currency. |
salesRank | integer | optional | Sales ranking. |
salesRank30 | integer | optional | Average sales rank over the past 30 days. |
salesRank90 | integer | optional | Average sales rank over the last 90 days. |
salesRank180 | integer | optional | Average sales rank over the last 180 days. |
monthlySalesUnits | integer | optional | Monthly sales volume. |
monthlySalesRevenue | number | optional | Monthly sales. |
rating | number | optional | Current rating (0.0-5.0). |
ratings | integer | optional | Number of ratings. |
reviewCount | integer | optional | Number of comments. |
availableDate | string | optional | Shelf time (`yyyy-MM-dd HH:mm:ss`). |
lastUpdate | string | optional | Last updated time (`yyyy-MM-dd HH:mm:ss`). |
imageUrl | string | optional | Image URL (request address). |
productImageUrls | array | optional | List of product images. |
asinUrl | string | optional | Amazon ASIN details URL. |
categoryTree | string | optional | Category tree. |
categoryTreeId | string | optional | Category tree ID. |
rootCategory | integer | optional | Root category ID. |
subcategories | array | optional | Subcategory list, including `code` (category ID), `rank` (ranking), `label` (category name). |
fulfillment | string | optional | Delivery method: `AMZ`, `FBA`, `FBM`. |
buyBoxSellerId | string | optional | Buy button seller ID. |
sellerNum | integer | optional | Number of sellers. |
parentAsin | string | optional | Parent ASIN. |
variationNum | integer | optional | Number of variants. |
color | string | optional | color. |
dimension | string | optional | size. |
dimensionsType | string | optional | Size type. |
material | string | optional | The material of a product refers to the main materials used in its construction. |
weight | string | optional | Weight (grams). |
packageWeight | string | optional | Packing weight (grams). |
packageLength | integer | optional | Package length (mm). |
packageWidth | integer | optional | Package width (mm). |
packageHeight | integer | optional | Package height (mm). |
packageDimensions | string | optional | Packaging size. |
packageQuantity | integer | optional | The quantity of the item in the package, or 0 or -1 if not available. |
itemLength | integer | optional | Product length in millimeters, 0 or -1 if not available. |
itemWidth | integer | optional | Product width (mm), 0 or -1 if not available. |
itemHeight | integer | optional | Product height in millimeters, 0 or -1 if not available. |
isAdultProduct | boolean | optional | Whether it is an adult product. |
isHazmat | boolean | optional | Whether it is dangerous goods. |
referralFeePercentage | number | optional | Referral fee percentage. |
fbaFees | number | optional | FBA fulfillment fee in local currency. |
profit | number | optional | Profit margin (percentage, such as 25.5 for 25.5%). |
urlSlug | string | optional | URL Slug。 |
sourceType | string | optional | Source type: `kp`. |
code | — | optional | Category ID; element type shall be subject to the source file or upstream official documentation. |
rank | — | optional | Ranking; element type shall be based on the source file or upstream official documentation. |
label | — | optional | Category name; element type shall be subject to the source file or upstream official documentation. |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find products matching “detox foot pads” on Amazon US with at least 50 monthly sales.
Example Answer
The sample returns one product titled “13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined”, priced at 39.99 with a 4.3 rating and 365 reviews. Its title does not exactly match “detox foot pads”, so review relevance before treating it as a direct competitor.
About this sample: A keyword match is not proof of product equivalence. Prices and reviews are historical sample values; health claims are not validated by this result.
View the Published Sample Data (JSON)
Published REST data example. Use Parameters & Response for MCP arguments when calling this tool.
Data Example
Sample request and response
Request parameters
{
"domain": "1",
"keyword": "detox foot pads",
"monthlySoldGte": 50,
"perPage": 50,
"page": 1,
"singleVariation": true,
"sort": [
{
"fieldName": "monthlySold",
"sortDirection": "desc"
}
]
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"perPage": 50,
"sourceType": "keepa",
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "asin",
"sortable": true,
"title": "ASIN"
},
{
"filterable": true,
"cellType": "text",
"field": "parentAsin",
"sortable": true,
"title": "父ASIN"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "itemHighlights",
"sortable": true,
"title": "亚马逊商品亮点,标题之外的简短商品信息;不可用时为null,最多125个字符"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "图片URL(完整URL)"
},
{
"filterable": true,
"cellType": "text",
"field": "productImageUrls",
"sortable": true,
"title": "商品图片列表"
},
{
"filterable": true,
"cellType": "text",
"field": "urlSlug",
"sortable": true,
"title": "URL Slug"
},
{
"filterable": true,
"cellType": "text",
"field": "asinUrl",
"sortable": true,
"title": "亚马逊asin的详情网址"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesRevenue",
"sortable": true,
"title": "月销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits1MonthAgo",
"sortable": true,
"title": "1月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits2MonthsAgo",
"sortable": true,
"title": "2月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits3MonthsAgo",
"sortable": true,
"title": "3月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits4MonthsAgo",
"sortable": true,
"title": "4月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits5MonthsAgo",
"sortable": true,
"title": "5月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits6MonthsAgo",
"sortable": true,
"title": "6月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits7MonthsAgo",
"sortable": true,
"title": "7月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits8MonthsAgo",
"sortable": true,
"title": "8月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits9MonthsAgo",
"sortable": true,
"title": "9月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits10MonthsAgo",
"sortable": true,
"title": "10月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits11MonthsAgo",
"sortable": true,
"title": "11月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits12MonthsAgo",
"sortable": true,
"title": "12月前月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank",
"sortable": true,
"title": "销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank30",
"sortable": true,
"title": "近30天平均销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank90",
"sortable": true,
"title": "近90天平均销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank180",
"sortable": true,
"title": "近180天平均销售排名"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "当前评分(0"
},
{
"filterable": true,
"cellType": "number",
"field": "ratings",
"sortable": true,
"title": "评分数量"
},
{
"filterable": true,
"cellType": "number",
"field": "reviewCount",
"sortable": true,
"title": "评论数量"
},
{
"filterable": true,
"cellType": "text",
"field": "availableDate",
"sortable": true,
"title": "上架时间(yyyy-MM-dd HH:mm:ss)"
},
{
"filterable": true,
"cellType": "text",
"field": "lastUpdate",
"sortable": true,
"title": "最后更新时间(yyyy-MM-dd HH:mm:ss)"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "当前价格(单位:元,如美元/欧元等)"
},
{
"filterable": true,
"cellType": "number",
"field": "primePrice",
"sortable": true,
"title": "prime价格"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "币种"
},
{
"filterable": true,
"cellType": "number",
"field": "fbaFees",
"sortable": true,
"title": "FBA配送费(单位:元)"
},
{
"filterable": true,
"cellType": "number",
"field": "profit",
"sortable": true,
"title": "利润率(百分比,如25"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillment",
"sortable": true,
"title": "配送方式(AMZ,FBA,FBM)"
},
{
"filterable": true,
"cellType": "number",
"field": "referralFeePercentage",
"sortable": true,
"title": "推荐费百分比"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌"
},
{
"filterable": true,
"cellType": "text",
"field": "manufacturer",
"sortable": true,
"title": "制造商"
},
{
"filterable": true,
"cellType": "text",
"field": "buyBoxSellerId",
"sortable": true,
"title": "购买按钮卖家ID"
},
{
"filterable": true,
"cellType": "text",
"field": "isHazmat",
"sortable": true,
"title": "是否为危险品"
},
{
"filterable": true,
"cellType": "text",
"field": "isAdultProduct",
"sortable": true,
"title": "是否为成人产品"
},
{
"filterable": true,
"cellType": "number",
"field": "variationNum",
"sortable": true,
"title": "变体数量"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerNum",
"sortable": true,
"title": "卖家数"
},
{
"filterable": true,
"cellType": "number",
"field": "rootCategory",
"sortable": true,
"title": "根类目ID"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryTree",
"sortable": true,
"title": "类目树"
},
{
"filterable": true,
"cellType": "text",
"field": "categoryTreeId",
"sortable": true,
"title": "类目树Id"
},
{
"filterable": true,
"cellType": "number",
"field": "packageHeight",
"sortable": true,
"title": "包装高度(毫米)"
},
{
"filterable": true,
"cellType": "number",
"field": "packageLength",
"sortable": true,
"title": "包装长度(毫米)"
},
{
"filterable": true,
"cellType": "number",
"field": "packageWidth",
"sortable": true,
"title": "包装宽度(毫米)"
},
{
"filterable": true,
"cellType": "text",
"field": "packageDimensions",
"sortable": true,
"title": "包装尺寸"
},
{
"filterable": true,
"cellType": "number",
"field": "packageQuantity",
"sortable": true,
"title": "包装中商品的数量,不可用时为0或-1。示例: 3"
},
{
"filterable": true,
"cellType": "text",
"field": "packageWeight",
"sortable": true,
"title": "包装重量(克)"
},
{
"filterable": true,
"cellType": "text",
"field": "weight",
"sortable": true,
"title": "重量(克)"
},
{
"filterable": true,
"cellType": "text",
"field": "model",
"sortable": true,
"title": "型号"
},
{
"filterable": true,
"cellType": "text",
"field": "color",
"sortable": true,
"title": "颜色"
},
{
"filterable": true,
"cellType": "text",
"field": "material",
"sortable": true,
"title": "产品的材质,指其构造中使用的主要材料"
},
{
"filterable": true,
"cellType": "text",
"field": "dimensionsType",
"sortable": true,
"title": "尺寸类型"
},
{
"filterable": true,
"cellType": "text",
"field": "dimension",
"sortable": true,
"title": "尺寸"
},
{
"filterable": true,
"cellType": "number",
"field": "itemHeight",
"sortable": true,
"title": "商品高度,单位为毫米,不可用时为0或-1。示例: 100"
},
{
"filterable": true,
"cellType": "number",
"field": "itemLength",
"sortable": true,
"title": "商品长度,单位为毫米,不可用时为0或-1。示例: 100"
},
{
"filterable": true,
"cellType": "number",
"field": "itemWidth",
"sortable": true,
"title": "商品宽度,单位为毫米,不可用时为0或-1。示例: 100"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "来源类型:keepa"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "subcategories",
"sortable": true,
"title": "子类目列表"
}
],
"totalCount": 2,
"currentPage": 1,
"type": "productWorkbenches",
"products": [
{
"variationNum": 0,
"packageWeight": "1102 g",
"itemHeight": 3,
"rating": 4.3,
"packageWidth": 168,
"availableDate": "2024-11-07 19:24:00",
"salesRank180": 41959,
"sourceTool": "keepa",
"reviewCount": 365,
"price": 39.99,
"referralFeePercentage": 11.25,
"buyBoxSellerId": "A13T0W77JZ2MN9",
"itemWidth": 2,
"fbaFees": 6.31,
"brand": "YHOVID",
"isAdultProduct": false,
"salesRank30": 58369,
"itemLength": 3,
"packageHeight": 138,
"packageDimensions": "231 x 168 x 138 mm",
"monthlySalesRevenue": 11997,
"sourceType": "keepa",
"categoryTreeId": "3760901:3764441:3774931:3775151:6939041011",
"lastUpdate": "2026-10-13 18:24:00",
"subcategories": [
{
"code": "6939041011",
"rank": 310,
"label": "Detox & Cleanse"
},
{
"code": "3760901",
"rank": 58650,
"label": "Health & Household"
}
],
"sellerNum": 1,
"color": "Light Yellow",
"salesRank90": 50300,
"title": "13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined",
"dimensionsType": "1 Count (Pack of 1) Pack of 130",
"manufacturer": "YHOVID",
"productImageUrls": [
"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"https://m.media-amazon.com/images/I/61UJn0pP8rL.jpg",
"https://m.media-amazon.com/images/I/71+LhTdsOqL.jpg",
"https://m.media-amazon.com/images/I/71ZplK0hX6L.jpg",
"https://m.media-amazon.com/images/I/71CL-RT+0ML.jpg",
"https://m.media-amazon.com/images/I/71B3TYk15TL.jpg",
"https://m.media-amazon.com/images/I/71t5EBZ4YRL.jpg"
],
"ratings": 365,
"imageUrl": "https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"itemHighlights": "for Liver Detox, Stomach, Neck, Knee, Foot & Entire Body, Organic Cotton Reusable Pads Kit for Hot/Cold Compres",
"packageLength": 231,
"currency": "$",
"categoryTree": "Health & Household:Diet & Sports Nutrition:Weight Loss:Supplements:Detox & Cleanse",
"salesRank": 58650,
"profit": 84.22,
"isHazmat": false,
"dimension": "3 x 2 x 3 mm",
"urlSlug": "YHOVID-Organic-Unrefined-Reusable-Compress",
"asinUrl": "https://www.amazon.com/dp/B0DJQ7HF3C",
"material": "Organic Cotton, Polyurethane Laminate",
"asin": "B0DJQ7HF3C",
"fulfillment": "FBA",
"rootCategory": 3760901,
"monthlySalesUnits": 300
}
]
}
}View the MCP Request & Response Format
Examples
Based on a published documentation sample, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "amazon-product-database-search-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_database_search",
"arguments": {
"domain": "1",
"keyword": "detox foot pads",
"monthlySoldGte": 50,
"perPage": 50,
"page": 1,
"singleVariation": true,
"sort": [
{
"fieldName": "monthlySold",
"sortDirection": "desc"
}
]
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-product-database-search-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"perPage\":50,\"sourceType\":\"keepa\",\"totalCount\":2,\"currentPage\":1,\"products\":[{\"variationNum\":0,\"packageWeight\":\"1102 g\",\"itemHeight\":3,\"rating\":4.3,\"packageWidth\":168,\"availableDate\":\"2024-11-07 19:24:00\",\"salesRank180\":41959,\"sourceTool\":\"keepa\",\"reviewCount\":365,\"price\":39.99,\"referralFeePercentage\":11.25,\"buyBoxSellerId\":\"A13T0W77JZ2MN9\",\"itemWidth\":2,\"fbaFees\":6.31,\"brand\":\"YHOVID\",\"isAdultProduct\":false,\"salesRank30\":58369,\"itemLength\":3,\"packageHeight\":138,\"packageDimensions\":\"231 x 168 x 138 mm\",\"monthlySalesRevenue\":11997,\"sourceType\":\"keepa\",\"categoryTreeId\":\"3760901:3764441:3774931:3775151:6939041011\",\"lastUpdate\":\"2026-10-13 18:24:00\",\"subcategories\":[{\"code\":\"6939041011\",\"rank\":310,\"label\":\"Detox & Cleanse\"},{\"code\":\"3760901\",\"rank\":58650,\"label\":\"Health & Household\"}],\"sellerNum\":1,\"color\":\"Light Yellow\",\"salesRank90\":50300,\"title\":\"13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined\",\"dimensionsType\":\"1 Count (Pack of 1) Pack of 130\",\"manufacturer\":\"YHOVID\",\"productImageUrls\":[\"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg\",\"https://m.media-amazon.com/images/I/61UJn0pP8rL.jpg\",\"https://m.media-amazon.com/images/I/71+LhTdsOqL.jpg\",\"https://m.media-amazon.com/images/I/71ZplK0hX6L.jpg\",\"https://m.media-amazon.com/images/I/71CL-RT+0ML.jpg\",\"https://m.media-amazon.com/images/I/71B3TYk15TL.jpg\",\"https://m.media-amazon.com/images/I/71t5EBZ4YRL.jpg\"],\"ratings\":365,\"imageUrl\":\"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg\",\"itemHighlights\":\"for Liver Detox, Stomach, Neck, Knee, Foot & Entire Body, Organic Cotton Reusable Pads Kit for Hot/Cold Compres\",\"packageLength\":231,\"currency\":\"$\",\"categoryTree\":\"Health & Household:Diet & Sports Nutrition:Weight Loss:Supplements:Detox & Cleanse\",\"salesRank\":58650,\"profit\":84.22,\"isHazmat\":false,\"dimension\":\"3 x 2 x 3 mm\",\"urlSlug\":\"YHOVID-Organic-Unrefined-Reusable-Compress\",\"asinUrl\":\"https://www.amazon.com/dp/B0DJQ7HF3C\",\"material\":\"Organic Cotton, Polyurethane Laminate\",\"asin\":\"B0DJQ7HF3C\",\"fulfillment\":\"FBA\",\"rootCategory\":3760901,\"monthlySalesUnits\":300}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"perPage": 50,
"sourceType": "keepa",
"totalCount": 2,
"currentPage": 1,
"products": [
{
"variationNum": 0,
"packageWeight": "1102 g",
"itemHeight": 3,
"rating": 4.3,
"packageWidth": 168,
"availableDate": "2024-11-07 19:24:00",
"salesRank180": 41959,
"sourceTool": "keepa",
"reviewCount": 365,
"price": 39.99,
"referralFeePercentage": 11.25,
"buyBoxSellerId": "A13T0W77JZ2MN9",
"itemWidth": 2,
"fbaFees": 6.31,
"brand": "YHOVID",
"isAdultProduct": false,
"salesRank30": 58369,
"itemLength": 3,
"packageHeight": 138,
"packageDimensions": "231 x 168 x 138 mm",
"monthlySalesRevenue": 11997,
"sourceType": "keepa",
"categoryTreeId": "3760901:3764441:3774931:3775151:6939041011",
"lastUpdate": "2026-10-13 18:24:00",
"subcategories": [
{
"code": "6939041011",
"rank": 310,
"label": "Detox & Cleanse"
},
{
"code": "3760901",
"rank": 58650,
"label": "Health & Household"
}
],
"sellerNum": 1,
"color": "Light Yellow",
"salesRank90": 50300,
"title": "13 Pcs Castor Oil Pack Wrap, Castor Oil Organic Cold Pressed Unrefined",
"dimensionsType": "1 Count (Pack of 1) Pack of 130",
"manufacturer": "YHOVID",
"productImageUrls": [
"https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"https://m.media-amazon.com/images/I/61UJn0pP8rL.jpg",
"https://m.media-amazon.com/images/I/71+LhTdsOqL.jpg",
"https://m.media-amazon.com/images/I/71ZplK0hX6L.jpg",
"https://m.media-amazon.com/images/I/71CL-RT+0ML.jpg",
"https://m.media-amazon.com/images/I/71B3TYk15TL.jpg",
"https://m.media-amazon.com/images/I/71t5EBZ4YRL.jpg"
],
"ratings": 365,
"imageUrl": "https://m.media-amazon.com/images/I/71cxRNBhB7L.jpg",
"itemHighlights": "for Liver Detox, Stomach, Neck, Knee, Foot & Entire Body, Organic Cotton Reusable Pads Kit for Hot/Cold Compres",
"packageLength": 231,
"currency": "$",
"categoryTree": "Health & Household:Diet & Sports Nutrition:Weight Loss:Supplements:Detox & Cleanse",
"salesRank": 58650,
"profit": 84.22,
"isHazmat": false,
"dimension": "3 x 2 x 3 mm",
"urlSlug": "YHOVID-Organic-Unrefined-Reusable-Compress",
"asinUrl": "https://www.amazon.com/dp/B0DJQ7HF3C",
"material": "Organic Cotton, Polyurethane Laminate",
"asin": "B0DJQ7HF3C",
"fulfillment": "FBA",
"rootCategory": 3760901,
"monthlySalesUnits": 300
}
]
}
},
"isError": false
}
}