🌎 Mercadolibre Scraper

Extrae datos valiosos de MercadoLibre

Mercado Libre LATAM Scraper (AR, BO, BR, CL, CO, CR, DO, EC, GT, HN, MX, NI, PA, PY, PE, SV, UY, VE): productos, precios, cupones, ventas y envíos

El Mercado Libre LATAM Scraper en español de Karamelo convierte los resultados públicos de búsqueda de 18 marketplaces latinoamericanos en un dataset estructurado y listo para analizar. Es compatible con Argentina (AR), Bolivia (BO), Brasil (BR), Chile (CL), Colombia (CO), Costa Rica (CR), República Dominicana (DO), Ecuador (EC), Guatemala (GT), Honduras (HN), México (MX), Nicaragua (NI), Panamá (PA), Paraguay (PY), Perú (PE), El Salvador (SV), Uruguay (UY) y Venezuela (VE).

Introduce una palabra clave, selecciona el marketplace y elige cuántas páginas recorrer para obtener productos, precios, descuentos, promociones, cuotas, cantidad vendida, envío gratis, vendedores, identificadores, posición en los resultados y enlaces de publicación. El Actor está pensado para monitoreo de precios de Mercado Libre en LATAM, inteligencia competitiva regional, investigación de mercado, análisis de vendedores, seguimiento de promociones, descubrimiento de productos, automatización de e-commerce y datasets para agentes de IA.

Actor ID: karamelo/mercadolibre-scraper-espanol--castellano
Cobertura: 18 marketplaces LATAM — AR, BO, BR, CL, CO, CR, DO, EC, GT, HN, MX, NI, PA, PY, PE, SV, UY y VE
Formatos de salida: JSON, CSV, Excel, XML, RSS y JSONL desde el Dataset de Apify

¿Qué datos extrae este scraper de Mercado Libre LATAM?

Por cada resultado visible, el Actor puede recopilar:

• título, imagen y enlace del producto;
• precio actual, precio anterior, moneda y descuento;
• cupones y promociones consolidados en promociones;
• cuotas y condiciones de pago visibles;
• cantidad vendida e indicador de envío gratis;
• entrega, disponibilidad y origen del envío cuando aparecen;
• vendedor, seller ID, tienda oficial, marca y ubicación;
• calificación, cantidad de evaluaciones y destacados comerciales;
• ID de publicación, catálogo, producto del usuario y variación;
• categoría, dominio, vertical y tipo de resultado;
• posición del producto y total visible de resultados;
• condición de precio por cantidad o compra internacional;
• atributos de vehículos cuando la categoría los presenta.

La disponibilidad de cada propiedad depende de la categoría, el anuncio, la ubicación y lo que Mercado Libre muestre en la página de búsqueda. Los campos ausentes pueden tener texto vacío, null o false, según su tipo.

Casos de uso

Monitoreo de precios, descuentos y cupones

Programa búsquedas recurrentes y compara nuevoPrecio, precioAnterior, precioDiscount, promociones y Tiempo. Esto permite detectar rebajas, cupones nuevos y cambios en las cuotas.

Inteligencia competitiva y share of search

Relaciona Vendedor, sellerID, esTiendaOficial, itemPosition, cantidadVendida y produtoReviews para estudiar presencia de marca, visibilidad orgánica y competencia entre vendedores.

Investigación de productos y demanda

Analiza palabraClave, resultadosTotales, produtoCategoryID, produtoDomainID y highlight para descubrir categorías activas, productos destacados y señales públicas de demanda.

Catálogo y deduplicación

Usa SKU, idPublicacion, idProductoCatalogo, idProductoUsuario e idVariacion para relacionar entidades, reducir duplicados y mantener un historial consistente.

Automatizaciones y datasets para IA

Exporta los resultados a hojas de cálculo, bases de datos, BI, sistemas de alertas, asistentes de compra, flujos RAG o agentes autónomos. Conserva siempre la fecha y la URL para mantener trazabilidad.

Inicio rápido

