Mercadolivre Scraper (Brasil português)

🌎 Mercadolivre Scraper

Extraia dados valiosos do MercadoLivre Brasil

O Mercadolivre Scraper transforma resultados públicos do MercadoLivre Brasil em dados estruturados para monitoramento de preços, pesquisa de produtos, inteligência competitiva, automação de e-commerce e análise de mercado.

Pesquise por palavra-chave ou ative o modo Ofertas do Dia para coletar títulos, imagens, preços, descontos, cupons, parcelamento, vendas, frete, vendedores, avaliações, identificadores do anúncio, posição nos resultados e outros atributos públicos.

Marketplace: Brasil (mercadolivre.com.br)
Actor ID: karamelo/mercadolivre-scraper-brasil-portugues
Saídas: JSON, JSONL, CSV, Excel, XML e RSS pelo Dataset da Apify

Por que coletar dados do MercadoLivre?

• Monitorar preços, descontos, cupons e condições de pagamento.
• Comparar vendedores, lojas oficiais, marcas e produtos concorrentes.
• Avaliar quantidade vendida, avaliações e posição nos resultados.
• Descobrir tendências, ofertas, produtos mais vendidos e oportunidades de catálogo.
• Criar históricos de preço e datasets para BI, IA, RAG e agentes autônomos.

Dados que o Mercadolivre Scraper pode extrair

• Nome, imagem, marca e URL do produto.
• Preço atual, preço anterior, moeda e desconto.
• Cupons, promoções e parcelamento.
• Quantidade vendida, avaliação e número de avaliações.
• Frete grátis, texto de entrega, disponibilidade e origem do envio.
• Vendedor, loja oficial, localização e ID do vendedor.
• IDs de publicação, catálogo, produto do usuário e variação.
• Categoria, domínio, vertical, posição e tipo de resultado.
• Indicadores de compra internacional, preço por quantidade e anúncio patrocinado.
• Ano, quilometragem, entrada e transmissão para resultados da vertical MOTORS.

Alguns campos dependem do que o MercadoLivre apresenta publicamente em cada resultado. Valores indisponíveis podem ser retornados como texto vazio, null ou false. Os campos de veículos aparecem somente em resultados MOTORS.

Como usar

1. Abra o Mercadolivre Scraper na Apify.
2. Informe uma palavra-chave em keyword ou marque scrapeOfertas.
3. Defina o limite de páginas.
4. Escolha a ordenação: Mais relevantes, Menor preço ou Maior preço.
5. Escolha se deseja incluir produtos patrocinados.
6. Inicie a execução e abra o Dataset ao finalizar.

Exemplo de busca

{
  "keyword": "notebook gamer",
  "maxPages": 3,
  "scrapeOfertas": false,
  "promoted": false
}

Exemplo de Ofertas do Dia

{
  "scrapeOfertas": true,
  "maxPagesOfertas": 2,
  "ofertasFilter": "all",
  "promoted": false
}

Parâmetros de entrada

Campo	Tipo	Obrigatório	Descrição
keyword	string	Para busca	Termo pesquisado. É ignorado no modo Ofertas do Dia.
sort	string	Não	Ordenação dos resultados: Mais relevantes, Menor preço ou Maior preço.
maxPages	integer	Não	Máximo de páginas da busca por palavra-chave. Mínimo: 1.
scrapeOfertas	boolean	Não	Ativa a coleta de https://www.mercadolivre.com.br/ofertas.
maxPagesOfertas	integer	Não	Máximo de páginas no modo Ofertas do Dia.
ofertasFilter	string	Não	Filtro reservado para ofertas. Atualmente aceita all.
promoted	boolean	Não	false exclui produtos patrocinados; true permite incluí-los.

O marketplace brasileiro é usado nativamente. Não é necessário informar país ou URL-base.

Exemplo de resultado

