mcp-avito-ads

Avito Ads MCP

A1 Avito Ads MCP conecta una aplicación de IA al panel publicitario de Avito Ads. Ayuda a consultar campañas y estadísticas, gestionar el presupuesto y la oferta de grupos, trabajar con saldos de agencia, accesos y documentos ORD — en lenguaje natural.

No es la API de vendedor de Avito: el servidor no trabaja con productos, mensajes, pedidos ni promoción de anuncios de vendedor. Solo trabaja con campañas de display y performance del panel publicitario de Avito Ads.

• 25 herramientas. Campañas, grupos, creatividades, estadísticas, saldo, cuentas hijas, usuarios y documentos ORD.
• Cambios limitados en campañas. La API solo permite modificar el presupuesto y la oferta de grupo; no se pueden crear, editar, pausar ni eliminar campañas, grupos o creatividades.
• Operaciones irreversibles visibles. Transferencias de dinero o bonos, eliminación de usuarios y solicitudes técnicas a la API están marcadas como destructivas.
• Presupuesto semanal de API. Cada llamada consume puntos; el saldo restante apiPointBalance el servidor lo devuelve junto con el resultado.

Comienza con una solicitud que solo lea datos:

Muestra las campañas de mi cuenta de Avito y el gasto de la semana pasada por grupos de anuncios.

Conectar servidor · Ver escenarios · Abrir documentación técnica

Ver el funcionamiento en un minuto

Tú: Muestra las campañas de mi cuenta de Avito y el gasto de la semana pasada por grupos de anuncios.

Asistente: Muestra campañas, grupos, gasto, clics e impresiones. No cambia nada.

Tú: Prepara el cambio de oferta del grupo 101 a 350 rublos.

Asistente: Muestra la cuenta, el grupo, la oferta actual y la nueva, y luego solicita confirmación.

Tú: Confirmo.

Asistente: Cambia la oferta solo de ese grupo. La campaña, las creatividades y otros grupos no cambian.

Contenido

• Inicio rápido
• Qué se puede encargar
• Qué puede cambiar
• Obtención de acceso
• Configuración
• Datos, límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Se necesitan Node.js 20+, Client Key, Client Secret y el ID de la cuenta publicitaria de Avito Ads. Para otorgar accesos se requiere el rol de administrador de la cuenta.

1. Obtén acceso.
2. Añade el servidor a la aplicación de IA.
3. Envía la primera solicitud segura de arriba.

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

Qué se puede encargar

• Muestra campañas, grupos, creatividades, estados y estadísticas por período.
• Compara gasto, CTR, CPM, CPC o VTR por grupos y creatividades.
• Consulta el saldo y las cuentas hijas de la agencia.
• Prepara el cambio de presupuesto o de oferta de un solo grupo.
• Crea un anunciante y un contrato ORD, mostrando primero los datos que se enviarán.
• Añade un usuario, cambia su rol o revoca el acceso tras la confirmación.

Qué puede cambiar

Las campañas, grupos y creatividades no se pueden crear, editar, pausar, archivar ni eliminar a través de esta API. Las creatividades y segmentaciones tampoco están disponibles para escritura.

Obtención de acceso

1. Abre el panel de Avito Ads con un usuario con rol de administrador.
2. Crea una aplicación API y copia el Client Key y el Client Secret.
3. Copia el ID de la cuenta publicitaria.
4. Pásalos como AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

El servidor obtiene el Bearer token mediante OAuth2 client_credentials. Guarda el Client Secret como una contraseña. El ID de cuenta está fijado por configuración: las herramientas no podrán cambiar accidentalmente a otra cuenta.

Para ensayar escrituras se puede definir AVITO_ADS_ENVIRONMENT=sandbox. El sandbox no es una copia completa de producción: por ejemplo, el saldo no está disponible allí.

Configuración

Datos, límites y trabajo en segundo plano

• Presupuesto semanal de puntos. Los puntos se recargan los lunes a las 00:00 UTC. Un informe largo de hasta 100 días suele ser más eficiente que una serie de informes cortos; el servidor muestra apiPointBalance con cada resultado.
• Errores temporales. Ante un 429, en el error se devuelven Retry-After y el saldo de puntos. Las escrituras no se repiten tras un error de red o 5xx, para no transferir dinero dos veces.
• No hay supervisión continua. El servidor solo funciona cuando se le llama. Si la aplicación de IA admite tareas programadas, puede recopilar estadísticas y saldo de puntos periódicamente.
• Telemetría anónima. No incluye secretos, datos de cuenta, argumentos ni prompts; desactivación: ASKADS_TELEMETRY=0.

Documentación técnica

• Catálogo de capacidades MCP — páginas por tareas de usuario para cada herramienta.
• Todas las herramientas y parámetros
• Documentación de desarrollo
• Documentación de publicación
• SDK oficial de Avito Ads

Soporte

¿Encontraste un error o falta un escenario? Crea un issue o escribe a Telegram.

¡Has llegado al final!