1. Abre el Actor en Apify.
2. Escribe el producto o consulta en keyword.
3. Selecciona uno de los 18 marketplaces en country.
4. Define el límite maxPages.
5. Elige si deseas incluir resultados patrocinados con promoted.
6. Pulsa Start y consulta la pestaña Dataset al terminar.

Ejemplo de entrada para Argentina (AR)

{
  "keyword": "zapatillas deportivas",
  "country": "https://listado.mercadolibre.com.ar/",
  "maxPages": 3,
  "promoted": false
}

Configuración de entrada

Campo	Tipo	Obligatorio	Descripción
keyword	string	Sí	Consulta de búsqueda, por ejemplo zapatillas deportivas, notebook gamer o cafetera.
country	string	Sí	URL base de uno de los 18 marketplaces admitidos. Usa exactamente una URL de la tabla de países.
maxPages	integer	No	Máximo de páginas de resultados que se procesarán.
promoted	boolean	No	false excluye anuncios promocionados; true los conserva y marca en promocionado.

Para comparar ejecuciones históricas, mantén iguales la consulta, el país, el número de páginas y la opción de promocionados.

Países y marketplaces compatibles

Los códigos ISO de dos letras sirven como referencia e identificación regional. El valor enviado en country debe ser la URL completa, no el código ISO aislado.

País	ISO	Valor exacto de country
Argentina	AR	https://listado.mercadolibre.com.ar/
Bolivia	BO	https://listado.mercadolibre.com.bo/
Brasil	BR	https://lista.mercadolivre.com.br/
Chile	CL	https://listado.mercadolibre.cl/
Colombia	CO	https://listado.mercadolibre.com.co/
Costa Rica	CR	https://listado.mercadolibre.co.cr/
República Dominicana	DO	https://listado.mercadolibre.com.do/
Ecuador	EC	https://listado.mercadolibre.com.ec/
Guatemala	GT	https://listado.mercadolibre.com.gt/
Honduras	HN	https://listado.mercadolibre.com.hn/
México	MX	https://listado.mercadolibre.com.mx/
Nicaragua	NI	https://listado.mercadolibre.com.ni/
Panamá	PA	https://listado.mercadolibre.com.pa/
Paraguay	PY	https://listado.mercadolibre.com.py/
Perú	PE	https://listado.mercadolibre.com.pe/
El Salvador	SV	https://listado.mercadolibre.com.sv/
Uruguay	UY	https://listado.mercadolibre.com.uy/
Venezuela	VE	https://listado.mercadolibre.com.ve/

Para estudios regionales, ejecuta una tarea independiente por país. Esto conserva correctamente la moneda, el dominio, el ranking, el total de resultados y las condiciones comerciales de cada marketplace.

Ejemplo de resultado

{
  "imgDireccion": "https://http2.mlstatic.com/D_NQ_NP_EXAMPLE-O.webp",
  "Moneda": "ARS",
  "nuevoPrecio": "89999",
  "precioAnterior": "119999",
  "precioDiscount": "25% OFF",
  "vehiculoAno": "",
  "vehiculoKilometraje": "",
  "anticipo": null,
  "transmision": "",
  "articuloTitulo": "Zapatillas deportivas unisex",
  "installments": "6 cuotas sin interés",
  "promociones": "Cupón 10000 ARS OFF",
  "cantidadVendida": 500,
  "envioGratis": true,
  "enStock": null,
  "Vendedor": "TIENDA EJEMPLO",
  "esTiendaOficial": true,
  "SKU": "MLA12345678",
  "idPublicacion": "MLA1234567890",
  "idProductoCatalogo": "MLA12345678",
  "idProductoUsuario": "MLAU1234567890",
  "idVariacion": "MLA12345678",
  "tipoResultado": "ORGANIC",
  "esPrecioPorCantidad": false,
  "esCompraInternacional": false,
  "palabraClave": "zapatillas deportivas",
  "produtoReviews": "4.8",
  "numeroEvaluaciones": "320",
  "itemPosition": 1,
  "resultadosTotales": "+10.000 resultados",
  "zProductoLink": "https://www.mercadolibre.com.ar/p/MLA12345678",
  "Envio": "Llega gratis hoy Enviado por FULL",
  "highlight": "MÁS VENDIDO",
  "disponibleEn": "Disponible en otros colores",
  "envioDesde": "Buenos Aires",
  "productoMarca": "Marca Ejemplo",
  "produtoCategoryID": "MLA109027",
  "produtoDomainID": "MLA-SNEAKERS",
  "sellerID": "123456789",
  "vertical": "CORE",
  "verticalID": "CORE",
  "ubicacion": "Buenos Aires",
  "Tiempo": "2026-07-31T13:35:57.068Z",
  "promocionado": false
}

