Publicidad de Amazon

Acceso a la API de Amazon Ads MCP

Conectar un Amazon Cuenta de anuncios y comprobar su estado de conexión. Consulta esta API mediante REST o MCP con tu clave de API de Nexscope.

Coste10 créditos por llamadaPrueba en línea

Prompts y casos de uso de Acceso a la API 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. Cuentas de anuncios conectados

Prompt: Lista mis conexiones Amazon Ads existentes y su estado devuelto. No mostrar credenciales.

2. Encontrar perfiles publicitarios

Prompt: Mostrar los perfiles de mi conexión Amazon Ads [CONNECTION_ID].

3. Conectar una cuenta de publicidad

Prompt: Preparar una Amazonía Solicitud de autorización de anuncios [MARKETPLACE] dentro [ADS_REGION], etiquetado [ACCOUNT_NAME]. Permítanme completar la autorización antes de tratar la cuenta como conectada.

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.

Los ejemplos de múltiples solicitudes tienen un punto de parada explícito. Deje de cometer un error o falta de información requerida en lugar de continuar indefinidamente.

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_api_access

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-api-access-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_ads_api_access",
    "arguments": {
      "accountName": "US Ads account",
      "marketplaceId": "ATVPDKIKX0DER",
      "operation": "authorize",
      "region": "NA"
    }
  }
}

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
`operation`	`string`	obligatorio	Operación: autorizaciones, conexiones o perfiles. Ejemplo: authorize
`region`	`string`	obligatorio	Se requiere cuando la operación=autorizar. Amazon Región de los anuncios: NA, EUo FE. Ejemplo: NA
`marketplaceId`	`string`	obligatorio	Se requiere cuando la operación=autorizar. Identificador de mercado Amazon. Ejemplo: ATVPDKIKX0DER
`accountName`	`string`	opcional	Nombre de pantalla opcional para la solicitud de autorización. Ejemplo: US Ads account
`connectionId`	`integer`	opcional	Se requiere cuando la operación=profiles. Owned Amazon Conexión de anuncios ID. Ejemplo: 123

Campos de respuesta

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

Nombre	Tipo	Obligatorio	Descripción
`authorizeUrl`	`string`	opcional	Amazon Ads OAuth autorización URL.
`sourceType`	`string`	opcional	identificador de fuente de autorización, fijo a `amazon_ads`.

Preguntas y respuestas de ejemplo

Se basa en una muestra de la documentación publicada, no en una llamada en vivo a la herramienta.

Tu pregunta

Que Amazon ¿Los perfiles de anuncios están conectados a esta cuenta?

Respuesta de ejemplo

La muestra publicada incluye perfiles para Canadá y México, con CAD y MXN como sus respectivas monedas. Utilice el perfil y la información de mercado para seleccionar la cuenta prevista antes de solicitar datos de publicidad.

Sobre esta muestra: Esta muestra publicada lista perfiles; no crea una autorización o prueba que su propia cuenta está conectada. Los identificadores de cuenta en la muestra no son credenciales para su uso.

Ver los datos de ejemplo publicados (JSON)

Ejemplo de datos REST publicado. Para llamar a esta herramienta, consulta los argumentos MCP en Parámetros y respuesta.

Ejemplo de datos

Ejemplo de solicitud y respuesta

Parámetros de solicitud

{
  "operation": "profiles",
  "connectionId": 10
}

Respuesta

{
  "code": 0,
  "msg": null,
  "data": [
    {
      "profileId": "80709749500065",
      "countryCode": "CA",
      "currencyCode": "CAD",
      "timezone": "America/Los_Angeles",
      "accountInfo": {
        "marketplaceStringId": "A2EUQ1WTGCTBG2",
        "id": "ENTITY1L6MZ8B055950",
        "type": "vendor",
        "name": "Sponsored ads - Author",
        "subType": "KDP_AUTHOR",
        "validPaymentMethod": true
      }
    },
    {
      "profileId": "3369222288860367",
      "countryCode": "MX",
      "currencyCode": "MXN",
      "timezone": "America/Los_Angeles",
      "accountInfo": {
        "marketplaceStringId": "A1AM78C64UM0Y8",
        "id": "ENTITY11HAVXK82QGOU",
        "type": "vendor",
        "name": "Sponsored ads - Author",
        "subType": "KDP_AUTHOR",
        "validPaymentMethod": false
      }
    },
    {
      "profileId": "699934390553823",
      "countryCode": "US",
      "currencyCode": "USD",
      "timezone": "America/Los_Angeles",
      "accountInfo": {
        "marketplaceStringId": "ATVPDKIKX0DER",
        "id": "ENTITY35S2BEWB4ANCK",
        "type": "vendor",
        "name": "Annunci sponsorizzati - KDP",
        "subType": "KDP_AUTHOR",
        "validPaymentMethod": true
      }
    }
  ]
}

Ver el formato de solicitud y respuesta MCP

Ejemplos