Amazon Advertising

Informes de Amazon Ads MCP

Crea un informe de Amazon Ads omitiendo reportId, consulta su estado con reportId o descarga el documento con documentToken.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Informes 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. Solicitar datos de impresión de campaña

Prompt: Crear un informe de campaña Productos Patrocinados para mi conexión Amazon Ads [CONNECTION_ID] desde [START_DATE] a través de [END_DATE], con campaña IDs e impresiones. Mantener las fechas inclusivas y devolver el informe existente ID si el procesamiento sigue en marcha.

2. Revisar el informe existente

Prompt: Informe de verificación [REPORT_ID] para mi conexión Amazon Ads [CONNECTION_ID]. Mostrar su estado actual sin crear otro informe.

3. Descargar un informe completo

Prompt: Descargar el informe completo para mi conexión Amazon Ads [CONNECTION_ID] utilizando la referencia de descarga ya devuelta por el backend. No me pida que pegue las credenciales en el chat.

4. Nombre un informe de campaña

Prompt: Crear el informe de impresiones de campaña de productos patrocinados ilustrados [CONNECTION_ID] desde [START_DATE] a través de [END_DATE], llamado [REPORT_NAME]. Retornar su estado y referencia, no una reclamación de que el informe ya ha finalizado.

5. Solicitar un informe con una configuración existente

Prompt: Solicitar una Amazonía Informe de anuncios para [CONNECTION_ID] desde [START_DATE] a [END_DATE] usando mi configuración completa, ya validada [REPORT_CONFIGURATION]. Regresar su estado e informar de referencia.

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_reporting

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-reporting-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_ads_reporting",
    "arguments": {
      "adProduct": "SPONSORED_PRODUCTS",
      "columns": [
        "campaignId",
        "impressions"
      ],
      "connectionId": 123,
      "endDate": "2026-07-31",
      "groupBy": [
        "campaign"
      ],
      "reportTypeId": "spCampaigns",
      "startDate": "2026-07-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
`connectionId`	`integer`	obligatorio	Owned Amazon Conexión de anuncios ID. Ejemplo: 123
`reportId`	`string`	opcional	Informe existente ID; cuando presente el API encuestas que reportan. Ejemplo: report-id
`reportTypeId`	`string`	opcional	Tipo de informe requerido por un nuevo informe a menos que la configuración lo proporcione. Ejemplo: spCampaigns
`adProduct`	`string`	opcional	Ad product required by a new report unless configuración supplies it. Ejemplo: SPONSORED_PRODUCTS
`groupBy`	`array`	opcional	Reportar campos de agrupación. Ejemplo: [ "campaign" ]
`columns`	`array`	opcional	Solicitaron columnas de informe. Ejemplo: [ "campaignId", "impressions", "clicks" ]
`name`	`string`	opcional	Nombre del informe opcional. Ejemplo: Campaign report
`startDate`	`string`	opcional	Inclusive report start date for a new report. Ejemplo: 2026-07-01
`endDate`	`string`	opcional	Fecha final del informe inclusivo para un nuevo informe. Ejemplo: 2026-07-31
`timeUnit`	`string`	opcional	Unidad de tiempo del informe opcional. Ejemplo: DAILY
`format`	`string`	opcional	Formato de informe opcional. Ejemplo: GZIP_JSON
`filters`	`array`	opcional	Filtros de informe opcionales. Ejemplo: []
`configuration`	`object`	opcional	Amazon completa Configuración de la presentación de informes de anuncios; puede reemplazar reportTypeId/adProduct/groupBy/columnas. Ejemplo: {}
`documentToken`	`string`	opcional	Backend-issued token for downloading a completed report. 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`	`object`	opcional	Descargar el contenido del informe cuando esté disponible. Ejemplo: {}
`data.contentType`	`string`	opcional	Tipo de contenido de informe descargado. Ejemplo: application/json
`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.documentToken`	`string`	opcional	Token opaque seguro utilizado para descargar. Ejemplo: opaque-document-token
`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.reportId`	`string`	opcional	Informe del proveedor ID. Ejemplo: report-id
`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.status`	`string`	opcional	Estado del informe. Ejemplo: PENDING
`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

Solicitar un informe de campaña de Productos Patrocinados para julio 2026 con campaña IDs e impresiones.

Explicación ilustrativa de la respuesta

La solicitud de informe ilustrativa devuelve informe-ejemplo-001 con estatus PENDING. El informe no está listo, por lo que no hay métricas de campaña para resumir aún. Revisa el mismo informe ID más tarde que crear otro informe.

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