Amazon Advertising

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

Consulta el estado de un informe de estadísticas de Sponsored Products existente.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Estado 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. Progresos realizados en el informe

2. Identificar partes completas del informe

Prompt: Consultar el estado actual del informe [REPORT_ID] para mi conexión Amazon Ads [CONNECTION_ID]. No cree un nuevo informe. Si sigue procesando, devuelve el estado para que pueda volver a comprobarlo más tarde. Enumerar las piezas completas disponibles para descargarlas y distinguirlas de un informe que aún se procesa. Mantenga las referencias de descarga de backend privada; pare después de este cheque de estado.

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_status

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-status-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_ads_sp_insights_report_status",
    "arguments": {
      "connectionId": 123,
      "reportId": "report-id"
    }
  }
}

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
`reportId`	`string`	obligatorio	Informe existente ID; la encuesta nunca crea otro informe. Ejemplo: report-id

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 — requiere reportId

Nombre	Tipo	Obligatorio	Descripción
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.completedReportParts`	`array`	opcional	Completado CSV partes; cada parte contiene un backend documentToken en lugar de una firma URL. Ejemplo: []
`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.reportId`	`string`	obligatorio	Identificador de informe creado o preguntado. Ejemplo: report-id
`data.reportParts`	`array`	opcional	Provider alias for completed parts, when present. Ejemplo: []
`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	Informe del proveedor indica cuándo está presente. 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

¿Está listo report-example-001 para descargar?

Explicación ilustrativa de la respuesta

El estado del ejemplo es PENDING. Aún no se ha devuelto el informe completo ni un token de descarga; consulta de nuevo este mismo informe más adelante.

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