Inteligencia de Amazon SS
API de estadísticas de mercado de Amazon MCP
Compare ventas, precios y valoraciones dentro de una categoría Amazon. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.
Prompts y casos de uso de API de estadísticas de mercado de Amazon
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Estadísticas de mercado de categoría
Prompt: Mostrar estadísticas de mercado para la categoría Amazon [CATEGORY_PATH] dentro [MARKETPLACE].
2. Compruebe una instantánea histórica
Prompt: Mostrar estadísticas de mercado para la categoría Amazon [CATEGORY_PATH] dentro [MARKETPLACE]. Use la instantánea histórica disponible para [YEAR_MONTH]. No solicite un mes futuro o presente observaciones guardadas como datos en vivo.
3. Comparar productos establecidos y nuevos
Prompt: Mostrar estadísticas de mercado para la categoría Amazon [CATEGORY_PATH] dentro [MARKETPLACE]. Use la parte superior [NUMBER_OF_LISTINGS] listados, y definir nuevos productos como los lanzados dentro [MONTHS] meses. Explicar las estadísticas devueltas utilizando esas definiciones.
4. Utilice la última instantánea disponible
Prompt: Mostrar estadísticas de mercado para la categoría Amazon [CATEGORY_PATH] dentro [MARKETPLACE]. Utilice la última instantánea disponible en lugar de un mes histórico. Mantenga el período de observación devuelto explícito.
5. Comparación de Mercados de apoyo
Prompt: Estadísticas de categoría de ejecución [category node path] por separado USJapón, UKAlemania, Francia, Italia, España, Canadá e India. Mantenga cada mercado y moneda separada.
Qué debes proporcionar
Sustituye los marcadores entre corchetes por tus propios datos de investigación. Indica expresamente las estimaciones de la fuente, los períodos de los informes y la información que falte.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_amazon_market_statisticshttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa 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 HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
marketplace | string | obligatorio | Código del sitio, ver [marketplace](# marketplace-options) Ejemplo: US |
nodeIdPath | string | obligatorio | Node ID cuerda del camino, e.g. 1064954:1069242:1069784:1069820:1069838:1069828 Ejemplo: 1064954:1069242 |
month | string | opcional | Fecha de filtro: casi o yyyyMM |
topN | integer | opcional | Conteo de lista superior (utilizado para las definiciones métricas de primer nivel) Ejemplo: 10 |
newProduct | integer | opcional | Nueva definición de producto (meses) Ejemplo: 6 |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de artículos |
marketplace | string | opcional | Codificación del sitio |
data | array | opcional | Lista de resultados estadísticos (correspondiente a terceros) `data`) |
columns | array | opcional | Rendered columns |
costToken | integer | opcional | Consume token |
type | string | opcional | estilo de renderización |
nodeIdPath | string | opcional | Node ID sendero |
nodeLabelPath | string | opcional | Node name path |
nodeLabelLocale | string | opcional | Node name translation |
nodeLabelPathLocale | string | opcional | Node name path translation |
marketplace | string | opcional | signo de mercado |
countryCode | string | opcional | País 2 código corto |
currency | string | opcional | El tipo de moneda de este mercado |
totalProducts | integer | opcional | Número total de artículos |
products | integer | opcional | Número de elementos de muestra |
sellers | integer | opcional | Número de vendedores |
brands | integer | opcional | Número de marcas |
avgSellers | number | opcional | Número medio de vendedores |
hlProducts | integer | opcional | Número de muestras de los principales productos N en la lista de encabezados |
avgUnits | integer | opcional | promedio de ventas mensuales |
avgRevenue | number | opcional | promedio de ventas mensuales |
avgPrice | number | opcional | precio promedio |
avgRating | number | opcional | promedio de la estrella |
avgRatings | integer | opcional | promedio |
avgRatingsCv | integer | opcional | Número medio de comentarios por mes |
avgBsr | integer | opcional | Promedio BSR |
avgProfit | number | opcional | margen medio de ganancia |
avgWeight | number | opcional | Peso medio (pound) |
baseAvgWeight | number | opcional | Peso medio (g) |
avgVolume | number | opcional | Volumen medio (in3) |
baseAvgVolume | number | opcional | Volumen medio (cm3) |
hlAvgUnits | integer | opcional | El volumen promedio mensual de ventas de los productos N más altos en la lista de encabezados |
hlAvgRevenue | number | opcional | Promedio de ventas mensuales de los mejores productos N en la lista de encabezados |
hlAvgPrice | number | opcional | El precio promedio de los artículos N superior en el encabezado Listado |
hlAvgRating | number | opcional | Listado de cabeza Promedio de la calificación de estrella de los productos N superior |
hlAvgRatings | integer | opcional | Número medio de comentarios para los principales productos N en la lista de cabeza |
hlAvgRatingsCv | integer | opcional | El número medio de exámenes mensuales de los principales productos N en la lista de cabeza |
hlAvgBsr | integer | opcional | Promedio BSR de los mejores productos N en la cabeza |
newProducts | integer | opcional | Nueva cantidad de producto |
newProductProportion | number | opcional | Nueva proporción de la cantidad de productos |
newAvgUnits | integer | opcional | Promedio mensual de ventas de nuevos productos |
newAvgRevenue | number | opcional | Promedio mensual de ventas de nuevos productos |
newAvgPrice | number | opcional | Promedio nuevo precio del producto |
newAvgRating | number | opcional | Nota media de estrellas de nuevos productos |
newAvgRatings | integer | opcional | Nota media de nuevos productos |
minNewRatings | integer | opcional | Valoración de producto más baja |
maxNewRatings | integer | opcional | Alta nueva calificación de producto |
firstShelfDate | string | opcional | Producto primero puesto en la fecha de estantes |
lastShelfDate | string | opcional | Producto más reciente fecha de estante |
Preguntas y respuestas de ejemplo
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
Tu pregunta
Compare la categoría general con sus 20 mejores productos en agosto 2026 US Estandar Outlets instantánea.
Respuesta de ejemplo
La muestra cubre 100 productos en general y 20 en el grupo de productos líderes. Precio medio es USD 27.42 en general contra USD 26.43 para ese grupo; la puntuación media es de 4.6 en ambos grupos.
Sobre esta muestra: La comparación se limita a la instantánea de categoría devuelta. Los promedios de productos derivados no son promedios en cada producto de Amazon.
Ver los datos de ejemplo publicados (JSON)
Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.
Ejemplo de datos
Ejemplo de solicitud y respuesta
Parámetros de solicitud
{
"marketplace": "US",
"nodeIdPath": "228013:495266:495334:6291365011",
"topN": 20,
"month": "202608"
}Respuesta
{
"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"
}
}Ver el formato de solicitud y respuesta MCP
Ejemplos
Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"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"
}
}
}Formato de respuesta MCP
{
"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
}
}