Servidor MCP de Amazon Ads

Un servidor del Protocolo de Contexto de Modelos (MCP) que proporciona herramientas para interactuar con la API de Publicidad de Amazon. Este servidor permite a los asistentes de IA acceder y gestionar campañas de Amazon Ads, palabras clave, datos de rendimiento y más.

Características

Este servidor MCP proporciona las siguientes herramientas:

• get_profiles: Listar todos los perfiles/cuentas disponibles de Amazon Ads

• get_campaigns: Recuperar campañas publicitarias con filtrado opcional por estado y tipo

• get_campaign_performance: Obtener métricas de rendimiento de las campañas (impresiones, clics, coste, ventas)

• get_keywords: Recuperar palabras clave para campañas o grupos de anuncios

• update_keyword_bid: Actualizar los importes de puja para palabras clave específicas

• create_campaign: Crear nuevas campañas publicitarias

• get_product_ads: Recuperar anuncios de productos para campañas o grupos de anuncios

Related MCP server: TikTok Ads MCP Server

Requisitos previos

1. Cuenta de Amazon Ads: Necesitas una cuenta activa de Amazon Ads

2. Credenciales de API: Regístrate para obtener acceso a la API de Amazon Ads y obtén:

   • ID de cliente

   • Secreto de cliente

   • Token de actualización

Cómo obtener las credenciales de la API de Amazon Ads

Paso 1: Registra tu aplicación

1. Ve a Amazon Advertising API

2. Inicia sesión con tu cuenta de Amazon Ads

3. Navega al Centro de desarrolladores y crea una nueva aplicación

4. Recibirás un ID de cliente y un Secreto de cliente: ¡guárdalos!

Paso 2: Obtén tu token de actualización

Proporcionamos un script auxiliar para obtener tu token de actualización mediante el flujo OAuth:

1. Crea un archivo .env en la raíz del proyecto:

   AMAZON_ADS_CLIENT_ID=your_client_id_here
   AMAZON_ADS_CLIENT_SECRET=your_client_secret_here

2. Ejecuta el script auxiliar de OAuth:

   npm run get-token

3. Tu navegador se abrirá en la página de autorización de Amazon

4. Inicia sesión y autoriza la aplicación

5. El script mostrará tu token de actualización: cópialo en tu archivo .env

Paso 3: Anota tu región

Determina tu región publicitaria:

• NA: América del Norte (amazon.com)

• EU: Europa (amazon.co.uk, amazon.de, etc.)

• FE: Extremo Oriente (amazon.co.jp, etc.)

Instalación

1. Clona este repositorio:

git clone <your-repo-url>
cd amazonads-mcp

2. Instala las dependencias:

npm install

3. Compila el proyecto:

npm run build

Configuración

Variables de entorno

Crea un archivo .env o define las siguientes variables de entorno:

AMAZON_ADS_CLIENT_ID=your_client_id
AMAZON_ADS_CLIENT_SECRET=your_client_secret
AMAZON_ADS_REFRESH_TOKEN=your_refresh_token
AMAZON_ADS_REGION=NA  # Options: NA, EU, FE
AMAZON_ADS_SANDBOX=false  # Set to true for testing with sandbox API

Configuración de Claude Desktop

Añade este servidor a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazonads": {
      "command": "node",
      "args": ["/absolute/path/to/amazonads-mcp/build/index.js"],
      "env": {
        "AMAZON_ADS_CLIENT_ID": "your_client_id",
        "AMAZON_ADS_CLIENT_SECRET": "your_client_secret",
        "AMAZON_ADS_REFRESH_TOKEN": "your_refresh_token",
        "AMAZON_ADS_REGION": "NA"
      }
    }
  }
}

Ejemplos de uso

Una vez configurado en Claude Desktop, puedes pedir a Claude que:

• "Muéstrame todas mis campañas de Amazon Ads"

• "¿Cuáles son las métricas de rendimiento de la campaña ID 12345 del 1 de enero al 31 de enero?"

• "Lista todas las palabras clave de la campaña 12345"

• "Actualiza la puja de la palabra clave 67890 a $1.50"

• "Crea una nueva campaña de Productos patrocinados con un presupuesto diario de $50"

• "Muéstrame todos los anuncios de productos de la campaña 12345"

Desarrollo

Estructura del proyecto

amazonads-mcp/
├── src/
│   ├── index.ts              # Main MCP server implementation
│   └── amazon-ads-client.ts  # Amazon Ads API client
├── build/                     # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Compilación

npm run build

Modo de desarrollo

Vigila los cambios y recompila automáticamente:

npm run watch

Probar el servidor

Ejecuta el servidor directamente:

npm start

El servidor se comunica a través de stdio y espera mensajes del protocolo MCP.

Cobertura de la API

Este servidor admite actualmente:

• Productos patrocinados: Soporte completo para campañas, palabras clave y anuncios de productos

• Marcas patrocinadas: Gestión de campañas (soporte parcial)

• Display patrocinado: Gestión de campañas (soporte parcial)

• Informes: Métricas de rendimiento básicas (implementación simplificada)

Notas importantes

1. Límite de velocidad: La API de Amazon Ads tiene límites de velocidad. El cliente actualmente no implementa lógica de limitación de velocidad.

2. API de informes: La herramienta get_campaign_performance utiliza una implementación simplificada. Para uso en producción, deberías implementar el flujo completo de informes asíncronos:

   • Crear la solicitud de informe

   • Consultar la finalización del informe

   • Descargar y analizar el informe

3. Manejo de errores: Los errores de la API se devuelven al llamador. Asegura una configuración correcta de las credenciales para evitar errores de autenticación.

4. Regiones: Asegúrate de configurar la región correcta (NA, EU, FE) según tu cuenta de Amazon Ads.

Seguridad

• Nunca subas tu archivo .env ni expongas las credenciales de API

• Los tokens de actualización deben almacenarse de forma segura

• Considera implementar la rotación de credenciales para uso en producción

Recursos

• Documentación de la API de Amazon Ads

• Documentación del Protocolo de Contexto de Modelos

• SDK de TypeScript de MCP

Licencia

MIT

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).