Publicidad de Amazon

API de cuentas de anunciantes de Amazon Ads MCP

Query cuenta de anunciante para identificar las cuentas de publicidad disponibles para su integración de Amazon Ads.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de cuentas de anunciantes 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. Consultar cuentas publicitarias accesibles

Prompt: Enumera las cuentas de anunciante devueltas para mi conexión de Amazon Ads [connection ID]. Muestra el ID, el nombre visible y el estado de cada cuenta e indica si hay otra página de resultados.

2. Consultar cuentas de anunciante seleccionadas

Prompt: Busca las cuentas de anunciante que coincidan con [advertiser account IDs] usando mi conexión [connection ID]. Muestra los identificadores y estados devueltos. Distingue una cuenta ausente de esta página de una cuenta cuya indisponibilidad se haya confirmado.

3. Consultar cuentas globales o regionales

Prompt: Con mi conexión [connection ID], consulta las cuentas de anunciante según el filtro [global or non-global]. Muestra el identificador y el indicador global de cada cuenta devuelta; trata los indicadores ausentes como desconocidos.

4. Reunir un inventario paginado de cuentas

Prompt: Enumera las cuentas publicitarias de mi conexión [connection ID] con un máximo de 100 resultados por página y de 3 páginas. Sigue únicamente los tokens de continuación devueltos sin cambiar los filtros, elimina duplicados por ID e indica si quedan más páginas.

5. Relacionar cuentas e identificadores de mercado

Prompt: Para las cuentas devueltas por mi conexión [connection ID], relaciona cada ID de anunciante con los identificadores disponibles de perfil, entidad y anunciante DSP, además del país y la región. Mantén separados los datos de NA, EU y FE y deja vacíos los identificadores ausentes.

6. Revisar el estado de registro

Prompt: Con mi conexión [connection ID], agrupa las cuentas devueltas por APPROVED, ARCHIVED, REGISTRATION_IN_PROGRESS o REJECTED y muestra sus mensajes de estado. Presenta por separado los valores desconocidos y no infieras por qué cambió un estado.

7. Comparar la configuración de las cuentas

Prompt: Para las cuentas de anunciante devueltas por mi conexión [connection ID], compara moneda, zona horaria y sector en una tabla. Marca los valores ausentes como desconocidos; esta configuración no demuestra el rendimiento de las campañas.

8. Identificar cuentas de prueba y administradores

Prompt: Con mi conexión [connection ID], separa las cuentas publicitarias de prueba de las demás y muestra los ID de cuentas administradoras vinculadas que se hayan devuelto. Señala los indicadores e identificadores ausentes sin inferirlos.

9. Comprobar la información empresarial disponible

Prompt: Para las cuentas devueltas por mi conexión [connection ID], muestra el sitio web empresarial e indica si hay dirección, token de dirección, número de registro o solicitud de vínculo de venta. No reveles direcciones privadas, tokens ni números de registro, y no infieras el resultado de una búsqueda de vínculos.

Qué debes proporcionar

Usa una conexión de Amazon Ads que te pertenezca y no incluyas credenciales en los prompts.

La consulta usa POST con un cuerpo JSON y application/json. Un objeto vacío consulta las cuentas accesibles. Los controles admitidos son advertiserAccountIdFilter, isGlobalAccountFilter, maxResults (de 10 a 100) y nextToken. Confirma la estructura de los filtros en el contrato de la API antes de llamar: la descripción actual no especifica su forma anidada.

Los resultados se paginan. Los valores opcionales ausentes son desconocidos; una página vacía no equivale al resultado de un informe.

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_ads_api_v1_query_advertiser_accounts

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-ads-api-v1-query-advertiser-accounts-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_amazon_ads_developer_proxy_ads_api_v1_query_advertiser_accounts",
    "arguments": {
      "body": "{}",
      "contentType": "application/json",
      "method": "POST"
    }
  }
}

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.
`method`	`string`	obligatorio	La consulta de cuenta corriente utiliza POST.
`body`	`string`	opcional	JSON cadena para la consulta Amazon Ads. Use {} para cuentas accesibles, o incluya advertiserAccountIdFilter, isGlobalAccountFilter, maxResults (10-100), y nextToken.
`contentType`	`string`	opcional	Uso application/json.

Campos de respuesta

Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.

