Historial de Amazon KP

API de historial de productos de Amazon MCP

Recuperar atributos de productos Amazon y hasta 12 meses de historia de ventas por ASIN. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.

CosteRecent 10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de historial de productos 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. Obtener información de producto sin historia

Prompt: Buscar hasta 5 productos Amazon [ASINS] dentro [MARKETPLACE]. Volver información del producto sin datos históricos.

2. Datos históricos del producto

Prompt: Buscar hasta 5 productos Amazon [ASINS] dentro [MARKETPLACE]. Incluir la historia del producto disponible y las ventas históricas, conservando las fechas y estimaciones de la fuente.

3. Revisión Estimaciones mensuales de ventas

Prompt: Buscar hasta 5 productos Amazon [ASINS] dentro [MARKETPLACE]. Incluir la historia del producto disponible y las ventas históricas, conservando las fechas y estimaciones de la fuente. Compare las estimaciones de ventas mensuales devueltas en las etiquetas de mes disponibles. Mantener meses perdidos en blanco y distinguir las estimaciones de pedidos reales.

4. Examinar los datos de cumplimiento y comisiones

Prompt: Buscar hasta 5 productos Amazon [ASINS] dentro [MARKETPLACE]. Volver información del producto sin datos históricos. Mostrar cumplimiento, FBA tarifa e información de referencia con el precio devuelto y la moneda. Estado que faltan insumos de costos; no reclamar un cálculo completo de beneficios.

5. Estructura de la Lista y la Variación

Prompt: Buscar hasta 5 productos Amazon [ASINS] dentro [MARKETPLACE]. Volver información del producto sin datos históricos. Resume el ASIN principal, cuenta de variación, marca, material, dimensiones y referencias de imagen. Marcas de medición preseleccionadas en lugar de asumir unidades.

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/json

Autenticació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_product_history

Punto de conexión MCP

https://api.nexscope.ai/mcp

Método JSON-RPC

tools/call

