Publicidad de Amazon

API de perfiles de cuentas de Amazon Ads MCP

Listar perfiles de cuenta de publicidad y su configuración de mercado para seleccionar la cuenta correcta para sus solicitudes de Amazon Ads.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de API de perfiles 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. Comprobar perfiles publicitarios

Prompt: Listar los perfiles de publicidad para mi conexión Amazon Ads [CONNECTION_ID] y mostrar la información de mercado disponible para cada uno.

2. Compruebe el perfil de la moneda y el tiempo de presentación de informes

Prompt: Listar los perfiles de publicidad para mi conexión Amazon Ads [CONNECTION_ID] y mostrar la información de mercado disponible para cada uno. Cree una tabla de perfil con país, moneda, zona horaria y presupuesto diario. No combinar presupuestos a través de monedas o utilizar una zona horaria de otro perfil.

3. Resolver Perfiles al Anunciador Correcto

Prompt: Para mi conexión de Ads propiedad [connection ID], relaciona cada perfil devuelto con el identificador y nombre del anunciante, el tipo de cuenta y el registro de autorización. Uso [my intended advertiser name] para identificar a los candidatos, pero marcar partidos ambiguos en lugar de elegir solo por nombre. No cambie la conexión o revele las credenciales.

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_data_amazon_ads_profiles

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-profiles-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_amazon_ads_profiles",
    "arguments": {
      "refresh": false
    }
  }
}

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.

Campos de respuesta

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

Nombre	Tipo	Obligatorio	Descripción
`total`	`integer`	opcional	número de perfiles.
`refreshed`	`boolean`	opcional	Ya sea que se realizó un refresco aguas arriba.
`profiles[]`	`array`	opcional	registros de perfil.
`profileId`	`number`	opcional	Unidad de operación ID.
`region`	`string`	opcional	`NA`, `EU` o `FE`.
`countryCode`	`string`	opcional	Código del país del sitio.
`currencyCode`	`string`	opcional	Moneda de cuenta.
`dailyBudget`	`string`	opcional	Presupuesto diario.
`timezone`	`string`	opcional	Zona horaria de la cuenta.
`accountInfoId`	`string`	opcional	Identificador de entidad anunciante.
`accountInfoType`	`string`	opcional	Tipo de cuenta.
`accountInfoName`	`string`	opcional	Store/advertiser nombre.
`marketplaceStringId`	`string`	opcional	Mercado de Amazon ID。
`authRecordId`	`number`	opcional	Registro de autorización ID.

Ilustración del formato

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

Pregunta ilustrativa

Mostrar los perfiles de mi cuenta de Amazon Ads conectada.

Explicación ilustrativa de la respuesta

La respuesta ilustrativa contiene una US Perfil USD y el America/Los_Angeles zona horaria. Utilice el perfil para el mercado previsto al interpretar los informes.

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