Nombre	Tipo	Obligatorio	Descripción
`advertiserAccounts`	`array`	opcional	Cuentas de anunciante en esta página (0-100). Un array vacío significa que no hay cuentas de coincidencia. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 100
`advertiserAccounts[]`	`object`	obligatorio	Cuentas de anunciante en esta página (0-100). Un array vacío significa que no hay cuentas de coincidencia.
`advertiserAccounts[].advertiserAccountId`	`string`	obligatorio	Unique Amazon Cuenta de anunciantes ID.
`advertiserAccounts[].alternateIds`	`array`	opcional	Identificadores de mercado asociados con esta cuenta. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 30
`advertiserAccounts[].alternateIds[]`	`object`	obligatorio	Identificadores de mercado asociados con esta cuenta.
`advertiserAccounts[].alternateIds[].countryCode`	`string`	opcional	Código de país de mercado.
`advertiserAccounts[].alternateIds[].dspAdvertiserId`	`string`	opcional	Regional DSP anunciante anunciante ID.
`advertiserAccounts[].alternateIds[].entityId`	`string`	opcional	Entidad de mercado ID.
`advertiserAccounts[].alternateIds[].profileId`	`string`	opcional	Perfil de mercado ID.
`advertiserAccounts[].alternateIds[].region`	`string`	opcional	Amazon Ads región. Permitidos: EU, FE, NA
`advertiserAccounts[].businessDetails`	`array`	obligatorio	Detalles del negocio para la cuenta del anunciante. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 1
`advertiserAccounts[].businessDetails[]`	`object`	obligatorio	Detalles del negocio para la cuenta del anunciante.
`advertiserAccounts[].businessDetails[].address`	`object`	opcional	Dirección de negocios, cuando se devuelve; contiene detalles de contacto sensibles.
`advertiserAccounts[].businessDetails[].addressToken`	`string`	opcional	Token de dirección comercial vinculada; sensible.
`advertiserAccounts[].businessDetails[].businessRegistrationNumber`	`string`	opcional	Número de registro de empresas; sensible.
`advertiserAccounts[].businessDetails[].website`	`string`	opcional	Sitio web de negocios.
`advertiserAccounts[].currencyCode`	`string`	opcional	Código de moneda de cuenta.
`advertiserAccounts[].displayName`	`string`	opcional	Nombre de la pantalla de la cuenta de anunciante.
`advertiserAccounts[].industryVertical`	`string`	opcional	Industria vertical.
`advertiserAccounts[].isGlobalAccount`	`boolean`	opcional	Ya sea una cuenta de anunciante global.
`advertiserAccounts[].isTestAccount`	`boolean`	opcional	Ya sea una cuenta de prueba.
`advertiserAccounts[].managerAccountId`	`string`	opcional	Cuenta de gestión vinculada ID.
`advertiserAccounts[].sellingAccountLinkRequests`	`array`	opcional	Venta de solicitudes de enlace de cuenta. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 1
`advertiserAccounts[].sellingAccountLinkRequests[]`	`object`	obligatorio	Venta de solicitudes de enlace de cuenta.
`advertiserAccounts[].status`	`object`	obligatorio	Estado actual de la cuenta del anunciante.
`advertiserAccounts[].status.statusCode`	`string`	obligatorio	Estado de cuenta actual. Permitidos: APPROVED, ARCHIVED, REGISTRATION_IN_PROGRESS, REJECTED
`advertiserAccounts[].status.statusMessage`	`string`	obligatorio	Mensaje de estado legible por humanos.
`advertiserAccounts[].timeZoneIana`	`string`	opcional	Zona horaria contable IANA formato.
`nextToken`	`string`	opcional	Continuación token for the next page, when returned.

Guía de flujo de trabajo

Ejemplo de flujo de trabajo, no una respuesta de API verificada.

Tu objetivo

Lista de cuentas de anunciantes y su perfil de mercado IDs para mi propiedad Amazon Ads conexión.

Pasos sugeridos

Query your owned connection and read advertiserAccounts de la respuesta. Pare cada uno advertiserAccountId con el profileId, countryCode y región dentro de su alternateIds entradas. Mostrar el estado de cuenta devuelto por separado. Si nextToken está presente, oferta para recuperar otra página dentro de su límite solicitado; una página no establece un inventario completo.

Sobre esta muestra: Explicación de flujo de trabajo basado en el esquema de cuenta documentada, no en vivo API resultado. Pueden falta mapas de perfiles opcionales; no se fabrican registros de cuentas.

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