mcp-avito-ads

Авито Реклама MCP

A1 Авито Реклама MCP conecta um aplicativo de IA ao painel de publicidade do Avito Ads. Ele ajuda a verificar campanhas e estatísticas, gerenciar orçamento e lance de grupo, trabalhar com saldos de agência, acessos e documentos ORD — em linguagem natural.

Esta não é a API do vendedor do Avito: o servidor não trabalha com produtos, mensagens, pedidos ou promoção de anúncios do vendedor. Ele trabalha apenas com campanhas de mídia e performance do painel de publicidade do Avito Ads.

• 25 ferramentas. Campanhas, grupos, criativos, estatísticas, saldo, contas filhas, usuários e documentos ORD.
• Alterações limitadas de campanhas. A API permite alterar apenas orçamento e lance de grupo; não é possível criar, editar, pausar ou excluir campanhas, grupos e criativos.
• Operações irreversíveis são visíveis. Transferência de dinheiro ou bônus, exclusão de usuário e solicitação técnica de API são marcadas como destrutivas.
• Orçamento semanal de API. Cada chamada consome pontos; o saldo restante de apiPointBalance é retornado pelo servidor junto com o resultado.

Comece com uma solicitação que apenas lê dados:

Mostre as campanhas da minha conta Avito e os gastos da semana passada por grupos de anúncios.

Conectar servidor · Ver cenários · Abrir documentação técnica

Veja o funcionamento em um minuto

Você: Mostre as campanhas da minha conta Avito e os gastos da semana passada por grupos de anúncios.

Assistente: Mostra campanhas, grupos, gastos, cliques e impressões. Nada é alterado.

Você: Prepare a alteração do lance do grupo 101 para 350 rublos.

Assistente: Mostra conta, grupo, lance atual e novo, e então solicita confirmação.

Você: Confirmo.

Assistente: Altera o lance apenas desse grupo. Campanha, criativos e outros grupos não são alterados.

Conteúdo

• Início rápido
• O que pode ser delegado
• O que pode mudar
• Obtendo acesso
• Configuração
• Dados, limites e trabalho em segundo plano
• Documentação técnica
• Suporte

Início rápido

São necessários Node.js 20+, Client Key, Client Secret e o ID da conta de publicidade do Avito Ads. Para emitir acessos, é necessário o papel de administrador da conta.

1. Obtenha acesso.
2. Adicione o servidor ao aplicativo de IA.
3. Envie a primeira solicitação segura acima.

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 рекламного аккаунта"}]}

O que pode ser delegado

• Mostre campanhas, grupos, criativos, status e estatísticas do período.
• Compare gastos, CTR, CPM, CPC ou VTR por grupos e criativos.
• Verifique o saldo e as contas filhas da agência.
• Prepare a alteração de orçamento ou lance de um grupo.
• Crie anunciante e contrato ORD, primeiro mostrando os dados enviados.
• Adicione usuário, altere o papel ou revogue o acesso após confirmação.

O que pode mudar

Campanhas, grupos e criativos não podem ser criados, editados, pausados, arquivados ou excluídos por esta API. Criativos e segmentações também não estão disponíveis para escrita.

Obtendo acesso

1. Abra o painel do Avito Ads com um usuário com papel de administrador.
2. Crie um aplicativo de API e copie o Client Key e o Client Secret.
3. Copie o ID da conta de publicidade.
4. Envie-os como AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

O servidor obtém o Bearer token via OAuth2 client_credentials. Armazene o Client Secret como senha. O ID da conta é definido pela configuração: as ferramentas não poderão mudar acidentalmente para outra conta.

Para ensaiar gravações, você pode definir AVITO_ADS_ENVIRONMENT=sandbox. A sandbox não é uma cópia completa da produção: por exemplo, o saldo não está disponível lá.

Configuração

Dados, limites e trabalho em segundo plano

• Orçamento semanal de pontos. Os pontos são renovados na segunda-feira às 00:00 UTC. Um relatório longo de até 100 dias geralmente é mais econômico do que uma série de relatórios curtos; o servidor mostra apiPointBalance com cada resultado.
• Erros temporários. Em caso de 429, a resposta de erro retorna Retry-After e o saldo de pontos. Gravações não são repetidas após erro de rede ou 5xx, para não transferir dinheiro duas vezes.
• Sem monitoramento contínuo. O servidor funciona apenas quando chamado. Se o aplicativo de IA suportar tarefas agendadas, ele pode coletar estatísticas e saldo de pontos periodicamente.
• Telemetria anônima. Segredos, dados da conta, argumentos e prompts não são incluídos; desativação: ASKADS_TELEMETRY=0.

Documentação técnica

• Catálogo de recursos MCP — páginas por tarefas de usuário para cada ferramenta.
• Todas as ferramentas e parâmetros
• Documentação de desenvolvimento
• Documentação de publicação
• SDK oficial do Avito Ads

Suporte

Encontrou um erro ou falta um cenário? Crie uma issue ou escreva no Telegram.

Você chegou ao final!