Amazon Research JS
Amazon Product Database MCP
Find Amazon products by category, price, sales, reviews, and seller type. Call the Amazon Product Database API via REST or MCP with your Nexscope API key.
Amazon Product Database 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. Find Products For A Sourcing Brief
Prompt: Find Amazon product candidates in [MARKETPLACE].
2. Find Products By Seller Type
Prompt: Find Amazon product candidates in [MARKETPLACE]. Choose [SELLER_TYPES]: Amazon retail, FBA, seller fulfillment, or a combination.
3. Find Products By Size Tier
Prompt: Find Amazon product candidates in [MARKETPLACE]. Choose [STANDARD_OR_OVERSIZE] products for the sourcing shortlist. Include both size tiers if needed.
4. Limit The Research Shortlist
Prompt: Find Amazon product candidates in [MARKETPLACE]. Return no more than [RESULT_LIMIT] matches. Stop at that limit and keep the result as a bounded sample.
5. Exclude Unwanted Keywords
Prompt: Find Amazon product candidates in [MARKETPLACE]. Exclude results containing [EXCLUDED_WORDS].
6. Find Products Containing Specific Words
Prompt: Find Amazon product candidates in [MARKETPLACE]. Include products whose titles or ASINs contain [INCLUDED_WORDS], using at most 100 terms of no more than 50 characters each.
7. Search A Product Category
Prompt: Find Amazon product candidates in [MARKETPLACE]. Use the marketplace’s category [CATEGORY_NAME].
8. Find Products By Price
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with price between [LOWER_LIMIT] and [UPPER_LIMIT].
9. Find Products By Monthly Sales
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with monthly sales between [LOWER_LIMIT] and [UPPER_LIMIT].
10. Find Products By Monthly Revenue
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with monthly revenue between [LOWER_LIMIT] and [UPPER_LIMIT].
11. Find Products By Number Of Reviews
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with number of reviews between [LOWER_LIMIT] and [UPPER_LIMIT].
12. Find Products By Rating
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with rating between [LOWER_LIMIT] and [UPPER_LIMIT].
13. Find Products By Weight
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with weight between [LOWER_LIMIT] and [UPPER_LIMIT] pounds.
14. Find Products By BSR Ranking
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with BSR ranking between [LOWER_LIMIT] and [UPPER_LIMIT].
15. Find Products By Lqs Score
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with lqs score between [LOWER_LIMIT] and [UPPER_LIMIT].
16. Find Products By Number Of Sellers
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with number of sellers between [LOWER_LIMIT] and [UPPER_LIMIT].
17. Find Products By Net Profit
Prompt: Find Amazon product candidates in [MARKETPLACE]. Keep products with net profit between [LOWER_LIMIT] and [UPPER_LIMIT].
18. Find Products By Data Update Dates
Prompt: Find Amazon product candidates in [MARKETPLACE]. Limit the results to data update dates between [START_DATE] and [END_DATE]. Preserve the recorded dates rather than assuming they are the request time.
19. Find Products Outside Leading Brands
Prompt: Find Amazon products in [MARKETPLACE], [INCLUDING_OR_EXCLUDING] the source’s top-brand products.
20. Check Product Availability
Prompt: Find Amazon products in [MARKETPLACE], [INCLUDING_OR_EXCLUDING] products marked unavailable.
21. Prioritize Results By Product Attributes
Prompt: Find Amazon product candidates in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing product name or category. Use [ASCENDING_OR_DESCENDING] order.
22. Prioritize Results By Price, Revenue And Costs
Prompt: Find Amazon product candidates in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing revenue or price. Use [ASCENDING_OR_DESCENDING] order.
23. Prioritize Results By Sales And Conversions
Prompt: Find Amazon product candidates in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing sales or sales rank. Use [ASCENDING_OR_DESCENDING] order.
24. Prioritize Results By Customer Feedback
Prompt: Find Amazon product candidates in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing review count or listing quality score. Use [ASCENDING_OR_DESCENDING] order.
25. Prioritize Results By Competition
Prompt: Find Amazon product candidates in [MARKETPLACE]. Put [RANKING_PRIORITY] first, choosing seller count. Use [ASCENDING_OR_DESCENDING] 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_databasehttps://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-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_database",
"arguments": {
"includeKeywords": "phone case",
"marketplace": "us",
"needCount": 10,
"sort": "-sales"
}
}
}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 |
|---|---|---|---|
marketplace | string | required | Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp Example: us |
includeKeywords | string | optional | Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case |
excludeKeywords | string | optional | Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case |
categories | string | optional | Primary category names, comma-separated, must match the standard category names for the corresponding site. US site examples: Appliances, Arts Crafts & Sewing, Automotive, Baby, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Computers, Digital Music, Electronics, Garden & Outdoor, Grocery & Gourmet Food, Handmade, Health Household & Baby Care, Home & Kitchen, Industrial & Scientific, Kindle Store, Kitchen & Dining, Movies & TV, Musical Instruments, Office Products, Pet Supplies, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games, etc. Other sites (uk, de, fr, it, es, mx, jp, ca, in) have their own localized category names |
minPrice | number | optional | Minimum price Example: 1 |
maxPrice | number | optional | Maximum price Example: 1 |
minSales | integer | optional | Minimum monthly sales Example: 1 |
maxSales | integer | optional | Maximum monthly sales Example: 1 |
minRevenue | number | optional | Minimum monthly revenue Example: 1 |
maxRevenue | number | optional | Maximum monthly revenue Example: 1 |
minReviews | integer | optional | Minimum number of reviews Example: 1 |
maxReviews | integer | optional | Maximum number of reviews Example: 1 |
minRating | number | optional | Minimum rating (1.0-5.0) Example: 1 |
maxRating | number | optional | Maximum rating (1.0-5.0) Example: 1 |
minWeight | number | optional | Minimum weight (lbs) Example: 1 |
maxWeight | number | optional | Maximum weight (lbs) Example: 1 |
minRank | integer | optional | Minimum BSR ranking Example: 1 |
maxRank | integer | optional | Maximum BSR ranking Example: 1 |
minLqs | integer | optional | Minimum LQS score (1-10) Example: 1 |
maxLqs | integer | optional | Maximum LQS score (1-10) Example: 1 |
minSellers | integer | optional | Minimum number of sellers Example: 1 |
maxSellers | integer | optional | Maximum number of sellers Example: 1 |
minNet | number | optional | Minimum net profit Example: 1 |
maxNet | number | optional | Maximum net profit Example: 1 |
sellerTypes | string | optional | Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm |
productTiers | string | optional | Product size tiers, comma-separated. Options: oversize, standard |
excludeTopBrands | boolean | optional | Whether to exclude top brands Example: false |
excludeUnavailableProducts | boolean | optional | Whether to exclude unavailable products Example: false |
minUpdatedAt | string | optional | Data update start date (YYYY-MM-DD) Example: 2026-01-01 |
maxUpdatedAt | string | optional | Data update end date (YYYY-MM-DD) Example: 2026-01-01 |
needCount | integer | optional | Total number of results to return, API auto-paginates internally Example: 1 |
sort | string | optional | Sort field. Options: name, -name, category, -category, revenue, -revenue, sales, -sales, price, -price, rank, -rank, reviews, -reviews, lqs, -lqs, sellers, -sellers. Prefix - indicates descending. Default: name |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
costToken | integer | optional | Number of tokens consumed |
productDatabaseList | array | optional | Product data list |
id | string | optional | Product unique identifier |
title | string | optional | product title |
brand | string | optional | brand name |
category | string | optional | Main category |
breadcrumbPath | string | optional | Full classification path |
price | number | optional | Current selling price (USD) |
approximate30DayUnitsSold | integer | optional | Estimated sales in the past 30 days |
approximate30DayRevenue | number | optional | Estimated revenue for the last 30 days (USD) |
productRank | integer | optional | BSR Ranking |
reviews | integer | optional | Total number of comments |
rating | number | optional | Average rating (1.0-5.0) |
listingQualityScore | integer | optional | Listing Quality Score (LQS, 1-10) |
numberOfSellers | integer | optional | Number of sellers on sale |
sellerType | string | optional | Seller type (amz/fba/fbm) |
imageUrl | string | optional | Product main image URL |
dateFirstAvailable | string | optional | Date first put on shelves |
weightValue | number | optional | Product weight |
weightUnit | string | optional | weight unit |
lengthValue | number | optional | length |
widthValue | number | optional | Width |
heightValue | number | optional | height |
dimensionsUnit | string | optional | Dimensional unit |
parentAsin | string | optional | Parent ASIN |
isParent | boolean | optional | Is it the parent body? |
isVariant | boolean | optional | Is it a variant? |
isStandalone | boolean | optional | Is it an independent product? |
isAvailable | boolean | optional | available for purchase |
buyBoxOwner | string | optional | Buy Box holds seller name |
buyBoxOwnerSellerId | string | optional | Buy Box holds seller ID |
updatedAt | string | optional | Data update time |
feeBreakdown | object | optional | Fee details: `fbaFee` (FBA fee), `referralFee` (referral fee), `variableClosingFee` (variable settlement fee), `totalFees` (total fee) |
subcategoryRanks | array | optional | Subcategory BSR ranking list, each containing `subcategory`, `rank`, `id` |
type | string | optional | Resource type |
variants | array | optional | Variation list |
upcList | array | optional | UPC code list |
eanList | array | optional | EAN code list |
isbnList | array | optional | ISBN code list |
gtinList | array | optional | GTIN code list |
dateFirstAvailableIsEstimated | boolean | optional | Is the release date an estimate? |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Find phone cases on Amazon US, sorted by sales.
Illustrative Response Explanation
The illustrative product “Example phone case” has approximately 300 units sold and 5,997 in revenue over 30 days, with a rating of 4.5. Revenue is not profit.
About this sample: Illustrative example only. Names, identifiers and numbers are fictional; no live tool call was made. Your results depend on your account, inputs and available data.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, 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-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_product_database",
"arguments": {
"includeKeywords": "phone case",
"marketplace": "us",
"needCount": 10,
"sort": "-sales"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-product-database-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"productDatabaseList\":[{\"id\":\"us/B000000001\",\"title\":\"Example phone case\",\"approximate30DayUnitsSold\":300,\"approximate30DayRevenue\":5997,\"rating\":4.5}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"productDatabaseList": [
{
"id": "us/B000000001",
"title": "Example phone case",
"approximate30DayUnitsSold": 300,
"approximate30DayRevenue": 5997,
"rating": 4.5
}
]
}
},
"isError": false
}
}