avito-mcp-ru

avito-mcp-ru

API da Avito para assistentes de IA: anúncios e estatísticas, chats com compradores, pedidos e Avito Delivery, upload automático, promoção, avaliações. O catálogo é executado pelo servidor.

O pacote sobe um único servidor, o da Avito, e nada mais. O servidor, o catálogo e o núcleo vêm como dependência de marketplaces-mcp-ru: aqui estão o nome, o ponto de entrada e a documentação para um único marketplace.

Instalação

O primeiro release no PyPI é publicado com a tag v0.5.3; até lá, o pacote é instalado diretamente do repositório:

uvx --from git+https://github.com/ilyautov/avito-mcp-ru avito-mcp-ru

Após o release, o comando fica mais curto:

uvx avito-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "avito": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ilyautov/avito-mcp-ru", "avito-mcp-ru"],
      "env": { "AVITO_CLIENT_ID": "...", "AVITO_CLIENT_SECRET": "..." }
    }
  }
}

O terceiro caminho, se o agente suporta skills: ele instala o servidor e configura o cliente sozinho.

npx skills add ilyautov/avito-mcp-ru

Chaves

Onde obter o par. Em avito.ru: Para empresas, seção Integrações, item API. Lá são emitidos client_id e client_secret. O host das requisições é api.avito.ru.

Como isso vira um token. O par é trocado por um access-token via OAuth2, com validade limitada. O servidor renova o token automaticamente; não é preciso reemitir nada manualmente.

Onde tudo fica armazenado. Em ~/.marketplace-mcp/cabinets.json com permissões chmod 600, localmente.

variável	segredo	o que é
AVITO_CLIENT_ID	sim	client_id da seção Para empresas → Integrações → API.
AVITO_CLIENT_SECRET	sim	client_secret de lá mesmo, trocado por token via OAuth2.

As chaves não precisam ficar no ambiente: o servidor suporta contas e as guarda em ~/.marketplace-mcp/cabinets.json com permissões 600, fora do repositório. É possível conectar quantas lojas forem necessárias, com a troca feita direto pelo chat.

Mapa de métodos

O catálogo está na dependência como avito_mcp/endpoints.yaml: 64 métodos, sendo 40 de leitura, 22 de escrita e 2 irreversíveis. O servidor executa exatamente esse arquivo, então a tabela não pode divergir do código.

tema	métodos	leitura	escrita	irreversíveis
Mensageiro (chats com compradores)	13	5	7	1
Upload automático (envio de anúncios por arquivo)	12	10	2	0
Pedidos e Avito Delivery	12	6	6	0
Anúncios e estatísticas	11	7	4	0
Promoção de anúncios (publicidade)	7	6	1	0
Avaliação e comentários	4	2	1	1
Usuário, saldo e operações	3	3	0	0
Estoque em anúncios	2	1	1	0

Análise detalhada com parâmetros e limites: https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html

O que perguntar no chat

• mostre as estatísticas dos anúncios da semana
• quais pedidos de Avito Delivery estão em andamento
• colete as mensagens não lidas do mensageiro
• atualize o estoque dos anúncios

Erros comuns

401 depois de tudo funcionando. O token da Avito tem validade limitada. Se a requisição for feita fora do servidor, com código próprio, o token precisa ser renovado; pelo servidor, isso acontece automaticamente.

403 em um método que existe na documentação. Na Avito, o acesso às seções é concedido mediante solicitação e não é igual para todas as contas. O mensageiro e a Avito Delivery não são liberados para qualquer negócio.

Erro no nome do campo. O catálogo foi montado a partir de documentos oficiais; a execução em contas reais ainda não foi feita. describe_method mostra o esquema, call_raw permite ajustar a requisição na hora.

Diferença para marketplaces-mcp-ru

Nenhuma, exceto a composição. marketplaces-mcp-ru instala quatro marketplaces de uma vez e os mantém sob um único servidor; avito-mcp-ru instala apenas um. O código é compartilhado: uma correção no núcleo chega aqui via atualização da dependência, e não por cópia.

necessidade	pacote
apenas Avito	avito-mcp-ru
todos os quatro marketplaces	marketplaces-mcp-ru

Quem fez

Ilya Utov, laboratório AI Frontier. Sobre como essas ferramentas funcionam internamente, escrevo no Telegram e no LinkedIn.

Ao lado estão business-mcp-ru (hh.ru, VK, Diadoc, SBIS, Chestny ZNAK), moysklad-mcp-ru e humanizer-ru.

Todos os projetos em uma lista, organizados por finalidade: ilyautov.github.io.

Licença

MIT, veja LICENSE.