Este ejemplo es ilustrativo. La presencia y el formato exacto de los valores varían según el anuncio y la presentación actual del marketplace.

Diccionario completo de propiedades

Grupo	Campos	Aplicación
Producto	articuloTitulo, imgDireccion, zProductoLink, productoMarca	Catálogos, enriquecimiento y acceso a la oferta.
Precio	Moneda, nuevoPrecio, precioAnterior, precioDiscount	Seguimiento de precios y descuentos.
Pago y promociones	installments, promociones, anticipo	Cuotas, cupones, beneficios y anticipos visibles.
Demanda y reputación	cantidadVendida, produtoReviews, numeroEvaluaciones	Señales públicas de tracción y valoración.
Envío y disponibilidad	envioGratis, Envio, disponibleEn, envioDesde, enStock	Análisis de entrega y disponibilidad mostrada.
Vendedor	Vendedor, sellerID, esTiendaOficial, ubicacion	Comparación de sellers y tiendas oficiales.
Identificadores	SKU, idPublicacion, idProductoCatalogo, idProductoUsuario, idVariacion	Deduplicación, relaciones e historial.
Taxonomía	produtoCategoryID, produtoDomainID, vertical, verticalID	Segmentación por categoría, dominio y vertical.
Ranking	palabraClave, itemPosition, resultadosTotales, tipoResultado, promocionado	Share of search, posición y clasificación del resultado.
Señales comerciales	highlight, esPrecioPorCantidad, esCompraInternacional	Más vendido, ofertas y modalidades especiales.
Vehículos	vehiculoAno, vehiculoKilometraje, transmision	Información automotriz cuando corresponde.
Auditoría	Tiempo	Fecha de extracción y series históricas.

cantidadVendida refleja la cantidad pública disponible para el resultado y puede estar redondeada. resultadosTotales conserva el texto que muestra Mercado Libre y no garantiza que esa cantidad completa pueda exportarse.

API de Mercado Libre Scraper en Apify

Reemplaza APIFY_TOKEN con tu token. Los clientes oficiales identifican el Actor con /; la API REST utiliza ~ entre el usuario y el nombre del Actor.

JavaScript / Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const input = {
  keyword: 'zapatillas deportivas',
  country: 'https://listado.mercadolibre.com.ar/',
  maxPages: 3,
  promoted: false,
};

const run = await client
  .actor('karamelo/mercadolibre-scraper-espanol--castellano')
  .call(input);

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

Instalación:

$npm install apify-client

Python

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ['APIFY_TOKEN'])

run = client.actor('karamelo/mercadolibre-scraper-espanol--castellano').call(
    run_input={
        'keyword': 'zapatillas deportivas',
        'country': 'https://listado.mercadolibre.com.ar/',
        'maxPages': 3,
        'promoted': False,
    }
)

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

Instalación:

$pip install apify-client

cURL: ejecución síncrona con resultados

curl -X POST \
  "https://api.apify.com/v2/actors/karamelo~mercadolibre-scraper-espanol--castellano/run-sync-get-dataset-items?format=json&clean=true" \
  -H "Authorization: Bearer APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "zapatillas deportivas",
    "country": "https://listado.mercadolibre.com.ar/",
    "maxPages": 3,
    "promoted": false
  }'

cURL: iniciar una ejecución asíncrona

