Publicidad de Amazon
API de creación de informes de Amazon Ads MCP
Solicitar un informe de publicidad para fechas y métricas seleccionadas para revisar el desempeño de sus campañas en Amazon.
Prompts y casos de uso de API de creación 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 un informe a través de la herramienta de presentación de informes documentada
Prompt: Use Amazon Ads Reporting para solicitar [report type] para mi cuenta conectada [connection ID] sobre [start date] a [end date]. Use mi configuración validada del informe y mantenga el informe devuelto ID para consultas posteriores del estado.
2. Planificar consultas limitadas del estado de un informe
Prompt: Utilice Amazon Ads Reporting para comprobar mi informe existente [report ID] Cuenta [connection ID]. Preparar un plan de consultas periódicas [interval in seconds] y [maximum attempts], y verificar esos límites contra la herramienta de reemplazo antes de ejecutarla. Mantenga los informes pendientes, fallidos y completados distintos; pare en el límite.
3. Preparar un informe diario o sumario
Prompt: Preparar una solicitud de presentación de anuncios en Amazon [report type] en cuenta [connection ID], cubriendo [start date] a través de [end date]. Uso [daily rows or one period summary], [report name] y sólo la agrupación, columnas y filtros apoyados por ese tipo de informe. Compruebe la configuración de la herramienta de reemplazo antes de enviar.
4. Plan Reportar acceso a archivos
Prompt: Para mi informe completo de Amazon Ads, explique las opciones de acceso a archivos soportadas por Amazon Ads Reporting. Si se admite una vista previa local, utilice mi dirección local elegida, puerto y caducidad; distinguir esa vista previa temporal de un enlace fuente proveedor. Verificar la herramienta de reemplazo es compatible con cada opción antes de habilitarla.
Qué debes proporcionar
Usa una conexión de Amazon Ads que te pertenezca. Nunca incluyas credenciales del proveedor en un prompt ni en el cuerpo de una solicitud.
Para realizar un cambio, primero revisa una vista previa y después aprueba por separado ese cambio concreto. Que un ejemplo funcione no autoriza a modificar una cuenta.
Algunos campos heredados y detalles de las operaciones no están completamente documentados. Los ejemplos cubren los flujos confirmados; comprueba las limitaciones de entrada y respuesta antes de usar esta ruta.
Estos flujos preparan el uso de la herramienta sustituta. Los campos heredados de consulta periódica y entrega de archivos solo describen la intención; comprueba el contrato vigente de Amazon Ads Reporting antes de ejecutar la operación. No se proporciona ningún JSON de solicitud heredada.
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
nexscope_data_amazon_ads_developer_proxy_reporting_reportshttps://api.nexscope.ai/mcptools/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": "data-amazon-ads-developer-proxy-reporting-reports-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_reporting_reports",
"arguments": {
"body": "{\"reportTypeId\":\"spCampaigns\"}",
"contentType": "application/vnd.createasyncreportrequest.v3+json",
"method": "POST"
}
}
}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 |
|---|---|---|---|
adProduct | string | obligatorio | Contrast report-type frontmatter, tales como `SPONSORED_PRODUCTS`, `SPONSORED_BRANDS`, `SPONSORED_DISPLAY`. |
columns | array | obligatorio | Revise contra un subconjunto de columnas permitidas de la tabla base correspondiente. |
columns[] | object | obligatorio | Revise contra un subconjunto de columnas permitidas de la tabla base correspondiente. |
confirmationToken | string | opcional | Para mutaciones, primera vista previa sin token, luego confirme utilizando el token de uso único devuelto. |
connectionId | integer | obligatorio | Una Amazonía Ads connection owned by the autated Nexscope usuario. |
endDate | string | obligatorio | `YYYY-MM-DD`, incluyendo el día actual. |
filters | array | opcional | Las enumeraciones de campo y valor se basan en el archivo correspondiente tipo informe. |
filters[] | object | obligatorio | Las enumeraciones de campo y valor se basan en el archivo correspondiente tipo informe. |
format | string | opcional | Informe formato de archivo. Predeterminado: GZIP_JSON |
groupBy | array | obligatorio | Compare el nombre de reporte de primera categoría; sin necesidad de adivinación. |
groupBy[] | object | obligatorio | Compare el nombre de reporte de primera categoría; sin necesidad de adivinación. |
includeAmazonSourceUrl | boolean | opcional | Ya sea para devolver la fuente presignada de Amazon URL. Predeterminado: false |
maxAttempts | integer | opcional | Número máximo de encuestas, ventana de espera predeterminada de aproximadamente 10 minutos. Predeterminado: 20 |
name | string | opcional | Reporte nombre de la pantalla. |
pollInterval | integer | opcional | Intervalo de consulta periódica en segundos. Predeterminado: 30 |
reportTypeId | string | obligatorio | Revise el archivo correspondiente de tipos de informe. |
serveExtractedFileHttp | boolean | opcional | Ya sea para iniciar el temporal nativo HTTP servicio. Predeterminado: true |
serveHost | string | opcional | Dirección de enlace de servicio nativo. |
servePort | integer | opcional | 0 indica el puerto asignado del sistema. Predeterminado: 0 |
serveSeconds | integer | opcional | El número de segundos del enlace local sigue vivo. Predeterminado: 300 |
skipDepCheck | boolean | opcional | Skip dependency check. Predeterminado: false |
startDate | string | obligatorio | `YYYY-MM-DD`, incluyendo el día actual. |
timeUnit | string | opcional | `DAILY` o `SUMMARY`. Predeterminado: SUMMARY |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
success | boolean | opcional | Ya sea descargado y descomprimido con éxito. |
reportId | string | opcional | Amazon informando ID. |
status | string | opcional | `PENDING`, `PROCESSING`, `COMPLETED` o `FAILED`. |
reportTypeId | string | opcional | El tipo de informe solicitado. |
pollAttempts | integer | opcional | Número de veces encuestados. |
elapsedSeconds | number | opcional | El número de segundos pasó. |
downloadPath | string | opcional | La ruta de archivo local descargada o descomprimida. |
extractedFileHttpUrl | string | opcional | Archivo temporal nativo URL (si está habilitado). |
serveExpiresAt | string | opcional | Native URL tiempo de caducidad (si es devuelto). |
failureReason | string | opcional | Razón para la falla de corriente cuando `FAILED`. |
resumeHint.mode | string | opcional | `poll-only`。 |
resumeHint.params | object | opcional | Reutilizar el mismo reportId y aumento maxAttempts para seguir encuestando. |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
Use Amazon Ads Reporting para solicitar [report type] para mi cuenta conectada [connection ID] sobre [start date] a [end date]. Use mi configuración validada del informe y mantenga el informe devuelto ID para consultas posteriores del estado.
Pasos sugeridos
Usa Amazon Ads Reporting con tu cuenta conectada y una configuración de informe validada. Conserva el ID del informe devuelto y consulta ese mismo informe si sigue procesándose; no crees otro solo porque está pendiente.
Sobre esta muestra: Sólo ilustración de flujo de trabajo. El contrato anterior no proporciona suficiente información consistente para construir una solicitud verificada y un par de respuesta.
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
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
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
No hay un ejemplo verificado de solicitud MCP. Consulta Integración y los requisitos documentados antes de preparar una llamada.
Formato de respuesta MCP
Este flujo de trabajo no afirma haber obtenido un resultado de la API. No hay un ejemplo de respuesta verificado; consulta Parámetros y respuesta para ver la estructura documentada.