{
  "imagemLink": "https://http2.mlstatic.com/D_NQ_NP_EXAMPLE-O.webp",
  "Moeda": "BRL",
  "novoPreco": "4299",
  "precoAnterior": "4999",
  "precoDiscount": "14% OFF",
  "eTituloProduto": "Notebook Gamer 16 GB RAM SSD 512 GB",
  "installments": "10x sem juros",
  "promocoes": "Cupom R$ 200 OFF",
  "quantidadeVendida": 500,
  "freteGratis": true,
  "is_inStock": null,
  "Vendedor": "LOJA EXEMPLO",
  "lojaOficial": true,
  "SKU": "MLB12345678",
  "idPublicacao": "MLB1234567890",
  "idProdutoCatalogo": "MLB12345678",
  "idProdutoUsuario": "MLBU1234567890",
  "idVariacao": "MLB12345678",
  "tipoResultado": "ORGANIC",
  "ePrecoPorQuantidade": false,
  "eCompraInternacional": false,
  "palavraChave": "notebook gamer",
  "produtoReviews": "4.8",
  "numeroAvaliacoes": 320,
  "posicaoItem": 1,
  "resultadosTotais": "+10.000 resultados",
  "zProdutoLink": "https://www.mercadolivre.com.br/p/MLB12345678",
  "envio": "Frete grátis Enviado pelo FULL",
  "highlight": "MAIS VENDIDO",
  "disponivelEm": "Disponível em outras cores",
  "enviadoDe": "São Paulo",
  "produtoMarca": "Marca Exemplo",
  "produtoCategoryID": "MLB1648",
  "produtoDomainID": "MLB-NOTEBOOKS",
  "vendedorID": "123456789",
  "vertical": "CORE",
  "verticalID": "CORE",
  "localizacao": "São Paulo",
  "Tempo": "2026-08-01T12:00:00.000Z",
  "patrocinado": ""
}

Para um resultado MOTORS, também podem aparecer:

{
  "veiculoAno": "2024",
  "veiculoQuilometragem": "32.000 km",
  "antecipacao": 25000,
  "transmissao": "Automática"
}

Dicionário dos campos

Grupo	Campos
Produto	eTituloProduto, imagemLink, zProdutoLink, produtoMarca
Preço	Moeda, novoPreco, precoAnterior, precoDiscount
Pagamento e promoções	installments, promocoes, antecipacao
Demanda e reputação	quantidadeVendida, produtoReviews, numeroAvaliacoes
Frete e disponibilidade	freteGratis, envio, disponivelEm, enviadoDe, is_inStock
Vendedor	Vendedor, vendedorID, lojaOficial, localizacao
Identificadores	SKU, idPublicacao, idProdutoCatalogo, idProdutoUsuario, idVariacao
Classificação	produtoCategoryID, produtoDomainID, vertical, verticalID
Ranking	palavraChave, posicaoItem, resultadosTotais, tipoResultado, patrocinado
Sinais comerciais	highlight, ePrecoPorQuantidade, eCompraInternacional
Veículos	veiculoAno, veiculoQuilometragem, antecipacao, transmissao
Auditoria	Tempo

quantidadeVendida e resultadosTotais são sinais públicos e podem ser resumidos ou arredondados pelo marketplace.

Executar pela API da Apify

Nos exemplos abaixo, substitua APIFY_TOKEN pelo seu token da Apify.

JavaScript / Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('karamelo/mercadolivre-scraper-brasil-portugues').call({
  keyword: 'notebook gamer',
  maxPages: 3,
  scrapeOfertas: false,
  promoted: false,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Instale o cliente com npm install apify-client.

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('karamelo/mercadolivre-scraper-brasil-portugues').call(run_input={
    'keyword': 'notebook gamer',
    'maxPages': 3,
    'scrapeOfertas': False,
    'promoted': False,
})

items = list(client.dataset(run['defaultDatasetId']).iterate_items())
print(items)

Instale o cliente com pip install apify-client.

cURL síncrono

Nas URLs REST, substitua / no ID do Actor por ~.

curl -X POST \
  "https://api.apify.com/v2/actors/karamelo~mercadolivre-scraper-brasil-portugues/run-sync-get-dataset-items?format=json&clean=true" \
  -H "Authorization: Bearer APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "notebook gamer",
    "maxPages": 3,
    "scrapeOfertas": false,
    "promoted": false
  }'

cURL assíncrono

curl -X POST \
  "https://api.apify.com/v2/actors/karamelo~mercadolivre-scraper-brasil-portugues/runs" \
  -H "Authorization: Bearer APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"fone bluetooth","maxPages":2,"promoted":false}'

Depois, consulte defaultDatasetId:

curl "https://api.apify.com/v2/datasets/DATASET_ID/items?format=csv&clean=true" \
  -H "Authorization: Bearer APIFY_TOKEN"

MCP e agentes de IA

Disponibilize o Mercadolivre Scraper como ferramenta em um cliente MCP compatível:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=karamelo/mercadolivre-scraper-brasil-portugues"
    }
  }
}

