Mercado Livre Brasil BOOST Scraper 🇧🇷 + Analytics (Português)

Extraia buscas do Mercado Livre com dados prontos para usar — e receba a análise do mercado junto, sem custo extra.

Preço numérico, parcelas estruturadas, frete FULL como true/false. Mais: distribuição de preços do nicho, posição do seu produto no ranking e alertas quando um concorrente baixa o preço.

---

📦 O que cada execução entrega

	Registro	O que é
🛒	product	Uma linha por anúncio, com posição no ranking, preço, desconto, parcelas, frete, vendedor, avaliação e quantidade vendida
📊	market_summary	Raio-X do nicho: mediana e faixa de preços, % patrocinados, % FULL, concentração de vendedores, categoria da busca
🎯	positioning_report	Onde seu SKU está: posição, percentil de preço, comparação com os líderes
🔄	delta_report	O que mudou desde a última execução: quedas de preço, novos concorrentes, saídas
🚨	alert	Disparos automáticos → dataset e webhook (n8n, Make, Slack)

📍 Onde encontrar cada coisa

Local	Conteúdo
Dataset padrão (o que abre após a execução)	só os produtos, em tabela limpa
Dataset ml-scanner-reports (aba Storage → Datasets)	análise de mercado, posicionamento, deltas e alertas

Separados de propósito: assim cada tabela mostra as colunas certas, sem campos vazios. O dataset de relatórios se mantém entre execuções, virando um histórico das suas análises e alertas ao longo do tempo.

---

⚡ Por que este e não outro

Scrapers comuns	Este actor
"novoPreco": "173,76"	"price": { "amount": 173.76 }
"precoDiscount": "9% OFF"	"discountPercent": 9
"installments": "5x 34,75 sem juros"	{ "count": 5, "amount": 34.75, "interestFree": true }
"enviadoDe": "Enviado pelo {vpp_full_icon}" 🐛	"shipping": { "full": true, "free": true }
❌ Sem posição no ranking	✅ "position": 7 + flag de patrocinado
❌ Só uma lista de linhas	✅ Lista + análise + posicionamento + alertas

---

🛒 Exemplo — produto

{
    "type": "product",
    "position": 7,
    "sku": "MLB4290861023",
    "title": "Tênis De Corrida Masculino Leve Confortável",
    "url": "https://produto.mercadolivre.com.br/MLB-4290861023-...",
    "imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_808882-CBT975097.webp",
    "price": { "amount": 173.76, "currency": "BRL" },
    "originalPrice": { "amount": 190.97, "currency": "BRL" },
    "discountPercent": 9,
    "installments": { "count": 5, "amount": 34.75, "interestFree": true },
    "shipping": { "free": true, "full": true, "arrivesTomorrow": false },
    "isSponsored": false,
    "isInternational": false,
    "shippedFrom": null,
    "highlight": "MAIS VENDIDO",
    "seller": { "name": "NIKE", "officialStore": true },
    "rating": { "stars": 4.6, "count": 2059 },
    "salesCount": 1000,
    "totalResults": 59629,
    "scrapedAt": "2026-07-25T07:49:03.229Z"
}

💡 salesCount usa as faixas do próprio Mercado Livre: 1000 significa mais de 1.000 vendidos. Ótimo para separar quem realmente vende de quem apenas aparece bem posicionado.

🖼️ imageUrl é o link direto do CDN do Mercado Livre, exatamente como a página serve — nenhuma imagem é baixada, reprocessada ou re-hospedada.

💡 Sobre seller.name: em anúncios de loja oficial vem o nome da marca (NIKE, PUMA, ON RUNNING); em vendedores comuns, o nome da loja. Alguns anúncios chegam com null — o Mercado Livre nem sempre exibe o vendedor na busca, e a frequência varia por categoria.

📊 Exemplo — análise de mercado

{
    "type": "market_summary",
    "keyword": "tenis de corrida masculino",
    "itemsAnalyzed": 30,
    "totalResultsDeclared": 59629,
    "price": { "min": 46.22, "q1": 99.92, "median": 191.88, "q3": 238, "max": 854.99, "avg": 201.69 },
    "sharePct": { "sponsored": 36.7, "fullShipping": 33.3, "freeShipping": 96.7, "officialStores": 43.3 },
    "sellers": { "unique": 17, "top5SharePct": 43.3 },
    "avgRatingStars": 4.63
}

💡 Leitura rápida: mediana de R$ 191,88, mercado pulverizado (17 vendedores, top-5 com 43%) e 36,7% dos resultados são anúncios pagos — ou seja, é caro brigar por essa palavra-chave.

📁 Categoria e domínio da busca (searchCategoryId, searchDomainId, searchCategoryPath) ficam aqui, no resumo — e não em cada produto, porque uma mesma busca pode devolver anúncios de categorias diferentes.

🎯 Exemplo — seu posicionamento

{
    "type": "positioning_report",
    "mySku": "MLB6530106550",
    "position": 2,
    "myPrice": { "amount": 145.4, "currency": "BRL" },
    "pricePercentile": 45,
    "priceVsMedianPct": -1.6,
    "iAmFull": false,
    "marketFullSharePct": 70
}

💡 Você está em 2º lugar, com preço 1,6% abaixo da mediana — mas 70% dos concorrentes usam FULL e você não. Aí está a alavanca.

🚨 Exemplo — alerta

{
    "type": "alert",
    "alertType": "PRICE_BELOW_THRESHOLD",
    "sku": "MLB4111260625",
    "title": "Tenis Academia Masculino Corrida Musculação",
    "price": 58.41,
    "threshold": 80,
    "url": "https://produto.mercadolivre.com.br/MLB-4111260625-..."
}

Tipos de alerta: 💰 preço abaixo do seu limite · 📉 concorrente baixou preço · 🆕 novo no top 10 · 📊 sua posição mudou · ⚠️ seu anúncio saiu da busca

---

🎬 Como usar

Passo	Ação
1	Escreva suas palavras-chave (uma análise por palavra-chave)
2	Opcional: informe seu SKU (MLB4290861023) → relatório de posicionamento
3	Opcional: defina alerta de preço e URL de webhook
4	Agende em Schedules → o histórico e os alertas se constroem sozinhos
5	Exporte em JSON / CSV / Excel ou consuma pela API

{
    "keywords": ["tenis de corrida masculino"],
    "maxItemsPerKeyword": 100,
    "mySku": "MLB4290861023",
    "priceAlertBelow": 120,
    "alertWebhookUrl": "https://hooks.n8n.cloud/webhook/abc"
}

ℹ️ Quantos produtos esperar: o Mercado Livre para de servir anúncios novos depois de cerca de duas páginas, então cada palavra-chave rende até ~85 produtos únicos — mesmo que a busca declare dezenas de milhares de resultados. A execução detecta isso e encerra sozinha. Para cobrir mais mercado, use mais palavras-chave (inclusive variações), não um número maior de itens.

---

💡 Para que serve

• 📈 Monitorar preços — alertas no seu Slack quando o concorrente baixa
• 🎯 Acompanhar seu ranking — saiba quando cai de posição, e por quê
• 🔎 Pesquisar um nicho — preço médio e concorrência antes de investir
• 🤖 Alimentar IA e automações — JSON limpo, pronto para MCP e n8n
• 🚨 Flagrar desconto falso — o histórico revela o "de R$ 190" que nunca existiu

---

📬 Suporte

Dúvidas, ou precisa de um campo que não existe? Abra uma Issue na aba do actor — respondo rápido, e o roadmap é guiado por quem usa.

---