curl -X POST \
  "https://api.apify.com/v2/actors/karamelo~mercadolibre-scraper-espanol--castellano/runs" \
  -H "Authorization: Bearer APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "zapatillas deportivas",
    "country": "https://listado.mercadolibre.com.ar/",
    "maxPages": 3,
    "promoted": false
  }'

Cuando termine, recupera defaultDatasetId de la ejecución y descarga los datos:

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

MCP para ChatGPT, Claude, Cursor, Codex y otros agentes

El servidor MCP de Apify permite presentar el Actor como una herramienta para clientes compatibles. Usa el endpoint HTTP actual y limita la conexión al Actor de Karamelo:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=karamelo/mercadolibre-scraper-espanol--castellano"
    }
  }
}

Completa la autorización de Apify cuando el cliente la solicite. Si el cliente admite encabezados personalizados, también puedes usar Authorization: Bearer APIFY_TOKEN.

Ejemplo de instalación para un cliente compatible:

$apify mcp install codex --tools karamelo/mercadolibre-scraper-espanol--castellano

Prompts para agentes de IA

Ejecuta el scraper de Karamelo para "notebook gamer" en Mercado Libre México (MX),
con 5 páginas y sin resultados promocionados. Usa el marketplace
https://listado.mercadolibre.com.mx/ y compara precio, descuento, cuotas,
envío gratis, cantidad vendida y vendedor.

Busca "auriculares bluetooth" en Mercado Libre Chile (CL) usando
https://listado.mercadolibre.cl/. Devuelve los primeros 20 resultados orgánicos
y destaca los que tengan cupón, MÁS VENDIDO o envío gratis. Incluye URL,
evaluación, seller e identificadores del producto.