Também é possível instalar a ferramenta em um cliente compatível usando a CLI da Apify:

$apify mcp install codex --tools karamelo/mercadolivre-scraper-brasil-portugues

Exemplo de prompt:

Execute o Mercadolivre Scraper para “smart TV 55” em cinco páginas,
sem produtos patrocinados. Compare preço, desconto, frete grátis,
quantidade vendida e avaliação por vendedor.

Preparar contexto compacto para um agente

const contextForAgent = items.map((item) => ({
  titulo: item.eTituloProduto,
  preco: item.novoPreco,
  moeda: item.Moeda,
  cupom: item.promocoes,
  vendidos: item.quantidadeVendida,
  freteGratis: item.freteGratis,
  avaliacao: item.produtoReviews,
  vendedor: item.Vendedor,
  destaque: item.highlight,
  url: item.zProdutoLink,
}));

x402

O x402 da Apify é experimental e depende da elegibilidade do Actor, do modelo de cobrança e das permissões da execução. Quando o Mercadolivre Scraper estiver habilitado, use o token pré-pago como Bearer token no endpoint síncrono do Actor. Caso contrário, utilize normalmente um token da Apify.

curl -X POST \
  "https://api.apify.com/v2/actors/karamelo~mercadolivre-scraper-brasil-portugues/run-sync-get-dataset-items" \
  -H "Authorization: Bearer X402_PREPAID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"notebook gamer","maxPages":2,"promoted":false}'

Automações e integrações

• Schedules: coletas por hora, dia ou semana para formar histórico de preços.
• Webhooks: notificações quando uma execução terminar ou falhar.
• Make e Zapier: envio do Dataset para outros aplicativos.
• Google Sheets e Excel: exportação CSV/XLSX para análises e dashboards.
• Data warehouses: carregamento em BigQuery, Snowflake, PostgreSQL e pipelines próprios.
• Agentes de IA: consumo via MCP, API ou clientes JavaScript e Python.

Boas práticas

• Comece com uma ou duas páginas para validar a consulta.
• Use promoted: false para estudos de posição orgânica.
• Preserve Tempo, palavraChave, posicaoItem e zProdutoLink no histórico.
• Trate novoPreco junto de Moeda.
• Use os IDs para deduplicação e relacionamento entre coletas.
• Valide campos opcionais antes de realizar cálculos.
• Não publique tokens, cookies ou credenciais em logs ou tickets.

Limitações

• O Actor coleta resultados públicos e não substitui a raspagem completa das páginas de detalhes.
• Estoque exato, avaliações individuais, perguntas, respostas e descrições longas podem não estar disponíveis.
• Quantidade vendida, total de resultados, frete e prazo podem ser estimativas ou textos resumidos.
• Layouts, testes A/B, localização e categoria podem alterar os campos apresentados.

Perguntas frequentes

Funciona somente no Brasil?

Sim. O marketplace brasileiro é configurado nativamente e não existe entrada de país.

É possível coletar Ofertas do Dia?

Sim. Defina scrapeOfertas como true e configure maxPagesOfertas.

O scraper extrai cupons?

Sim, quando o benefício aparece no resultado público, ele é retornado em promocoes.

Posso excluir produtos patrocinados?

Sim. Use promoted: false. Para incluí-los, use true.

Posso baixar CSV ou Excel?

Sim. Escolha o formato na página do Dataset ou use a API de itens do Dataset.

Uso responsável

Colete apenas dados públicos e respeite os termos aplicáveis, as leis de privacidade e as regras do marketplace. O Mercadolivre Scraper é um projeto independente e não é afiliado, patrocinado ou endossado pelo MercadoLivre ou pela Apify.

Suporte

Ao relatar um problema, inclua a palavra-chave ou o modo Ofertas, o limite de páginas, a opção promoted, o ID da execução e um exemplo do resultado esperado. Nunca compartilhe tokens ou credenciais.

---

Mercadolivre Scraper — produtos, preços, cupons, vendas, frete, ranking e promoções do MercadoLivre Brasil em dados estruturados.