Investigación de Amazon JS

API de estimaciones de ventas de Amazon MCP

Obtén diariamente estimado Amazon ASIN ventas y el último precio conocido para un rango de fecha seleccionado en 10 marketplaces. Llámalo REST API o MCP.

CosteRecent 133 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de estimaciones de ventas 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. Verificación de ventas diarias estimadas

2. Comparación de ventas estimadas con precios observados

Prompt: Mostrar ventas diarias estimadas y el último precio conocido para Amazon ASIN [ASIN] dentro [MARKETPLACE] desde [START_DATE] a [END_DATE]. Utilice una fecha final antes de hoy y etiquetar las cifras de ventas como estimaciones. Par cada unidad devolvió la estimación diaria con su último precio conocido. Cambios destacados sin reclamar precio causado cambios de ventas; no computar los ingresos de un precio posiblemente fijo.

3. Comprobar Parent y Alcance Variante

Prompt: Mostrar ventas diarias estimadas y el último precio conocido para Amazon ASIN [ASIN] dentro [MARKETPLACE] desde [START_DATE] a [END_DATE]. Utilice una fecha final antes de hoy y etiquetar las cifras de ventas como estimaciones. Mostrar si el regreso ASIN es un producto padre, variante o independiente, con sus referencias padre y variante. No agregue las estimaciones de padres y variantes juntos o asuma que todas las variantes fueron devueltas.

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_sales_estimates

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-sales-estimates-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_sales_estimates",
    "arguments": {
      "asin": "B072MQ5BRX",
      "endDate": "2026-01-01",
      "marketplace": "us",
      "startDate": "2026-01-01"
    }
  }
}

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
`marketplace`	`string`	obligatorio	Código de mercado de destino. Opciones: nosotros, uk, de, in, ca, fr, it, es, mx, jp Ejemplo: us
`asin`	`string`	obligatorio	Amazon ASIN a la consulta Ejemplo: B072MQ5BRX
`startDate`	`string`	obligatorio	Fecha de inicio (formato: YYYY-MM-DD) Ejemplo: 2026-01-01
`endDate`	`string`	obligatorio	Fecha final (formato: YYYY-MM-DD); debe ser anterior a la fecha actual Ejemplo: 2026-01-01

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`costToken`	`integer`	opcional	Número de fichas consumidas
`salesEstimateList`	`array`	opcional	Lista de resultados de las estimaciones de ventas
`asin`	`string`	opcional	Query ASIN
`id`	`string`	opcional	Identificación de puntos de datos
`type`	`string`	opcional	Tipo de recurso, valor fijo `sales_estimate_result`
`parentAsin`	`string`	opcional	Parent ASIN (retorno en escenarios variantes)
`isParent`	`boolean`	opcional	¿Es un producto padre?
`isVariant`	`boolean`	opcional	Ya sea un producto variante
`isStandalone`	`boolean`	opcional	Ya sea un producto independiente (no variable)
`variants`	`array`	opcional	Un array de variante ASINs bajo este padre
`dailyEstimates`	`array`	opcional	Array of daily estimated data
`date`	`string`	opcional	Fecha de entradaYYYY-MM-DD)
`estimatedUnitsSold`	`integer`	opcional	Número estimado de piezas vendidas el día
`lastKnownPrice`	`number`	opcional	Último precio conocido (USD)

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

Mostrar estimaciones de ventas diarias ASIN B0GHN9T5W3 en Amazon US del 3 de septiembre al 2 de octubre de 2026.

Respuesta de ejemplo

La muestra identifica a un padre ASIN y lista tres variantes, pero no contiene valores de ventas diarios. Un total o tendencia de ventas diarias no se puede calcular a partir de esta respuesta.

Sobre esta muestra: Los valores de ventas perdidos no son cero ventas. Los identificadores parientes y variantes por sí solos no establecen volumen de ventas.

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": "B0GHN9T5W3",
  "marketplace": "us",
  "startDate": "2026-09-03",
  "endDate": "2026-10-02"
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": {
    "costToken": 85000,
    "salesEstimateList": [
      {
        "parentAsin": "B0GHN9T5W3",
        "isParent": true,
        "isVariant": false,
        "isStandalone": false,
        "asin": "B0GHN9T5W3",
        "id": "us/B0GHN9T5W3",
        "variants": [
          "B0DSGJCS47",
          "B0G31J12SG",
          "B0DYG4Q6PL"
        ],
        "type": "sales_estimate_result"
      }
    ]
  }
}

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-sales-estimates-example",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_sales_estimates",
    "arguments": {
      "asin": "B0GHN9T5W3",
      "marketplace": "us",
      "startDate": "2026-09-03",
      "endDate": "2026-10-02"
    }
  }
}

Formato de respuesta MCP

{
  "jsonrpc": "2.0",
  "id": "amazon-sales-estimates-example",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"code\":0,\"msg\":null,\"data\":{\"salesEstimateList\":[{\"parentAsin\":\"B0GHN9T5W3\",\"isParent\":true,\"isVariant\":false,\"isStandalone\":false,\"asin\":\"B0GHN9T5W3\",\"id\":\"us/B0GHN9T5W3\",\"variants\":[\"B0DSGJCS47\",\"B0G31J12SG\",\"B0DYG4Q6PL\"],\"type\":\"sales_estimate_result\"}]}}"
      }
    ],
    "structuredContent": {
      "code": 0,
      "msg": null,
      "data": {
        "salesEstimateList": [
          {
            "parentAsin": "B0GHN9T5W3",
            "isParent": true,
            "isVariant": false,
            "isStandalone": false,
            "asin": "B0GHN9T5W3",
            "id": "us/B0GHN9T5W3",
            "variants": [
              "B0DSGJCS47",
              "B0G31J12SG",
              "B0DYG4Q6PL"
            ],
            "type": "sales_estimate_result"
          }
        ]
      }
    },
    "isError": false
  }
}