Amazon Intelligence SS
Amazon Competitor Lookup MCP
Compare competing Amazon products by sales, price, and growth. Call the Amazon Competitor Lookup API via REST or MCP with your Nexscope API key.
Amazon Competitor Lookup 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 Competing Products
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE].
2. Check A Historical Snapshot
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Use the available historical snapshot for [YEAR_MONTH]. Do not request a future month or present saved observations as live data.
3. Compare A List Of Competitors
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Restrict the comparison to [ASINS], no more than 40 product IDs.
4. Search An Exact Phrase
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Use phrase keyword matching.
5. Search A Broader Keyword Match
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Use fuzzy keyword matching.
6. Search An Exact Keyword Match
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Use exact keyword matching.
7. Review Several Result Pages
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Collect up to 3 pages for this research task. Request 10 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.
8. Search Within A Category
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Restrict the search to Amazon category [CATEGORY_NAME_OR_PATH].
9. Search A Category By Its ID
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Restrict the search to Amazon category ID path [CATEGORY_PATH].
10. Find A Seller’S Competing Products
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Keep results for seller [SELLER_NAME].
11. Find Products From A Brand
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Keep products from [BRAND].
12. Research Parent Products And Variations
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Use the [PARENT_PRODUCT_OR_VARIANT] view for the results.
13. Use The Latest Available Snapshot
Prompt: Find Amazon products competing with [KEYWORD] in [MARKETPLACE]. Use the latest available snapshot rather than a historical month. Keep the returned observation period explicit.
14. Prioritize Sales And Growth
Prompt: Find Amazon competitors matching [keyword] in [marketplace]. Rank the results by [monthly sales units, monthly sales revenue, monthly unit growth, monthly revenue growth, variant sales units] in [ascending or descending order]. Preserve the chosen metric and reporting period.
15. Prioritize Product Attributes
Prompt: Find Amazon competitors matching [keyword] in [marketplace]. Rank the results by [price, rating, review count, gross margin, review rate, listing date, Q&A count, monthly new reviews] in [ascending or descending order]. Preserve the chosen metric and reporting period.
16. Prioritize Category Ranking
Prompt: Find Amazon competitors matching [keyword] in [marketplace]. Rank the results by [BSR rank, seven-day BSR growth count, seven-day BSR growth rate] in [ascending or descending order]. Preserve the chosen metric and reporting period.
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_competitor_lookuphttps://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-competitor-lookup-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_competitor_lookup",
"arguments": {
"asinList": "B072MQ5BRX",
"keyword": "phone case",
"marketplace": "US",
"matchType": 1,
"page": 1,
"size": 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 |
|---|---|---|---|
marketplace | string | optional | Amazon site code, default US. Options: US, UK, DE, FR, JP, CA, IT, ES, MX, AU, TR, IN Example: US |
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. Example: phone case |
asinList | string | optional | ASINs, multiple ASINs comma-separated, max 40. Format: ^[A-Z0-9]+(,[A-Z0-9]+){0,39}$ Example: B072MQ5BRX |
sellerName | string | optional | Seller name filter |
brand | string | optional | Brand name filter |
nodeLabel | string | optional | Amazon category name, supports multi-level category names, levels separated by colon :, e.g. Electronics:Headphones |
nodeIdPath | string | optional | Amazon category ID path |
matchType | integer | optional | Match type. 1 = phrase match (default), 2 = fuzzy match, 3 = exact match Example: 1 |
showVariation | string | optional | Whether to query variants. Y = yes, N = no (default) |
dataSnapshotMonth | string | optional | Amazon product data snapshot month. Default nearly (queries last 30 days real-time data). Use yyyyMM format to query historical snapshots (e.g. 202412 for December 2024). Only supports existing historical snapshots, future dates are not supported. Recommended for seasonal analysis to query the same period last year's snapshot for comparison |
page | integer | optional | Page number, starting from 1 (default 1) Example: 1 |
size | integer | optional | Results per page, returns 10-100 records (default 50) Example: 50 |
order | object | optional | Sort configuration (see below) Example: {} |
order.field | string | optional | Sort field; required when order is supplied Example: total_units |
order.desc | string | optional | Sort direction true/false; required when order is supplied Example: true |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Total number of matching results |
sourceType | string | optional | Source type, such as `amazon` |
message | string | optional | Execution message or error description |
type | string | optional | rendering style |
nodeLabel | string | optional | Category name echo |
columns | array | optional | Rendered column definitions |
products | array | optional | Competing product list |
costToken | integer | optional | Consume token |
asin | string | optional | Product ASIN |
title | string | optional | Product title |
price | number | optional | current price |
primePrice | number | optional | Prime price |
averagePrice | number | optional | average price |
currency | string | optional | Currency |
monthlySalesUnits | integer | optional | Monthly sales volume (number of pieces) |
monthlySalesRevenue | number | optional | monthly sales |
monthlySalesUnitsGrowthRate | number | optional | monthly sales growth rate |
bsr | integer | optional | BSR Ranking |
bsrGrowthRate | number | optional | BSR growth rate |
bsrGrowthCount | integer | optional | BSR growth number |
rating | number | optional | Rating |
ratings | integer | optional | Rating number |
ratingsGrowth | integer | optional | Number of new ratings per month |
ratingsRate | number | optional | Review rate |
brand | string | optional | brand |
brandUrl | string | optional | Brand URL |
sellerName | string | optional | BuyBox seller name |
sellerId | string | optional | BuyBox seller ID |
sellerNation | string | optional | BuyBox seller nationality |
sellerNum | integer | optional | Number of sellers |
fulfillment | string | optional | Delivery method: `AMZ`, `FBA`, `FBM` |
availableDate | string | optional | Release time (date format) |
availableDateString | string | optional | Release date (string format) |
profit | number | optional | Gross profit margin |
fba | number | optional | FBA shipping |
deliveryPrice | number | optional | Seller shipping fee |
imageUrl | string | optional | Product image URL |
parent | string | optional | Parent ASIN |
variationNum | integer | optional | number of variants |
variant30DayUnits | integer | optional | Monthly sales volume of daughter bodies (number of pieces) |
variant30DayRevenue | number | optional | Subsidiary monthly sales |
variant30DayUpdatedAt | string | optional | Child data update time (timestamp) |
amzUnitDateString | string | optional | Sub-body sales update date |
listingQualityScore | number | optional | Listing quality score |
nodeLabelPath | string | optional | Category path |
nodeIdPath | string | optional | Node ID path |
nodeId | integer | optional | Node ID |
dimension | string | optional | Product size |
dimensionsType | string | optional | size type |
weight | string | optional | Product weight |
packageDimensions | string | optional | Packing size |
packageDimensionType | string | optional | Packaging size type |
packageWeight | string | optional | Packing weight |
sku | string | optional | SKU |
keyword | string | optional | matching keywords |
dataSnapshotMonth | string | optional | Data query month |
sourceType | string | optional | Source type |
badgeBestSeller | string | optional | Best Seller logo (Y/N) |
badgeAmazonChoice | string | optional | Amazon's Choice logo (Y/N) |
badgeNewRelease | string | optional | New Release logo (Y/N) |
badgeEbc | string | optional | A+ page identification (Y/N) |
badgeVideo | string | optional | Video introduction logo (Y/N) |
badge | object | optional | Identity details object, including `bestSeller`, `amazonChoice`, `newRelease`, `ebc`, `video` (all Y/N strings) |
subcategories | array | optional | Subcategory rankings, each including `code`, `rank`, `label` |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Find competing books for “mini split training manual” and show up to 15 results.
Example Answer
The published sample returns no products for this query. There are no returned competitors to compare, so it cannot support a conclusion about the size or competitiveness of this market.
About this sample: An empty sample is not proof that no competitors exist. Changing the query or requesting another page is a separate tool call.
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
{
"keyword": "mini split training manual",
"nodeLabel": "Books",
"size": 15
}Response
{
"code": 0,
"msg": null,
"data": {
"sourceType": "amazon",
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "asin",
"sortable": true,
"title": "asin"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌"
},
{
"filterable": true,
"cellType": "text",
"field": "brandUrl",
"sortable": true,
"title": "品牌URL"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "图片URL"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "parent",
"sortable": true,
"title": "父体ASIN"
},
{
"filterable": true,
"cellType": "number",
"field": "nodeId",
"sortable": true,
"title": "节点id"
},
{
"filterable": true,
"cellType": "text",
"field": "nodeIdPath",
"sortable": true,
"title": "节点id路径字符串"
},
{
"filterable": true,
"cellType": "text",
"field": "nodeLabelPath",
"sortable": true,
"title": "类目路径"
},
{
"filterable": true,
"cellType": "text",
"field": "bsrId",
"sortable": true,
"title": "BSR id"
},
{
"filterable": true,
"cellType": "number",
"field": "bsr",
"sortable": true,
"title": "BSR 排名"
},
{
"filterable": true,
"cellType": "number",
"field": "bsrGrowthRate",
"sortable": true,
"title": "BSR 增长率"
},
{
"filterable": true,
"cellType": "number",
"field": "bsrGrowthCount",
"sortable": true,
"title": "BSR 增长数"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "月销量"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnitsGrowthRate",
"sortable": true,
"title": "月销量增长率"
},
{
"filterable": true,
"cellType": "number",
"field": "variant30DayUnits",
"sortable": true,
"title": "子体月销量(件数)"
},
{
"filterable": true,
"cellType": "text",
"field": "variant30DayUpdatedAt",
"sortable": true,
"title": "子体数据更新时间(时间戳)"
},
{
"filterable": true,
"cellType": "number",
"field": "variant30DayRevenue",
"sortable": true,
"title": "子体月销售额(金额)"
},
{
"filterable": true,
"cellType": "text",
"field": "amzUnitDateString",
"sortable": true,
"title": "子体销量更新日期(时间戳)"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesRevenue",
"sortable": true,
"title": "月销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "价格"
},
{
"filterable": true,
"cellType": "number",
"field": "averagePrice",
"sortable": true,
"title": "平均价格"
},
{
"filterable": true,
"cellType": "number",
"field": "primePrice",
"sortable": true,
"title": "prime价格"
},
{
"filterable": true,
"cellType": "number",
"field": "profit",
"sortable": true,
"title": "利润率"
},
{
"filterable": true,
"cellType": "number",
"field": "fba",
"sortable": true,
"title": "fba运费"
},
{
"filterable": true,
"cellType": "number",
"field": "ratings",
"sortable": true,
"title": "评分数"
},
{
"filterable": true,
"cellType": "number",
"field": "ratingsRate",
"sortable": true,
"title": "留评率"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "评分"
},
{
"filterable": true,
"cellType": "number",
"field": "ratingsGrowth",
"sortable": true,
"title": "月度增长数"
},
{
"filterable": true,
"cellType": "number",
"field": "listingQualityScore",
"sortable": true,
"title": "listing质量得分"
},
{
"filterable": true,
"cellType": "text",
"field": "availableDate",
"sortable": true,
"title": "上架时间(日期)"
},
{
"filterable": true,
"cellType": "text",
"field": "availableDateString",
"sortable": true,
"title": "上架日期(日期字符串)"
},
{
"filterable": true,
"cellType": "text",
"field": "fulfillment",
"sortable": true,
"title": "配送方式(AMZ,FBA,FBM)"
},
{
"filterable": true,
"cellType": "number",
"field": "variationNum",
"sortable": true,
"title": "变体数"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerNum",
"sortable": true,
"title": "卖家数"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerId",
"sortable": true,
"title": "BuyBox卖家id"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerName",
"sortable": true,
"title": "BuyBox卖家"
},
{
"filterable": true,
"cellType": "text",
"field": "sellerNation",
"sortable": true,
"title": "BuyBox卖家国籍"
},
{
"filterable": true,
"cellType": "text",
"field": "badge",
"sortable": true,
"title": "Badge标识"
},
{
"filterable": true,
"cellType": "text",
"field": "weight",
"sortable": true,
"title": "重量"
},
{
"filterable": true,
"cellType": "text",
"field": "dimension",
"sortable": true,
"title": "尺寸"
},
{
"filterable": true,
"cellType": "text",
"field": "dimensionsType",
"sortable": true,
"title": "尺寸类型"
},
{
"filterable": true,
"cellType": "text",
"field": "packageDimensions",
"sortable": true,
"title": "包装尺寸"
},
{
"filterable": true,
"cellType": "text",
"field": "packageDimensionType",
"sortable": true,
"title": "包装尺寸类型"
},
{
"filterable": true,
"cellType": "text",
"field": "packageWeight",
"sortable": true,
"title": "包装重量"
},
{
"filterable": true,
"cellType": "text",
"field": "subcategories",
"sortable": true,
"title": "子类目"
},
{
"filterable": true,
"cellType": "text",
"field": "sku",
"sortable": true,
"title": "sku"
},
{
"filterable": true,
"cellType": "number",
"field": "deliveryPrice",
"sortable": true,
"title": "卖家运费"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "币种"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "来源类型：amazon"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "badgeBestSeller",
"sortable": true,
"title": "Best Seller标识(Y/N)"
},
{
"filterable": true,
"cellType": "text",
"field": "badgeAmazonChoice",
"sortable": true,
"title": "amazon choice标识(Y/N)"
},
{
"filterable": true,
"cellType": "text",
"field": "badgeNewRelease",
"sortable": true,
"title": "release标识(Y/N)"
},
{
"filterable": true,
"cellType": "text",
"field": "badgeEbc",
"sortable": true,
"title": "A+页面(Y/N)"
},
{
"filterable": true,
"cellType": "text",
"field": "badgeVideo",
"sortable": true,
"title": "视频介绍(Y/N)"
},
{
"filterable": true,
"cellType": "text",
"field": "dataSnapshotMonth",
"sortable": true,
"title": "数据查询月份"
},
{
"filterable": true,
"cellType": "text",
"field": "keyword",
"sortable": true,
"title": "对应筛选的关键词，如果有值，则表示这批数据是通过 这个关键词 keyword 搜索出来的"
}
],
"type": "productWorkbenches",
"nodeLabel": "Books",
"products": []
}
}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-competitor-lookup-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_competitor_lookup",
"arguments": {
"keyword": "mini split training manual",
"nodeLabel": "Books",
"size": 15
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-competitor-lookup-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"sourceType\":\"amazon\",\"nodeLabel\":\"Books\",\"products\":[]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"sourceType": "amazon",
"nodeLabel": "Books",
"products": []
}
},
"isError": false
}
}