Publicidad de Amazon

API de anuncios de productos de Sponsored Display MCP

Lista Patrocinada Mostrar anuncios de productos para revisar qué productos se anuncian en sus campañas y grupos de anuncios en Amazon.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de anuncios de productos de Sponsored Display

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. Revisa Anuncios de productos de pantalla patrocinados

Prompt: Lista de anuncios de productos patrocinados para mi cuenta de Amazon Ads conectado [connection ID]. Mostrar sólo los registros devueltos y indicar si quedan más resultados; no cambie ninguna configuración. Lea una página de hasta 20 registros y detenga; deje la recogida automática de páginas.

2. Crear anuncios de productos de pantalla patrocinados

Prompt: Preparar una vista previa para crear anuncios de productos patrocinados para mi cuenta de Amazon Ads conectado [connection ID], utilizando [my proposed settings and target identifiers]. Mostrar las entidades afectadas y esperar mi aprobación antes de aplicar el cambio exacto.

3. Actualización Anuncios de productos de pantalla patrocinados

Prompt: Preparar una vista previa para actualizar anuncios de productos patrocinados para mi cuenta de Amazon Ads conectado [connection ID], utilizando [my proposed settings and target identifiers]. Mostrar las entidades afectadas y esperar mi aprobación antes de aplicar el cambio exacto.

4. Revise un conjunto limitado de anuncios de productos de pantalla patrocinada

Prompt: Reseña hasta 20 registros de productos patrocinados para mi cuenta de Amazon Ads conectado [connection ID]. Lea una sola página, deje la recogida automática de páginas y dígame si quedan resultados adicionales.

5. Buscar anuncios de productos patrocinados por ad Group ID

Prompt: Para mi cuenta de anuncios conectados Amazon [connection ID], Mostrar anuncios de productos patrocinados de visualización que se correspondan con grupos de anuncios [ad group IDs]. Mantenga el filtro elegido con los registros devueltos y pare después de la primera página.

6. Buscar Producto de pantalla patrocinado Anuncios por anuncio ID

Prompt: Para mi cuenta de anuncios conectados Amazon [connection ID], Mostrar anuncios patrocinados Mostrar productos anuncios que se pongan en venta [ad IDs]. Mantenga el filtro elegido con los registros devueltos y pare después de la primera página.

7. Buscar Producto de pantalla patrocinado Anuncios por asin

Prompt: Para mi cuenta de anuncios conectados Amazon [connection ID], Mostrar productos patrocinados mostrar productos anuncios que se correspondan con productos [ASINs]. Mantenga el filtro elegido con los registros devueltos y pare después de la primera página.

8. Buscar Producto de pantalla patrocinado Anuncios por campaña ID

Prompt: Para mi cuenta de anuncios conectados Amazon [connection ID], Mostrar anuncios de productos patrocinados de pantalla campañas de emparejamiento [campaign IDs]. Mantenga el filtro elegido con los registros devueltos y pare después de la primera página.

9. Buscar Producto de pantalla patrocinado Anuncios por sku

Prompt: Para mi cuenta de anuncios conectados Amazon [connection ID], Mostrar productos patrocinados mostrar productos anuncios que se correspondan con productos [SKUs]. Mantenga el filtro elegido con los registros devueltos y pare después de la primera página.

10. Buscar Producto de pantalla patrocinado Anuncios por estado

Prompt: Para mi cuenta de anuncios conectados Amazon [connection ID], Mostrar anuncios de productos de pantalla patrocinados que se correspondan [enabled, paused or archived status]. Mantenga el filtro elegido con los registros devueltos y pare después de la primera página.

11. Aplicar el Cambio Aprobado

Prompt: Después de aprobar explícitamente la vista previa de los anuncios de productos de pantalla patrocinados en cuenta [connection ID], aplicar ese cambio exacto una vez. Si la vista previa ha expirado o mi configuración solicitada cambia, prepare una nueva vista previa en lugar de reutilizar la aprobación anterior.

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.

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_data_amazon_ads_developer_proxy_sd_product_ads

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": "data-amazon-ads-developer-proxy-sd-product-ads-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_amazon_ads_developer_proxy_sd_product_ads",
    "arguments": {
      "body": "{}",
      "contentType": "application/json",
      "method": "GET"
    }
  }
}

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	Una Amazonía Ads connection owned by the autated Nexscope usuario.
`fetchAll`	`boolean`	opcional	Turno automático de página; SP y SB V4 uso de listas de recursos principales `nextToken`, SB Target/BudgetRule usos `nextToken` (BudgetRule query debe contener `pageSize`), SB Palabra clave GET, SB V3 GET y SD uso `startIndex + count`. Ejemplo: true
`maxResults`	`integer`	opcional	Página única 1–100; SD corresponde a contar. Ejemplo: 100
`skipDepCheck`	`boolean`	opcional	Skip dependency check. Ejemplo: false
`includeExtendedDataFields`	`boolean`	opcional	Algunas entidades devuelven campos ampliados; SD se cambia a través del camino /extended.
`locale`	`string`	opcional	Parámetros de localización (apoyados por algunos scripts de palabras clave).
`method`	`string`	obligatorio	Upstream HTTP métodos: lista de consultas `GET`, crear `POST`, modificar `PUT`.
`body`	`string`	opcional	Los filtros opcionales se serializarán para queryString cuando la consulta; la carga útil debe ser proporcionada cuando creating/modifying.
`contentType`	`string`	opcional	application/json o el Tipo de Contenido correspondiente a la versión de recursos de Amazon.
`queryString`	`string`	opcional	SD filtros de consulta y parámetros de paging.
`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 la habilidad completó la llamada con éxito.
`apiVersion`	`string`	opcional	`V3` o `V4` (si lo proporciona el script).
`amazonResourceVersion`	`string`	opcional	La versión real de recursos de Amazon (si es proporcionada por el script).
`productAds`	`array`	opcional	Array of Sponsored Mostrar anuncios de productos; campos reales son devueltos por Amazon.
`total`	`integer`	opcional	El número de entradas agregadas (si se proporciona por el script).
`pagesFetched`	`integer`	opcional	Número de páginas obtenidas.
`truncated`	`boolean`	opcional	Si fue truncado debido al límite de paging.
`name`	`string`	opcional	Nombre (retornado si apoyado por la entidad).
`state`	`string`	opcional	`ENABLED`, `PAUSED` o `ARCHIVED` (SD upstream puede usar minúscula).

Ilustración del formato

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

Pregunta ilustrativa

Mostrar una página de anuncios de productos patrocinados para mi cuenta de anuncios conectados.

Explicación ilustrativa de la respuesta

La respuesta ilustrativa no devuelve ningún registro patrocinado de anuncios de productos de pantalla en esta página. No prueba que la cuenta no tenga registros coincidentes fuera del alcance solicitado, y no se cambiaron los ajustes.

Sobre esta muestra: Datos ficticios para ilustrar el formato; no proceden de una llamada real. Se muestra una sola página con límites definidos. Un recuento de cero no representa todo el mercado ni toda la cuenta sin filtrar.

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