Investigación de Amazon ST
API de detalles de productos del mercado de Amazon MCP
Buscar detalles del producto y tendencias históricas ASIN. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.
CosteRecent Avg. 17 · Range 13–113 créditos por llamadaPrueba en línea
Prompts y casos de uso de API de detalles de productos del 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. Buscar detalles del producto
Prompt: Buscar hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE] y resumir los detalles de sus productos devueltos.
2. Compruebe las tendencias del producto
Prompt: Buscar hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE] y resumir los detalles de sus productos devueltos. Incluye los datos de tendencias disponibles de [START_DATE] a [END_DATE]. Un rango superior a 15 días tiene un costo documentado diferente; comprobarlo antes de solicitarlo.
3. Obtener detalles sin datos de tendencia
Prompt: Buscar hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE] y resumir los detalles de sus productos devueltos. Volver detalles del producto sin las tendencias históricas opcionales.
4. Comparar historias de productos
Prompt: Compara hasta 10 productos Amazon [ASINS] dentro [MARKETPLACE] sobre [START_DATE] a través de [END_DATE] usando sus tendencias devueltas. Compruebe el costo adicional si el período excede los 15 días.
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
Nombre de la herramienta MCP
nexscope_amazon_market_product_detailPunto de conexión MCP
https://api.nexscope.ai/mcpMétodo JSON-RPC
tools/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-product-detail-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_product_detail",
"arguments": {
"asin": "B072MQ5BRX",
"includeTrend": 1,
"marketplace": "us",
"queryTrendEndDate": "2026-01-15",
"queryTrendStartDate": "2026-01-01"
}
}
}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 |
|---|---|---|---|
asin | string | obligatorio | Número de identificación estándar de Amazon (ASIN), soporta múltiples (max 10), separados por coma. Ejemplo: B0088PUEPK o B0088PUEPK,B00U26V4VQ Ejemplo: B072MQ5BRX |
marketplace | string | obligatorio | Amazon site code: us, gb, de, fr, in, ca, jp, es, it, mx, ae, au, br, sa Ejemplo: us |
includeTrend | integer | opcional | Ya sea para incluir datos de tendencia. 1: incluir (por defecto); 2: excluir Ejemplo: 1 |
queryTrendStartDate | string | opcional | Fecha de inicio de moda, formato yyyy-MM-dd. Default regresa sólo los últimos 15 días; consultando más de 15 días duplica el costo Ejemplo: 2026-01-01 |
queryTrendEndDate | string | opcional | Fecha final de moda, formato yyyyy-MM- No. Ejemplo: 2026-01-15 |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | opcional | Código de respuesta, `200` indica éxito. |
msg | string | opcional | Responde al mensaje. |
total | integer | opcional | Número total de resultados. |
costTime | integer | opcional | Tiempo tomado, unidad ms. |
costToken | integer | opcional | El número de fichas consumidas. |
requestConsumed | integer | opcional | El número de solicitudes consumidas. |
sourceType | string | opcional | Tipo fuente, valor es `st`. |
type | string | opcional | Rendering estilo. |
columns | array | opcional | Render la columna. |
products | array | opcional | Lista de detalles del producto; campos de elementos se muestran en la tabla siguiente. |
asin | string | opcional | ASIN。 |
title | string | opcional | Título del producto. |
brand | string | opcional | Brand. |
asinUrl | string | opcional | Amazon Lista página de detalles URL. |
imageUrl | string | opcional | Imagen principal URL. |
productImageUrls | array | opcional | Toda la imagen del producto URLs. |
ebcPhoto | array | opcional | Lista de imágenes A+. |
storeName | string | opcional | Nombre de la tienda. |
description | string | opcional | Cinco puntos de descripción. |
productBadge | array | opcional | Logos de productos como Amazon Choice, Best Seller, New Release. |
lastUpdate | string | opcional | ASIN data latest collection time, formato `yyyy-MM-dd`. |
offSale | boolean | opcional | Ya sea para quitarlo de los estantes, `true` indica que no está en venta. |
productType | string | opcional | Amazon producto categoría nodo nombre. |
weight | string | opcional | Peso, unidad g. |
size | array | opcional | Dimensiones del embalaje/envase exterior `[longest side, second longest side, shortest side]`, unidad cm. |
parentAsin | string | opcional | Parent ASIN; `null` si no hay hijo. |
variationNum | integer | opcional | Número de variantes. |
variationASIN | array | opcional | Lista de descendientes ASINs. |
attribute | array | opcional | Propiedad infantil; elemento que contiene `asin`, `name`, `value`. |
price | number | opcional | Precio de venta real después de deducir cupones, en moneda local. |
coupon | integer | opcional | Política de cupón; valor no negativo es la cantidad de descuento (como `500` significa $5), el valor negativo es el porcentaje de descuento (como `-10` significa 10% de descuento). |
platformFee | number | opcional | Comisión de Plataforma, en moneda local. |
fbaFees | number | opcional | FBA tarifas en moneda local. |
fbaDetail | array | opcional | FBA detalles; el primer artículo es la cuota de entrega, seguido de la cuota de almacenamiento mensual. |
shipCost | number | opcional | FBM pago en moneda local. |
shipsFrom | string | opcional | Parte de envío. |
profitAmount | number | opcional | Profit, calculado como precio recibido - FBA comisión, en moneda local. |
profitRate | number | opcional | margen de ganancia, por ejemplo `25.83` significa 25.83%. |
monthlySalesUnits | integer | opcional | El volumen oficial de ventas mensuales ASIN anunciado por Amazon es el último valor para los últimos 7 días calendario. Si no hay datos, es 0. |
salesRank | integer | opcional | BSR clasificación de categoría. |
category | array | opcional | Categoría `[category name, NodeId]`. |
bsrCategory | array | opcional | Lista de clasificación de categorías pequeñas, los elementos incluyen `nodeId`, `name`, `rank`, `date` (`yyyyMMdd`). |
availableDate | string | opcional | Tiempo de estante, formato `yyyy-MM-dd`. |
onlineDays | integer | opcional | Número de días en estante. |
rating | number | opcional | Valoración actual, rango 0.0-5.0. |
ratings | integer | opcional | Número de valoraciones. |
fiveStarRatings | number | opcional | ratio 5 estrellas, unidad es porcentaje. |
fourStarRatings | number | opcional | Relación de 4 estrellas, unidad es porcentaje. |
threeStarRatings | number | opcional | Relación de 3 estrellas, unidad es porcentaje. |
twoStarRatings | number | opcional | 2 Star ratio, unidad es porcentaje. |
oneStarRatings | number | opcional | ratio de 1 estrella, unidad es porcentaje. |
buyboxSeller | string | opcional | Nombre del vendedor de la caja. |
buyBoxSellerId | string | opcional | vendedor de caja ID. |
buyboxSellerAddress | string | opcional | El código de dos dígitos del country/region donde se encuentra el vendedor de Buybox; cuando Amazon es autooperado, es `null`. |
isFBA | boolean | opcional | Do Buybox vendedores uso FBA. |
sellerNum | integer | opcional | Número de vendedores. |
aPlus | boolean | opcional | A+ o no. |
hasVideo | boolean | opcional | Hay un video. |
hasBrandStore | boolean | opcional | ¿Hay una tienda de marcas? |
feature | object | opcional | Características del producto y clasificaciones de estrellas correspondientes. |
productInfo | object | opcional | Lista de datos estructurados de información central sobre productos. |
property | object | opcional | Lista de propiedades y descripción por encima de Puntos de Bala. |
brandPromotion | string | opcional | Promoción de marca. |
dealType | string | opcional | Traje. |
extraSavings | array | opcional | Promociones de afiliados. |
rankTrend | array | opcional | BSR tendencias de clasificación de la categoría, formato estancado `[date, ranking, ...]`. |
bsrRankTrend | array | opcional | Pequeña categoría de tendencia, formato `[{NodeId: xxx, Rank: [date, ranking, ...]}]`. |
listingSalesVolumeOfDailyTrend | array | opcional | Tendencia de ventas diarias; `-1` no se puede estimar. |
listingSalesOfDailyTrend | array | opcional | Tendencia de ventas diarias, la unidad es la unidad más pequeña de la moneda local; `-1` significa que no puede ser estimado. |
listingSalesVolumeOfMonthTrend | array | opcional | Tendencia mensual de ventas en los últimos 30 días; `-1` dijo que no se puede predecir. |
listingSalesOfMonthTrend | array | opcional | Tendencias mensuales de ventas en la unidad más pequeña de la moneda local. |
priceTrend | array | opcional | La tendencia de venta de precios, antes de que los cupones sean deducidos, la unidad es la unidad más pequeña de la moneda local; `-1` significa que no hay precio disponible en ese día. |
listPriceTrend | array | opcional | Subrayando la historia original del precio, la unidad es la unidad más pequeña de la moneda local; `-1` significa que no hay precio disponible en ese día. |
dealTrend | array | opcional | tendencia al trato, `1` significa que hay un trato, `0` significa que no hay trato. |
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
Compruebe los detalles y las tendencias disponibles para ASIN B0DKJGS69C en Amazon US.
Respuesta de ejemplo
La muestra devuelve un registro de producto identificado como #B0DKJGS69C, con valores cero por precio, calificación, rango de ventas y unidades de ventas mensuales. No proporciona suficiente información usable para evaluar este producto o describir una tendencia de ventas.
Sobre esta muestra: No trate los campos de muestra llenos de cero como ventas cero verificadas o un producto libre. El identificador devuelto también contiene un # líder, así que verifique el ASIN antes del análisis.
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
{
"asin": "B0DKJGS69C",
"marketplace": "us",
"includeTrend": 2
}Respuesta
{
"code": 0,
"msg": null,
"data": {
"total": 1,
"costTime": 3976,
"sourceType": "sorftime",
"columns": [
{
"filterable": true,
"cellType": "text",
"field": "sourceType",
"sortable": true,
"title": "来源类型"
},
{
"filterable": true,
"cellType": "text",
"field": "sourceTool",
"sortable": true,
"title": "来源工具"
},
{
"filterable": true,
"cellType": "text",
"field": "asin",
"sortable": true,
"title": "ASIN"
},
{
"filterable": true,
"cellType": "text",
"field": "asinUrl",
"sortable": true,
"title": "商品链接"
},
{
"filterable": true,
"cellType": "text",
"field": "title",
"sortable": true,
"title": "商品标题"
},
{
"filterable": true,
"cellType": "text",
"field": "productImageUrls",
"sortable": true,
"title": "主图列表"
},
{
"filterable": true,
"cellType": "text",
"field": "imageUrl",
"sortable": true,
"title": "主图"
},
{
"filterable": true,
"cellType": "text",
"field": "ebcPhoto",
"sortable": true,
"title": "A+图片"
},
{
"filterable": true,
"cellType": "text",
"field": "storeName",
"sortable": true,
"title": "店铺名称"
},
{
"filterable": true,
"cellType": "text",
"field": "description",
"sortable": true,
"title": "五点描述"
},
{
"filterable": true,
"cellType": "text",
"field": "productBadge",
"sortable": true,
"title": "产品标志"
},
{
"filterable": true,
"cellType": "text",
"field": "lastUpdate",
"sortable": true,
"title": "更新时间"
},
{
"filterable": true,
"cellType": "number",
"field": "monthlySalesUnits",
"sortable": true,
"title": "官方月销量"
},
{
"filterable": true,
"cellType": "text",
"field": "listingSalesVolumeOfDailyTrend",
"sortable": true,
"title": "日销量趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "listingSalesOfDailyTrend",
"sortable": true,
"title": "日销售额趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "listingSalesVolumeOfMonthTrend",
"sortable": true,
"title": "月销量趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "listingSalesOfMonthTrend",
"sortable": true,
"title": "月销售额趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "rankTrend",
"sortable": true,
"title": "BSR趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "bsrRankTrend",
"sortable": true,
"title": "小类排名趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "dealTrend",
"sortable": true,
"title": "Deal趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "offSale",
"sortable": true,
"title": "是否下架"
},
{
"filterable": true,
"cellType": "text",
"field": "parentAsin",
"sortable": true,
"title": "父ASIN"
},
{
"filterable": true,
"cellType": "text",
"field": "variationASIN",
"sortable": true,
"title": "子体ASIN列表"
},
{
"filterable": true,
"cellType": "text",
"field": "attribute",
"sortable": true,
"title": "产品属性"
},
{
"filterable": true,
"cellType": "number",
"field": "variationNum",
"sortable": true,
"title": "变体数"
},
{
"filterable": true,
"cellType": "text",
"field": "priceTrend",
"sortable": true,
"title": "售价趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "listPriceTrend",
"sortable": true,
"title": "原价趋势"
},
{
"filterable": true,
"cellType": "text",
"field": "productType",
"sortable": true,
"title": "分类"
},
{
"filterable": true,
"cellType": "number",
"field": "coupon",
"sortable": true,
"title": "Coupon政策"
},
{
"filterable": true,
"cellType": "number",
"field": "price",
"sortable": true,
"title": "销售价"
},
{
"filterable": true,
"cellType": "text",
"field": "brand",
"sortable": true,
"title": "品牌"
},
{
"filterable": true,
"cellType": "text",
"field": "buyboxSeller",
"sortable": true,
"title": "Buybox卖家"
},
{
"filterable": true,
"cellType": "text",
"field": "buyBoxSellerId",
"sortable": true,
"title": "Buybox卖家ID"
},
{
"filterable": true,
"cellType": "text",
"field": "buyboxSellerAddress",
"sortable": true,
"title": "卖家所在地"
},
{
"filterable": true,
"cellType": "text",
"field": "isFBA",
"sortable": true,
"title": "是否FBA"
},
{
"filterable": true,
"cellType": "number",
"field": "shipCost",
"sortable": true,
"title": "FBM配送费"
},
{
"filterable": true,
"cellType": "text",
"field": "shipsFrom",
"sortable": true,
"title": "发货方"
},
{
"filterable": true,
"cellType": "number",
"field": "fbaFees",
"sortable": true,
"title": "FBA费用"
},
{
"filterable": true,
"cellType": "text",
"field": "fbaDetail",
"sortable": true,
"title": "FBA明细"
},
{
"filterable": true,
"cellType": "number",
"field": "platformFee",
"sortable": true,
"title": "平台佣金"
},
{
"filterable": true,
"cellType": "number",
"field": "profitAmount",
"sortable": true,
"title": "利润"
},
{
"filterable": true,
"cellType": "number",
"field": "profitRate",
"sortable": true,
"title": "利润率"
},
{
"filterable": true,
"cellType": "text",
"field": "availableDate",
"sortable": true,
"title": "上架时间"
},
{
"filterable": true,
"cellType": "number",
"field": "onlineDays",
"sortable": true,
"title": "上架天数"
},
{
"filterable": true,
"cellType": "number",
"field": "rating",
"sortable": true,
"title": "当前评分（0"
},
{
"filterable": true,
"cellType": "number",
"field": "ratings",
"sortable": true,
"title": "评分数量"
},
{
"filterable": true,
"cellType": "number",
"field": "oneStarRatings",
"sortable": true,
"title": "1星占比"
},
{
"filterable": true,
"cellType": "number",
"field": "twoStarRatings",
"sortable": true,
"title": "2星占比"
},
{
"filterable": true,
"cellType": "number",
"field": "threeStarRatings",
"sortable": true,
"title": "3星占比"
},
{
"filterable": true,
"cellType": "number",
"field": "fourStarRatings",
"sortable": true,
"title": "4星占比"
},
{
"filterable": true,
"cellType": "number",
"field": "fiveStarRatings",
"sortable": true,
"title": "5星占比"
},
{
"filterable": true,
"cellType": "text",
"field": "category",
"sortable": true,
"title": "大类"
},
{
"filterable": true,
"cellType": "text",
"field": "bsrCategory",
"sortable": true,
"title": "小类排名列表"
},
{
"filterable": true,
"cellType": "number",
"field": "salesRank",
"sortable": true,
"title": "BSR排名"
},
{
"filterable": true,
"cellType": "number",
"field": "sellerNum",
"sortable": true,
"title": "卖家数"
},
{
"filterable": true,
"cellType": "text",
"field": "hasVideo",
"sortable": true,
"title": "有视频"
},
{
"filterable": true,
"cellType": "text",
"field": "aPlus",
"sortable": true,
"title": "有A+"
},
{
"filterable": true,
"cellType": "text",
"field": "hasBrandStore",
"sortable": true,
"title": "有品牌店"
},
{
"filterable": true,
"cellType": "text",
"field": "size",
"sortable": true,
"title": "尺寸"
},
{
"filterable": true,
"cellType": "text",
"field": "weight",
"sortable": true,
"title": "重量"
},
{
"filterable": true,
"cellType": "text",
"field": "extraSavings",
"sortable": true,
"title": "关联促销"
},
{
"filterable": true,
"cellType": "text",
"field": "feature",
"sortable": true,
"title": "产品特性星级"
},
{
"filterable": true,
"cellType": "text",
"field": "productInfo",
"sortable": true,
"title": "产品信息"
},
{
"filterable": true,
"cellType": "text",
"field": "property",
"sortable": true,
"title": "属性列表"
},
{
"filterable": true,
"cellType": "text",
"field": "brandPromotion",
"sortable": true,
"title": "品牌促销"
},
{
"filterable": true,
"cellType": "text",
"field": "dealType",
"sortable": true,
"title": "Deal标签"
}
],
"type": "productWorkbenches",
"requestConsumed": 1,
"products": [
{
"sellerNum": 0,
"variationNum": 0,
"profitAmount": 0,
"threeStarRatings": 0,
"rating": 0,
"platformFee": 0,
"shipCost": 0,
"hasBrandStore": false,
"sourceTool": "sorftime-亚马逊产品详情(含趋势)",
"price": 0,
"ratings": 0,
"onlineDays": 0,
"fbaFees": 0,
"salesRank": 0,
"hasVideo": false,
"coupon": 0,
"isFBA": false,
"weight": "0.0",
"profitRate": 0,
"fiveStarRatings": 0,
"asinUrl": "https://www.amazon.com/dp/#B0DKJGS69C",
"offSale": false,
"twoStarRatings": 0,
"fourStarRatings": 0,
"sourceType": "sorftime",
"oneStarRatings": 0,
"asin": "#B0DKJGS69C",
"monthlySalesUnits": 0
}
]
}
}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-product-detail-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_market_product_detail",
"arguments": {
"asin": "B0DKJGS69C",
"marketplace": "us",
"includeTrend": 2
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "amazon-market-product-detail-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"sourceType\":\"sorftime\",\"requestConsumed\":1,\"products\":[{\"sellerNum\":0,\"variationNum\":0,\"profitAmount\":0,\"threeStarRatings\":0,\"rating\":0,\"platformFee\":0,\"shipCost\":0,\"hasBrandStore\":false,\"sourceTool\":\"sorftime-亚马逊产品详情(含趋势)\",\"price\":0,\"ratings\":0,\"onlineDays\":0,\"fbaFees\":0,\"salesRank\":0,\"hasVideo\":false,\"coupon\":0,\"isFBA\":false,\"weight\":\"0.0\",\"profitRate\":0,\"fiveStarRatings\":0,\"asinUrl\":\"https://www.amazon.com/dp/#B0DKJGS69C\",\"offSale\":false,\"twoStarRatings\":0,\"fourStarRatings\":0,\"sourceType\":\"sorftime\",\"oneStarRatings\":0,\"asin\":\"#B0DKJGS69C\",\"monthlySalesUnits\":0}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"sourceType": "sorftime",
"requestConsumed": 1,
"products": [
{
"sellerNum": 0,
"variationNum": 0,
"profitAmount": 0,
"threeStarRatings": 0,
"rating": 0,
"platformFee": 0,
"shipCost": 0,
"hasBrandStore": false,
"sourceTool": "sorftime-亚马逊产品详情(含趋势)",
"price": 0,
"ratings": 0,
"onlineDays": 0,
"fbaFees": 0,
"salesRank": 0,
"hasVideo": false,
"coupon": 0,
"isFBA": false,
"weight": "0.0",
"profitRate": 0,
"fiveStarRatings": 0,
"asinUrl": "https://www.amazon.com/dp/#B0DKJGS69C",
"offSale": false,
"twoStarRatings": 0,
"fourStarRatings": 0,
"sourceType": "sorftime",
"oneStarRatings": 0,
"asin": "#B0DKJGS69C",
"monthlySalesUnits": 0
}
]
}
},
"isError": false
}
}