🛒 Mercado Livre Scraper — Brasil (o mais completo)

Extraia produtos, preços, descontos, avaliações, vendedor e reputação do Mercado Livre Brasil — com dados limpos e prontos para usar. Busque por palavra-chave ou entre direto na página do produto. Sem login, sem cookies, sem dor de cabeça.

A maioria dos scrapers de Mercado Livre só lê a página de busca e devolve o básico (às vezes com campos vazios e bugs no meio dos dados). Este actor vai fundo: além da busca completa, ele abre o produto e traz vendedor, reputação, ficha técnica, descrição e categoria — os campos que os outros deixam em branco.

---

⚡ Por que escolher este actor

Recurso	Este actor	Scrapers só de busca
Preço, desconto, parcelas	✅	✅
Nota / avaliações	✅	parcial
Frete grátis e Mercado Envios Full	✅	⚠️ só frete grátis
Nome do vendedor	✅	❌ (vem vazio)
Reputação do vendedor (nível 1–5)	✅	❌
Ficha técnica completa	✅	❌
Descrição do produto	✅	❌
Caminho de categoria (breadcrumb)	✅	❌
Unidades vendidas / condição	✅	❌
Múltiplas palavras-chave por execução	✅	⚠️ 1 por vez
Schema limpo e consistente	✅	⚠️ nomes bagunçados / bugs

---

🎛️ Opções de entrada

Campo	Descrição
Modo	search (buscar por palavra-chave) ou product (detalhe completo por URL).
Palavras-chave	Uma ou várias (iphone 15, notebook, tênis nike).
Ordenação	Mais relevantes, menor preço ou maior preço.
Máx. de produtos	Limite por palavra-chave.
Máx. de páginas	Quantas páginas de busca percorrer (~48 produtos/página).
Buscar detalhes completos	No modo busca, abre cada produto para trazer vendedor, reputação e ficha.
URLs de produto	Lista de páginas de produto (modo product).
Proxy	Residencial BR (recomendado — o ML usa anti-bot DataDome).

Exemplo de entrada

{
  "mode": "search",
  "keywords": ["notebook", "iphone 15"],
  "sort": "price_asc",
  "maxItems": 100,
  "maxPages": 3,
  "includeProductDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "BR"
  }
}

---

📤 Dados de saída

Modo busca (um registro por produto): productId, title, price, originalPrice, discount, installments, installmentsNoInterest, rating, freeShipping, fullShipping, categoryId, domainId, image, url, keyword.

Modo produto (tudo acima, mais): condition, soldQuantity, reviewCount, availability, brand, sku, sellerName, sellerId, sellerProducts, sellerReputationRank (1–5), sellerReputation, categoryPath, questionsCount, description, attributes (ficha técnica).

Exemplo de saída (modo produto)

{
  "recordType": "product",
  "productId": "MLB1066306849",
  "title": "Mocassim 100% Couro Legítimo Masculino",
  "condition": "Novo",
  "soldQuantity": 1,
  "price": 200.92,
  "originalPrice": 211.49,
  "discount": "4% OFF",
  "currency": "BRL",
  "brand": "Cardena Madera",
  "sellerName": "Cardena Madera",
  "sellerId": 312027913,
  "sellerReputationRank": 5,
  "categoryPath": "Calçados, Roupas e Bolsas > Calçados > Sapatos Sociais e Mocassims > Mocassim",
  "image": "https://http2.mlstatic.com/D_Q_NP_2X_...-E.webp",
  "url": "https://produto.mercadolivre.com.br/MLB-1066306849-..."
}

Exportável em JSON, CSV, Excel e XML, com acesso via API, cliente Python/JS e MCP.

---

💡 Casos de uso

• 📈 Monitoramento e comparação de preços
• 🔍 Pesquisa de mercado e análise de concorrência
• 🛍️ Sourcing para dropshipping (com dados de vendedor e reputação)
• 📊 Gestão e enriquecimento de catálogos

---

⚙️ Notas técnicas

• Os dados são lidos do estado renderizado da própria página do Mercado Livre — sem depender de APIs internas instáveis.
• O ML usa proteção anti-bot (DataDome). Use proxy residencial brasileiro para resultados confiáveis.
• Somente Mercado Livre Brasil (mercadolivre.com.br).

Este scraper coleta apenas dados públicos. Use em conformidade com os termos do Mercado Livre e a legislação aplicável.