Código para preparar contexto de un agente

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor(
  'karamelo/mercadolibre-scraper-espanol--castellano',
).call({
  keyword: 'auriculares bluetooth',
  country: 'https://listado.mercadolibre.com.ar/',
  maxPages: 2,
  promoted: false,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
const contextForAgent = items.map((item) => ({
  title: item.articuloTitulo,
  price: item.nuevoPrecio,
  currency: item.Moneda,
  coupon: item.promociones,
  sold: item.cantidadVendida,
  freeShipping: item.envioGratis,
  rating: item.produtoReviews,
  seller: item.Vendedor,
  highlight: item.highlight,
  url: item.zProductoLink,
}));

console.log(JSON.stringify(contextForAgent));

x402 para pagos de agentes sin cuenta Apify

x402 en Apify es experimental. Solo puede ejecutar Actors elegibles con precios Pay Per Event, permisos compatibles y sin Standby. Cuando esta versión de Karamelo esté habilitada para x402, un agente podrá pagar con USDC en Base, obtener un token prepago y llamar al endpoint síncrono.

npx -y awal auth login TU_EMAIL
npx awal auth verify CODIGO_RECIBIDO
npx awal x402 pay "https://agi.apify.com/protocols/x402/prepaid-tokens?amount=1&currency=usd" --max-amount 1000000 --json

Usa el token devuelto como Bearer token:

curl -X POST \
  "https://api.apify.com/v2/actors/karamelo~mercadolibre-scraper-espanol--castellano/run-sync-get-dataset-items" \
  -H "Authorization: Bearer X402_PREPAID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "zapatillas deportivas",
    "country": "https://listado.mercadolibre.com.ar/",
    "maxPages": 2,
    "promoted": false
  }'

Si el Actor todavía no cumple los requisitos de x402, utiliza un token estándar de Apify con los ejemplos anteriores.

Automatización e integraciones

• Schedules: ejecuta consultas por hora, día o semana para mantener históricos.
• Webhooks: notifica a otro sistema cuando una ejecución finaliza o falla.
• Make y Zapier: conecta el Actor con hojas de cálculo, bases de datos, correo o Slack.
• Google Sheets y Excel: crea tableros de precios, promociones y vendedores desde CSV/XLSX.
• Data warehouses: carga JSON o JSONL en BigQuery, Snowflake, PostgreSQL u otros pipelines.
• Agentes de IA: conecta mediante MCP o consume el Dataset con JavaScript y Python.

Recomendaciones para resultados consistentes

• Prueba primero con 1 o 2 páginas para validar la consulta y los campos disponibles.
• Usa promoted: false para estudiar ranking orgánico y true para incluir publicidad en el análisis.
• Conserva Tiempo, palabraClave, itemPosition y zProductoLink en cada captura histórica.
• Interpreta nuevoPrecio junto con Moneda; evita mezclar ARS con otras monedas.
• Deduplica con identificadores, recordando que catálogo, publicación y variación son entidades diferentes.
• Comprueba valores opcionales antes de calcular promedios o enviar datos a producción.
• Ajusta la frecuencia y el número de páginas a una carga razonable para tu necesidad.

Limitaciones

• El Actor recopila resultados públicos de búsqueda y no sustituye el scraping completo de páginas de detalle.
• No incluye descripción larga, preguntas y respuestas, reseñas individuales ni cantidad exacta de stock disponible.
• Cantidad vendida, total de resultados, envío y plazos pueden ser estimaciones o textos resumidos por Mercado Libre.
• Categoría, ubicación, disponibilidad, cambios de diseño y pruebas A/B pueden modificar los campos visibles.
• Una página puede producir menos elementos si el marketplace oculta, duplica o elimina resultados.

Preguntas frecuentes

¿Qué países de Mercado Libre admite este scraper?

Admite 18 marketplaces: Argentina (AR), Bolivia (BO), Brasil (BR), Chile (CL), Colombia (CO), Costa Rica (CR), República Dominicana (DO), Ecuador (EC), Guatemala (GT), Honduras (HN), México (MX), Nicaragua (NI), Panamá (PA), Paraguay (PY), Perú (PE), El Salvador (SV), Uruguay (UY) y Venezuela (VE). El campo country recibe la URL correspondiente de la tabla, no el código ISO.

¿Puedo comparar el mismo producto entre varios países?

Sí. Ejecuta una tarea separada para cada URL de country y combina después los Datasets. Conserva Moneda, palabraClave, Tiempo y la URL del marketplace para no mezclar precios ni rankings de países diferentes.

¿Puede extraer cupones y promociones?

Sí. Los cupones y beneficios asociados al resultado público se consolidan en promociones.

¿Devuelve la cantidad vendida?

Sí, en cantidadVendida cuando la señal está disponible. Mercado Libre puede presentar la cifra redondeada o resumida.

¿Puedo eliminar publicaciones patrocinadas?

Sí. Establece promoted en false. Con true, se incluyen y se identifican mediante promocionado.

¿Cómo creo un monitor de precios?

Guarda una tarea con entrada constante, programa ejecuciones periódicas y compara nuevoPrecio, precioAnterior, precioDiscount, promociones y Tiempo por ID de producto o publicación.

¿Se pueden descargar los datos en CSV o Excel?

Sí. Selecciona el formato desde el Dataset o utiliza el endpoint de items con format=csv.

¿Puedo usarlo como API de productos de Mercado Libre?

Sí. El Actor se puede ejecutar con la API REST de Apify, los clientes oficiales de JavaScript y Python, MCP y, si cumple los requisitos, x402.

Uso responsable y aviso legal

Recopila únicamente información pública y úsala de acuerdo con los términos aplicables, las normas de privacidad y las reglas del marketplace. Evita datos personales innecesarios y cargas excesivas. Este proyecto de Karamelo es independiente y no está afiliado, patrocinado ni respaldado por Mercado Libre o Apify.

Soporte

Para facilitar el diagnóstico, comparte la palabra clave, el país, maxPages, la opción promoted, el ID de ejecución y un ejemplo del campo esperado. Nunca publiques tokens, cookies ni credenciales.

---

Mercado Libre LATAM Scraper by Karamelo — cobertura AR, BO, BR, CL, CO, CR, DO, EC, GT, HN, MX, NI, PA, PY, PE, SV, UY y VE para productos, precios, cupones, ventas, vendedores, envíos, ranking, inteligencia de mercado y automatización de e-commerce.