Publicidad de Amazon
API de obtención de informes de cuentas de Amazon Ads MCP
Recuperar información del informe de la cuenta del anunciante para comprobar los resultados de un informe de publicidad Amazon solicitado anteriormente.
Prompts y casos de uso de API de obtención de informes de cuentas 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. Revise un informe de visión existente
Prompt: Utilice la herramienta de información de productos patrocinados para comprobar mi informe actual [report ID] para mi cuenta de anuncios conectados [connection ID]. Dime si está listo antes de intentar una descarga.
Qué debes proporcionar
El impulso anterior utiliza la herramienta de sustitución documentada; no es una llamada verificada a esta ruta heredada. El contrato anterior sigue pendiente de aclaración.
Los casos de uso de esta ruta del informe anterior están a la espera de la aclaración: su órgano de solicitud de consulta periódica requerido no está definido por la referencia publicada. Utilice el reporte-status dedicado y herramientas de descarga de informes mientras que esto se resuelve.
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_ads_api_v1_retrieve_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-ads-api-v1-retrieve-reports-1",
"method": "tools/call",
"params": {
"name": "nexscope_data_amazon_ads_developer_proxy_ads_api_v1_retrieve_reports",
"arguments": {
"body": "{}",
"contentType": "application/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 |
|---|---|---|---|
connectionId | integer | obligatorio | Una Amazonía Ads connection owned by the autated Nexscope usuario. |
method | string | obligatorio | Las tres etapas de Ads v1 son todas `POST`. |
body | string | obligatorio | JSON string; la consulta de la cuenta puede ser `{}`, informe creation/polling ver referencia dedicada respectivamente. |
contentType | string | opcional | Típico `application/json`. |
pollInterval | integer | opcional | 5 a 300 segundos; la recomendación oficial es votar cada minuto. Ejemplo: 60 |
maxAttempts | integer | opcional | 1–120, ventana de espera predeterminada de aproximadamente 10 minutos. Ejemplo: 10 |
reportId | string | opcional | Después de pasar, el mapeo de cuentas y la creación serán saltados, y los informes existentes sólo serán encuestados. |
confirmationToken | string | opcional | Para mutaciones, primera vista previa sin token, luego confirme utilizando el token de uso único devuelto. |
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 | Si el script de entrada completa el procesamiento de informes. |
status | string | opcional | `PENDING`, `PROCESSING`, `COMPLETED`, `FAILED` o `STILL_PROCESSING`. |
reportId | string | opcional | Informe ID. |
reportKind | string | opcional | `audience` o `search-impression-share`. |
profileId | number | opcional | Perfil de anuncios usado. |
advertiserAccountId | string | opcional | La cuenta Ads v1 ID mapeado. |
fields | array | opcional | La combinación real de campo fijo (como devuelto). |
totalRows | integer | opcional | El número total de filas después de fundirse; 0 es un informe legalmente vacío. |
dataFiles[] | array | opcional | Local CSV Rebanada de archivo y número de fila. |
preview[] | array | opcional | Avance de resultados. |
resumeHint | object | opcional | Continuar los parámetros durante STILL_PROCESSING. |
_cacheable | boolean | opcional | Los resultados exitosos son caché por 24 horas; failed/incomplete es falso. |
part | integer | opcional | Número de serie de fragmentos. |
path | string | opcional | Local CSV ruta de archivo. |
rowCount | integer | opcional | El número de filas en este duro. |
Guía de flujo de trabajo
Ejemplo de flujo de trabajo, no una respuesta de API verificada.
Tu objetivo
Comprueba si mi informe de información de productos patrocinados está listo.
Pasos sugeridos
Utilice la herramienta de estado de los informes de productos patrocinados con su conexión de propiedad y el informe existente ID. Si sigue pendiente, mantenga eso ID para el próximo control de estado; descargar sólo después de que se devuelve un documento token.
Sobre esta muestra: Ejemplo de migración de Legacy-route, no una llamada verificada a esta ruta. El formato corporal requerido sigue siendo indocumentado. Uso /mcp-map/amazon-ads-sp-insights-report-status para el flujo de trabajo de estado documentado.
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.