Amazon Advertising

Descarga de informes de insights de Sponsored Products de Amazon Ads MCP

Descarga un informe de estadísticas de Sponsored Products completado.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Descarga de informes de insights de Sponsored Products de Amazon Ads

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. Descargar un informe completo de información

2. Preparar una tabla de informes para el análisis

Prompt: Descargar mi informe completo de información de productos patrocinados para [CONNECTION_ID] utilizando la referencia de descarga devuelta por su parte del informe finalizada. Resume el contenido realmente recuperado y no muestre la ficha de descarga de backend. Parse el descargado CSV con sus cabeceras reales. Devuelve un inventario de columna y una pequeña fila de vista previa, preservando las células en blanco; no invente métricas ausentes del archivo.

3. Combine dos completados CSV Partes

Prompt: Descargar exactamente dos completados CSV partes [part A reference] y [part B reference] por mi conexión de propiedad [connection ID], utilizando sus referencias de descarga existentes en privado. Compare primero los encabezados reales y el contexto de informe. Combine filas sólo cuando sus estructuras y alcance son compatibles; de lo contrario mantenga las tablas separadas y explique el desajuste. No invente una clave de deduplicación o asuma que son cada parte del informe.

Qué debes proporcionar

Usar una Amazonía Ads connection you own. Mantengan las credenciales fuera de los avisos. Un informe que todavía se procesa no es un resultado completado; reutilizar su referencia en lugar de crearlo de nuevo.

Los cambios de publicidad requieren una vista previa y su confirmación explícita. Estos ejemplos no autorizan cambios por sí mismos.

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_ads_sp_insights_report_download

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-ads-sp-insights-report-download-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_ads_sp_insights_report_download",
    "arguments": {
      "connectionId": 123,
      "documentToken": "opaque-document-token"
    }
  }
}

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
`connectionId`	`integer`	obligatorio	Owned Amazon Conexión de anuncios ID; perfil y región se resuelven por el backend. Ejemplo: 123
`documentToken`	`string`	obligatorio	Backend-issued token from a completed report part, consumption by the existing download workflow. Ejemplo: opaque-document-token

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`	obligatorio	0 indica que la solicitud se ha aceptado o se ha completado correctamente; cualquier valor distinto de cero indica un error de la plataforma.
`cost`	`string`	obligatorio	Milliseconds pasados, nunca créditos; -1 solicitudes fuera de la web.
`data`	`any`	obligatorio	Valor de Data usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Valor de Msg usado por esta operación de API.
`time`	`string`	obligatorio	Tiempo local del servidor: yyyy-MM- No. HH:mm:ss.
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Época milisegundos.

Opción 1 de cualquier alternativa

Nombre	Tipo	Obligatorio	Descripción
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.content`	`string`	opcional	UTF-8 CSV informe contenido Ejemplo: date.value,metric.impressions 2026-08-01,10
`data.contentType`	`string`	opcional	Tipo multimedia descargado Ejemplo: text/csv
`data.costTime`	`integer`	opcional	Tiempo de ejecución reportado por el proveedor de corriente. Ejemplo: null
`data.costToken`	`integer`	opcional	Costo de ficha reportado por el proveedor de corriente. Ejemplo: null
`data.dataSnapshotMonth`	`string`	opcional	Data snapshot month returned by the upstream provider. Ejemplo: null
`data.page`	`integer`	opcional	Página actual devuelta por el proveedor de corriente. Ejemplo: null
`data.pageItemCount`	`integer`	opcional	El artículo cuenta con la página actual devuelta por el proveedor de corriente. Ejemplo: null
`data.pageSize`	`integer`	opcional	Tamaño de página devuelto por el proveedor de corriente. Ejemplo: null
`data.sourceTool`	`string`	opcional	Nombre de la herramienta de fuente específico del proveedor. Ejemplo: null
`data.sourceType`	`string`	opcional	Tipo de plataforma de fuente específica del proveedor. Ejemplo: null
`data.title`	`string`	opcional	Título de respuesta específico del proveedor. Ejemplo: null
`data.totalPage`	`integer`	opcional	Conteo total de página devuelto por el proveedor de corriente. Ejemplo: null
`data.type`	`string`	opcional	Tipo de renderizado o carga de pago específico del proveedor. Ejemplo: null

Opción 2 de cualquier alternativa

Nombre	Tipo	Obligatorio	Descripción
`data`	`null`	obligatorio	Valor de Data usado por esta operación de API.

Ilustración del formato

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

Pregunta ilustrativa

Descargue mi informe completo de información de productos patrocinados y resumir el devuelto CSV.

Explicación ilustrativa de la respuesta

El ilustrativo CSV contiene una fila fechada el 1 de agosto de 2026, con 10 impresiones. Esta descarga no contiene clics ni gastar, así CTR y costo por clic no se puede calcular.

Sobre esta muestra: Ejemplo de formato ilustrativo solamente; las 10 impresiones son ficticias. Reemplazar el marcador de posición con el documento opaco token devuelto para su informe completado. Una señal no puede inventarse del informe ID.

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