Bota Over Mercado Livre

O que é e como funciona na prática

A ferramenta que todo mundo chama de bota over mercado livre é basicamente um script ou automação que permite gerenciar anúncios, atualizar estoques, mover produtos entre categorias e fazer outras operações no Mercado Livre sem precisar clicar em tudo manualmente pela interface web. Eu comecei a usar isso em 2019 quando minha conta cresceu pra mais de 4000 anúncios ativos e eu gastava cerca de duas horas por dia só reagindo preços e movendo estoque. O tempo caiu pra uns 15 minutos com o script rodando. O funcionamento básico gira em torno de duas abordagens. A primeira é via API oficial do Mercado Livre, que te dá acesso programático a listar, editar, consultar estoques e pedidos. A segunda é automação de navegador, que simula cliques humanos numa interface real. Cada uma tem prós e contras que vou explicar sem romantizar.

Bot Over Mercado Livre: o que realmente acontece por baixo

Quando você roda um bota over mercado livre, o que está acontecendo é uma série de requisições HTTP autenticadas com o token da sua conta, ou então um Puppeteer/Playwright controlando um navegador cabeça-certa. A via da API é mais limpa e não bane conta. A via de automação de navegador é mais frágil porque o Mercado Livre muda o front-end frequentemente e seu script quebra quando eles reposicionam um elemento na página. A autenticação na API funciona assim: você cria um app no Developers Marketplace do Mercado Livre, pega o client ID e client secret, faz o fluxo OAuth, e pronto. O token de acesso tem validade de 6 horas. Todo mundo esquece disso na primeira vez e leva um banimento indireto quando o token expira e as requisições voltam com erro 401 em lote. Eu configurei um refresh automático e resuelvi.

Como configurar passo a passo

Vou mostrar o caminho pela API porque é o que funciona de verdade a longo prazo. Se você quer automação visual por algum motivo específico, pode pular mas recomendo não. Passo 1: Acesse developers.mercadolivre.com.br e crie uma conta de desenvolvedor. Conecte sua conta de vendedor. Crie um novo app e anote o client ID e client secret. Defina o redirect URI como http://localhost se for teste local. Passo 2: Pegue a URL de autorização. No Python, fica algo como montar a string com o client ID, o escopo read write e o redirect URI. Abra no navegador, autorize o app, e o Mercado Livre vai te redirecionar de volta com um código de autorização na URL.

Passo 3: Troque esse código por um token de acesso. A requisição é POST pra https://api.mercadolibre.com/oauth/token com grant_type client_credentials ou authorization_code dependendo do fluxo. Você recebe access_token e refresh_token. Guarde os dois. Passo 4: Comece a fazer requisições. Para listar seus anúncios, GET /items/search?seller=SEU_USER_ID&access_token=SEU_TOKEN. Para atualizar preço, PUT /items/{ITEM_ID} com o body JSON contendo o campo price. Para estoque, o mesmo endpoint com o campo quantity. Um script básico em Python comrequests e schedule leva uns 200 linhas pra cobrir as operações comuns: sincronizar preço, ajustar estoque, buscar itens desativados e reativar. Eu uso um loop que roda a cada 5 minutos e compara o preço de referência de alguns concorrentes antes de decidir se abaixa ou mantém.

Problema real que eu enfrentei e o workaround

Em outubro de 2023, meu script de atualização de estoque parou de funcionar de forma intermitente. O Mercado Livre retornava 200 OK mas o estoque não era atualizado. Eu passei dois dias achando que era bug no meu código. Descobri que era o campo variation_specifics_id que tinha mudado de structure pra integer em uma atualização silenciosa deles. Eu estava enviando um array quando agora era esperado um inteiro simples. A solução foi fazer um GET no item antes de cada PUT e validar a estrutura das variações antes de montar o payload. Esse tipo de coisa acontece todo mês. Anotação: sempre faça get antes de put em items com variações. O bota over mercado livre não resolve tudo. Tem restrições que você precisa saber antes de confiar cegamente no script. Primeiro, a API tem rate limit. O padrão é algo em torno de 100 requisições por segundo por token, mas o Mercado Livre aplica rate limiting dinâmico baseado no comportamento. Se você fizer 500 PUTs de preço em 30 segundos, sua conta vai receber um throttling temporário que pode durar de 10 minutos a 2 horas. Eu aprendi isso na carne quando tentei atualizar 3000 itens de uma vez e travou minha conta por 47 minutos no meio do dia de venda.

Segundo, a API não expõe todas as operações que existem na interface web. Não dá pra criar anúncio do zero via API da forma simples que muitos esperam. O processo de listagem pela API exige construir um objeto item inteiro com title, description HTML, pictures, variations, shipping, e isso é muito mais trabalhoso do que simplesmente preencher um formulário. Muitas pessoas escolhem automação de navegador pra criar anúncios justamente por isso. Mas aí volta o risco de detecção e banimento. Terceiro, a sincronização de categoria e atributos é um problema crônico. Quando você move um item de categoria por automação, os attributes obrigatórios da nova categoria podem sumir e o anúncio fica com warnings que não aparecem pros compradores mas aparecem pra você quando entra na aba de saúde do anúncio. Eu tenho um mapeamento manual de categoria pra attributes que rodo antes de qualquer movimentação. Quarto, o Mercado Livre bloqueia contas que apresentam comportamento não humano identificado. Se seu bot der update de preço a cada 30 segundos sem variações reais de mercado, ou se atualizar estoque de itens que nunca foram vendidos, o sistema de detecção de anomalia pode flagrar sua conta. A recomendação é manter intervalos realistas e logs de cada ação pra poder justificar se precisar abrir reclamação.

Alternativas e quando não usar

Se seu volume é baixo, abaixo de 500 anúncios, o bota over mercado livre pode ser overkill. O próprio Mercado Livre tem integrações nativas com ERP e tools de marketplace como Bling, Tiny, Vloox que já fazem sincronização de preço e estoque sem risco de banimento. Eu migrei metade dos meus clientes pra essas plataformas e só mantive o script customizado pro que elas não fazem: monitoramento de preço de concorrentes em tempo real e reajuste baseado em margem mínima configurável. Se você decide ir pra automação de navegador, use headless mode, adicione delays aleatórios entre ações, e nunca rode mais de 20 operações por minuto. O risco vale a pena só quando a API não oferece o que você precisa de fato.

Conexão prática com bota over mercado livre no dia a dia

O que separa quem usa isso bem de quem perde a conta é a parte de logging e rollback. Cada ação do script deve ser registrada com timestamp, item ID, ação executada, status da resposta e o payload enviado. Quando algo dá errado, você consegue reverter manualmente em minutos. Sem log, você gasta horas tentando entender qual atualização quebrou o quê. Outro detalhe técnico importante: use o campo internal_metadata pra salvar informações internas no item, como o último preço de mercado observado ou a data da última sincronização. Isso evita que você precise manter um banco de dados externo pra tudo e simplifica bastante o loop de decisão do script. O código fonte que eu uso não é público porque tem lógica proprietária de precificação, mas a estrutura base com autenticação OAuth, rate limiting com retry exponencial, e parsing de erro 429 pra backoff é amplamente disponível em repositórios genéricos de Mercado Livre API. A parte que faz diferença é o tratamento de edge cases que a documentação oficial não cobre.