Amazon Intelligence SS
Amazon Market Statistics MCP
Compare sales, prices, and ratings within an Amazon category. Call the Amazon Market Statistics API via REST or MCP with your Nexscope API key.
Amazon Market Statistics 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. Check Category Market Statistics
Prompt: Show market statistics for Amazon category [CATEGORY_PATH] in [MARKETPLACE].
2. Check A Historical Snapshot
Prompt: Show market statistics for Amazon category [CATEGORY_PATH] 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 Established And New Products
Prompt: Show market statistics for Amazon category [CATEGORY_PATH] in [MARKETPLACE]. Use the top [NUMBER_OF_LISTINGS] listings, and define new products as those launched within [MONTHS] months. Explain the returned statistics using those definitions.
4. Use The Latest Available Snapshot
Prompt: Show market statistics for Amazon category [CATEGORY_PATH] in [MARKETPLACE]. Use the latest available snapshot rather than a historical month. Keep the returned observation period explicit.
5. Compare Supported Marketplaces
Prompt: Run category statistics for [category node path] separately in the US, Japan, UK, Germany, France, Italy, Spain, Canada and India. Keep each marketplace and currency separate.
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_market_statisticshttps://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-market-statistics-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_statistics",
"arguments": {
"marketplace": "US",
"newProduct": 6,
"nodeIdPath": "1064954:1069242",
"topN": 10
}
}
}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 | Site code, see [marketplace](#marketplace-options) Example: US |
nodeIdPath | string | required | Node ID path string, e.g. 1064954:1069242:1069784:1069820:1069838:1069828 Example: 1064954:1069242 |
month | string | optional | Filter date: nearly or yyyyMM |
topN | integer | optional | Top Listing count (used for top-related metric definitions) Example: 10 |
newProduct | integer | optional | New product definition (months) Example: 6 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Total number of items |
marketplace | string | optional | Site encoding |
data | array | optional | List of statistical results (corresponding to third-party `data`) |
columns | array | optional | Rendered columns |
costToken | integer | optional | Consume token |
type | string | optional | rendering style |
nodeIdPath | string | optional | Node ID path |
nodeLabelPath | string | optional | Node name path |
nodeLabelLocale | string | optional | Node name translation |
nodeLabelPathLocale | string | optional | Node name path translation |
marketplace | string | optional | market sign |
countryCode | string | optional | Country 2 short code |
currency | string | optional | The currency type of this market |
totalProducts | integer | optional | Total number of items |
products | integer | optional | Number of sample items |
sellers | integer | optional | Number of sellers |
brands | integer | optional | Number of brands |
avgSellers | number | optional | Average number of sellers |
hlProducts | integer | optional | Number of samples of the top N products in the header Listing |
avgUnits | integer | optional | average monthly sales |
avgRevenue | number | optional | average monthly sales |
avgPrice | number | optional | average price |
avgRating | number | optional | average star rating |
avgRatings | integer | optional | average rating |
avgRatingsCv | integer | optional | Average number of comments per month |
avgBsr | integer | optional | Average BSR |
avgProfit | number | optional | average profit margin |
avgWeight | number | optional | Average weight (pound) |
baseAvgWeight | number | optional | Average weight (g) |
avgVolume | number | optional | Average volume (in³) |
baseAvgVolume | number | optional | Average volume (cm³) |
hlAvgUnits | integer | optional | The average monthly sales volume of the top N products in the header Listing |
hlAvgRevenue | number | optional | Average monthly sales of the top N products in the header Listing |
hlAvgPrice | number | optional | The average price of the top N items in the header Listing |
hlAvgRating | number | optional | Head Listing Average star rating of the top N products |
hlAvgRatings | integer | optional | Average number of reviews for the top N products in the head Listing |
hlAvgRatingsCv | integer | optional | The average number of monthly reviews of the top N products in the head Listing |
hlAvgBsr | integer | optional | Average BSR of the top N products in the head Listing |
newProducts | integer | optional | New product quantity |
newProductProportion | number | optional | New product quantity proportion |
newAvgUnits | integer | optional | Average monthly sales of new products |
newAvgRevenue | number | optional | Average monthly sales of new products |
newAvgPrice | number | optional | Average new product price |
newAvgRating | number | optional | Average star rating of new products |
newAvgRatings | integer | optional | Average rating of new products |
minNewRatings | integer | optional | Lowest new product rating |
maxNewRatings | integer | optional | Highest new product rating |
firstShelfDate | string | optional | Product first put on shelves date |
lastShelfDate | string | optional | Product latest shelf date |
Example Q&A
Based on a published documentation sample, not a live tool call.
Your Question
Compare the overall category with its top 20 products in the August 2026 US Standard Outlets snapshot.
Example Answer
The sample covers 100 products overall and 20 in the leading-product group. Average price is USD 27.42 overall versus USD 26.43 for that group; average rating is 4.6 in both groups.
About this sample: The comparison is limited to the returned category snapshot. Leading-product averages are not averages across every Amazon product.
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
{
"marketplace": "US",
"nodeIdPath": "228013:495266:495334:6291365011",
"topN": 20,
"month": "202608"
}Response
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"marketplace": "US",
"data": [
{
"hlAvgRating": 4.6,
"newAvgUnits": 1648,
"hlAvgUnits": 2837,
"avgPrice": 27.42,
"hlAvgBsr": 3272,
"maxNewRatings": 1352,
"nodeLabelPath": "工具与家居装修:Electrical:Outlets & Accessories:Standard Outlets",
"products": 100,
"newAvgRatings": 506,
"avgRevenue": 38124,
"avgRatingsCv": 42,
"avgRatings": 1364,
"hlAvgRatingsCv": 95,
"countryCode": "US",
"currency": "USD",
"avgRating": 4.6,
"hlAvgPrice": 26.43,
"lastShelfDate": "2026-08-24",
"hlAvgRatings": 3335,
"newProductProportion": 3,
"nodeLabelPathLocale": "工具:电气:输出设备:标准插座",
"brands": 25,
"marketplace": "US",
"avgVolume": 81.24,
"avgUnits": 1523,
"newAvgRevenue": 24332.84,
"baseAvgWeight": 552.42,
"firstShelfDate": "2011-03-31",
"avgProfit": 59.01,
"newAvgPrice": 16.89,
"newProducts": 3,
"baseAvgVolume": 1331.33,
"hlProducts": 20,
"newAvgRating": 4.4,
"minNewRatings": 114,
"avgSellers": 3.7,
"hlAvgRevenue": 75036.85,
"avgWeight": 1.2179,
"avgBsr": 17336,
"nodeIdPath": "228013:495266:495334:6291365011",
"sellers": 27
}
],
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "marketplace",
"sortable": true,
"title": "市场标志"
},
{
"filterable": true,
"cellType": "text",
"field": "currency",
"sortable": true,
"title": "该市场的货币类型"
},
{
"filterable": true,
"cellType": "text",
"field": "nodeIdPath",
"sortable": true,
"title": "节点ID路径"
},
{
"filterable": true,
"cellType": "text",
"field": "nodeLabelPath",
"sortable": true,
"title": "节点名称路径"
},
{
"filterable": true,
"cellType": "text",
"field": "nodeLabelLocale",
"sortable": true,
"title": "节点名称翻译"
},
{
"filterable": true,
"cellType": "text",
"field": "nodeLabelPathLocale",
"sortable": true,
"title": "节点名称路径翻译"
},
{
"filterable": true,
"cellType": "text",
"field": "countryCode",
"sortable": true,
"title": "国家二简码"
},
{
"filterable": true,
"cellType": "number",
"field": "totalProducts",
"sortable": true,
"title": "商品总数"
},
{
"filterable": true,
"cellType": "number",
"field": "products",
"sortable": true,
"title": "样品商品数"
},
{
"filterable": true,
"cellType": "number",
"field": "brands",
"sortable": true,
"title": "品牌数"
},
{
"filterable": true,
"cellType": "number",
"field": "sellers",
"sortable": true,
"title": "卖家数"
},
{
"filterable": true,
"cellType": "number",
"field": "avgBsr",
"sortable": true,
"title": "平均BSR"
},
{
"filterable": true,
"cellType": "number",
"field": "baseAvgVolume",
"sortable": true,
"title": "平均体积(cm³)"
},
{
"filterable": true,
"cellType": "number",
"field": "avgVolume",
"sortable": true,
"title": "平均体积(in³)"
},
{
"filterable": true,
"cellType": "number",
"field": "baseAvgWeight",
"sortable": true,
"title": "平均重量(g)"
},
{
"filterable": true,
"cellType": "number",
"field": "avgWeight",
"sortable": true,
"title": "平均重量(pound)"
},
{
"filterable": true,
"cellType": "number",
"field": "avgProfit",
"sortable": true,
"title": "平均利润率"
},
{
"filterable": true,
"cellType": "number",
"field": "avgUnits",
"sortable": true,
"title": "月均销量"
},
{
"filterable": true,
"cellType": "number",
"field": "avgRevenue",
"sortable": true,
"title": "月均销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "avgPrice",
"sortable": true,
"title": "平均价格"
},
{
"filterable": true,
"cellType": "number",
"field": "avgRatingsCv",
"sortable": true,
"title": "月评论平均增长数"
},
{
"filterable": true,
"cellType": "number",
"field": "avgRatings",
"sortable": true,
"title": "平均评分数"
},
{
"filterable": true,
"cellType": "number",
"field": "avgRating",
"sortable": true,
"title": "平均星级"
},
{
"filterable": true,
"cellType": "number",
"field": "avgSellers",
"sortable": true,
"title": "平均卖家数"
},
{
"filterable": true,
"cellType": "number",
"field": "hlProducts",
"sortable": true,
"title": "头部Listing前N名商品样本数"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgBsr",
"sortable": true,
"title": "头部Listing前N名商品平均BSR"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgUnits",
"sortable": true,
"title": "头部Listing前N名商品月均销量"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgRevenue",
"sortable": true,
"title": "头部Listing前N名商品月均销售额"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgPrice",
"sortable": true,
"title": "头部Listing前N名商品平均价格"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgRatingsCv",
"sortable": true,
"title": "头部Listing前N名商品月评论平均增长数"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgRatings",
"sortable": true,
"title": "头部Listing前N名商品平均评论数"
},
{
"filterable": true,
"cellType": "number",
"field": "hlAvgRating",
"sortable": true,
"title": "头部Listing前N名商品平均星级"
},
{
"filterable": true,
"cellType": "number",
"field": "newProducts",
"sortable": true,
"title": "新品数量"
},
{
"filterable": true,
"cellType": "number",
"field": "newProductProportion",
"sortable": true,
"title": "新品数量占比"
},
{
"filterable": true,
"cellType": "number",
"field": "newAvgPrice",
"sortable": true,
"title": "新品平均价格"
},
{
"filterable": true,
"cellType": "number",
"field": "newAvgRatings",
"sortable": true,
"title": "新品平均评分数"
},
{
"filterable": true,
"cellType": "number",
"field": "minNewRatings",
"sortable": true,
"title": "最低新品评分数"
},
{
"filterable": true,
"cellType": "number",
"field": "maxNewRatings",
"sortable": true,
"title": "最高新品评分数"
},
{
"filterable": true,
"cellType": "number",
"field": "newAvgRating",
"sortable": true,
"title": "新品平均星级"
},
{
"filterable": true,
"cellType": "number",
"field": "newAvgUnits",
"sortable": true,
"title": "新品月均销量"
},
{
"filterable": true,
"cellType": "number",
"field": "newAvgRevenue",
"sortable": true,
"title": "新品月均销售额"
},
{
"filterable": true,
"cellType": "text",
"field": "firstShelfDate",
"sortable": true,
"title": "商品首次上架日期"
},
{
"filterable": true,
"cellType": "text",
"field": "lastShelfDate",
"sortable": true,
"title": "商品最新上架日期"
}
],
"type": "tableListWorkbenches"
}
}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-market-statistics-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_statistics",
"arguments": {
"marketplace": "US",
"nodeIdPath": "228013:495266:495334:6291365011",
"topN": 20,
"month": "202608"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-market-statistics-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"marketplace\":\"US\",\"data\":[{\"hlAvgRating\":4.6,\"newAvgUnits\":1648,\"hlAvgUnits\":2837,\"avgPrice\":27.42,\"hlAvgBsr\":3272,\"maxNewRatings\":1352,\"nodeLabelPath\":\"工具与家居装修:Electrical:Outlets & Accessories:Standard Outlets\",\"products\":100,\"newAvgRatings\":506,\"avgRevenue\":38124,\"avgRatingsCv\":42,\"avgRatings\":1364,\"hlAvgRatingsCv\":95,\"countryCode\":\"US\",\"currency\":\"USD\",\"avgRating\":4.6,\"hlAvgPrice\":26.43,\"lastShelfDate\":\"2026-08-24\",\"hlAvgRatings\":3335,\"newProductProportion\":3,\"nodeLabelPathLocale\":\"工具:电气:输出设备:标准插座\",\"brands\":25,\"marketplace\":\"US\",\"avgVolume\":81.24,\"avgUnits\":1523,\"newAvgRevenue\":24332.84,\"baseAvgWeight\":552.42,\"firstShelfDate\":\"2011-03-31\",\"avgProfit\":59.01,\"newAvgPrice\":16.89,\"newProducts\":3,\"baseAvgVolume\":1331.33,\"hlProducts\":20,\"newAvgRating\":4.4,\"minNewRatings\":114,\"avgSellers\":3.7,\"hlAvgRevenue\":75036.85,\"avgWeight\":1.2179,\"avgBsr\":17336,\"nodeIdPath\":\"228013:495266:495334:6291365011\",\"sellers\":27}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"marketplace": "US",
"data": [
{
"hlAvgRating": 4.6,
"newAvgUnits": 1648,
"hlAvgUnits": 2837,
"avgPrice": 27.42,
"hlAvgBsr": 3272,
"maxNewRatings": 1352,
"nodeLabelPath": "工具与家居装修:Electrical:Outlets & Accessories:Standard Outlets",
"products": 100,
"newAvgRatings": 506,
"avgRevenue": 38124,
"avgRatingsCv": 42,
"avgRatings": 1364,
"hlAvgRatingsCv": 95,
"countryCode": "US",
"currency": "USD",
"avgRating": 4.6,
"hlAvgPrice": 26.43,
"lastShelfDate": "2026-08-24",
"hlAvgRatings": 3335,
"newProductProportion": 3,
"nodeLabelPathLocale": "工具:电气:输出设备:标准插座",
"brands": 25,
"marketplace": "US",
"avgVolume": 81.24,
"avgUnits": 1523,
"newAvgRevenue": 24332.84,
"baseAvgWeight": 552.42,
"firstShelfDate": "2011-03-31",
"avgProfit": 59.01,
"newAvgPrice": 16.89,
"newProducts": 3,
"baseAvgVolume": 1331.33,
"hlProducts": 20,
"newAvgRating": 4.4,
"minNewRatings": 114,
"avgSellers": 3.7,
"hlAvgRevenue": 75036.85,
"avgWeight": 1.2179,
"avgBsr": 17336,
"nodeIdPath": "228013:495266:495334:6291365011",
"sellers": 27
}
]
}
},
"isError": false
}
}