Inicializa 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-product-history-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_product_history",
    "arguments": {
      "asin": "B072MQ5BRX",
      "domain": "1",
      "history": 1
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

La 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), múltiples ASINs separado por comas inglesas, hasta 5, longitud máxima 300 caracteres. Ejemplo: B0088PUEPK o B0088PUEPK,B00U26V4VQ,B07M68S376 Ejemplo: B072MQ5BRX
`domain`	`string`	obligatorio	dominio de Amazon ID. Opciones: 1 (Estados Unidos), 2 (Reino Unido), 3 (Alemania), 4 (Francia), 5 (Japón), 6 (Canadá), 8 (Italia), 9 (España), 10 (India), 11 (México), 12 (Brasil) Ejemplo: 1
`history`	`integer`	opcional	Ya sea para incluir datos históricos y ventas históricas en la respuesta. 1 = incluir historial de precios, rango de ventas, ventas históricas y otros datos de la serie de tiempo (ventas para meses anteriores), 0 = devolver sólo información básica del producto. Default: 0 Ejemplo: 1

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 filas.
`perPage`	`integer`	opcional	Cantidad por página.
`sourceType`	`string`	opcional	Tipo fuente: `kp`.
`columns`	`array`	opcional	Columnas rendidas.
`costToken`	`integer`	opcional	Consume token.
`totalCount`	`integer`	opcional	Cantidad total.
`currentPage`	`integer`	opcional	Número de página actual.
`type`	`string`	opcional	Rendering estilo.
`products`	`array`	opcional	Lista de productos, campos de elementos se muestran en la tabla siguiente.
`asin`	`string`	opcional	ASIN。
`title`	`string`	opcional	Título del producto.
`brand`	`string`	opcional	Brand.
`manufacturer`	`string`	opcional	fabricante.
`model`	`string`	opcional	modelo.
`color`	`string`	opcional	color.
`material`	`string`	opcional	El material de un producto se refiere a los principales materiales utilizados en su construcción.
`price`	`number`	opcional	Precio actual en moneda local.
`primePrice`	`number`	opcional	Prime Price.
`currency`	`string`	opcional	Moneda.
`rating`	`number`	opcional	Valoración actual (0.0-5.0).
`ratings`	`integer`	opcional	Número de valoraciones.
`reviewCount`	`integer`	opcional	Número de comentarios.
`salesRank`	`integer`	opcional	Clasificación de ventas.
`salesRank30`	`integer`	opcional	Promedio de ventas en los últimos 30 días.
`salesRank90`	`integer`	opcional	Promedio de ventas en los últimos 90 días.
`salesRank180`	`integer`	opcional	El promedio de ventas se sitúa en los últimos 180 días.
`monthlySalesUnits`	`integer`	opcional	Volumen mensual de ventas.
`monthlySalesRevenue`	`number`	opcional	Ventas mensuales.
`monthlySalesUnits1MonthAgo`	`integer`	opcional	Volumen mensual de ventas hace 1 meses.
`monthlySalesUnits2MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 2 meses.
`monthlySalesUnits3MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 3 meses.
`monthlySalesUnits4MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 4 meses.
`monthlySalesUnits5MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 5 meses.
`monthlySalesUnits6MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 6 meses.
`monthlySalesUnits7MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 7 meses.
`monthlySalesUnits8MonthsAgo`	`integer`	opcional	Volumen de ventas mensual hace 8 meses.
`monthlySalesUnits9MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 9 meses.
`monthlySalesUnits10MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 10 meses.
`monthlySalesUnits11MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 11 meses.
`monthlySalesUnits12MonthsAgo`	`integer`	opcional	Volumen mensual de ventas hace 12 meses.
`availableDate`	`string`	opcional	Tiempo de estante (`yyyy-MM-dd HH:mm:ss`).
`lastUpdate`	`string`	opcional	Última actualización (`yyyy-MM-dd HH:mm:ss`).
`imageUrl`	`string`	opcional	Imagen URL (dirección de solicitud).
`productImageUrls`	`array`	opcional	Lista de imágenes de producto.
`asinUrl`	`string`	opcional	Amazon ASIN detalles URL.
`urlSlug`	`string`	opcional	URL Slug.
`itemLength`	`integer`	opcional	Longitud del producto en milímetros, o 0 o -1 si no está disponible.
`itemWidth`	`integer`	opcional	Ancho de producto en milímetros, 0 o -1 si no está disponible.
`itemHeight`	`integer`	opcional	Altura del producto en milímetros, 0 o -1 si no está disponible.
`dimension`	`string`	opcional	tamaño.
`dimensionsType`	`string`	opcional	Tipo de tamaño.
`weight`	`string`	opcional	Peso (gramos).
`packageLength`	`integer`	opcional	Longitud del paquete (mm).
`packageWidth`	`integer`	opcional	Ancho del paquete (mm).
`packageHeight`	`integer`	opcional	Altura del paquete (mm).
`packageWeight`	`string`	opcional	Peso de embalaje (gramos).
`packageDimensions`	`string`	opcional	Tamaño de embalaje.
`packageQuantity`	`integer`	opcional	La cantidad del artículo en el paquete, o 0 o -1 si no está disponible.
`fulfillment`	`string`	opcional	Método de entrega: `AMZ`, `FBA`, `FBM`.
`fbaFees`	`number`	opcional	FBA tasa de cumplimiento en moneda local.
`referralFeePercentage`	`number`	opcional	Porcentaje de honorarios de referencia.
`profit`	`number`	opcional	margen de ganancia (porcentaje, como 25,5 por 25,5%).
`buyBoxSellerId`	`string`	opcional	Comprar botón vendedor ID.
`sellerNum`	`integer`	opcional	Número de vendedores.
`variationNum`	`integer`	opcional	Número de variantes.
`parentAsin`	`string`	opcional	Parent ASIN.
`rootCategory`	`integer`	opcional	Categoría de raíces ID.
`categoryTree`	`string`	opcional	Árbol de categoría.
`categoryTreeId`	`string`	opcional	Categoría árbol ID.
`subcategories`	`array`	opcional	Lista de subcategorías; cada elemento contiene `code` (categoría ID), `rank` (Arrancando), `label` (nombre de la categoría).
`isAdultProduct`	`boolean`	opcional	Ya sea un producto adulto.
`isHazmat`	`boolean`	opcional	Ya sea mercancías peligrosas.
`sourceType`	`string`	opcional	Tipo fuente: `kp`.
`code`	`—`	opcional	Categoría ID; el tipo de elemento estará sujeto al archivo fuente o a la documentación oficial aguas arriba.
`rank`	`—`	opcional	Clasificación; tipo de elemento se basará en el archivo fuente o la documentación oficial aguas arriba.
`label`	`—`	opcional	Nombre de la categoría; tipo de elemento estará sujeto al archivo fuente o a la documentación oficial aguas arriba.

Ilustración del formato

Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.

Pregunta ilustrativa

Mostrar las métricas del producto histórico para ASIN B072MQ5BRX en Amazon US.

Explicación ilustrativa de la respuesta

El resultado ilustrativo reporta 300 unidades de ventas mensuales y 250 para la métrica de un mes. La diferencia es de 50 unidades; estas observaciones no establecen una tendencia a largo plazo.

Sobre esta muestra: Ejemplo meramente ilustrativo: los nombres, identificadores y cifras son ficticios y no se hizo una llamada real. Tus resultados dependen de tu cuenta, las entradas y los datos disponibles.

No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.

Ver el formato de solicitud y respuesta MCP

Ejemplos