Monitor de Precios Mercado Libre — Alerta de Baja y Stock

El Keepa de Mercado Libre para Latinoamérica. Armás una lista de productos de Mercado Libre y, en cada ejecución, recibís solo lo que cambió: bajó el precio, subió el precio, se agotó, volvió a stock, entró o salió de oferta. Nada de raspar el catálogo entero de nuevo cada vez — el monitor guarda el precio anterior de cada producto y te entrega únicamente el delta. Es el rastreador de precios e historial de disponibilidad que Mercado Libre no te da.

In English: MercadoLibre price tracker & stock alert for Latin America (AR/MX/CL/CO/UY/PE) — a Keepa-style price monitor that returns only the delta between runs: price drop/rise alerts, out-of-stock/back-in-stock, and new deals. Watch a fixed product list or a whole search/category.

Funciona en Argentina, México, Chile, Colombia, Uruguay y Perú — elegís el país en el input y el monitor usa el dominio, el proxy y la moneda correctos.

Visión general

Elegís el país (sitio), informás una watchlist — la URL de cada producto o solo el código MLA... / MLM... — y agendás la ejecución. La primera vez, el monitor registra el retrato actual de cada producto (el baseline: precio, stock, oferta). En las ejecuciones siguientes, compara el estado de ahora con el de la última vez y emite solo los cambios reales:

• alerta_precio — el precio cambió (con precio anterior, precio actual, variación % y dirección: baja o alza);
• cambio_stock — se agotó o volvió a stock;
• nueva_oferta / fin_oferta — el producto entró o salió de promoción/descuento;
• eliminado — el anuncio salió del aire (pausado, finalizado o 404).

Si un producto no cambió, no aparece — y no pagás por él. El valor está en la diferencia, no en el barrido.

Cómo se compara con un scraper de Mercado Libre

Un scraper de Mercado Libre te devuelve un retrato: raspa la lista/producto entero cada vez que corre, y pagás por ítem raspado, cambie o no. Este Actor te devuelve el delta: lee los mismos productos, pero solo te entrega (y solo cobra) cuando algo de hecho cambió. Para seguir precios a lo largo del tiempo, el delta es más barato y mucho más accionable — recibís una alerta de "bajó 12%", no un archivo con 500 precios iguales a los de ayer para comparar a mano.

Es un monitor nativo en español: entiende la página de producto de Mercado Libre en es-AR/MX/CL/CO/UY/PE (precio con el separador de cada país, "de/por" tachado, "sin stock", "publicación pausada", envío gratis) y lee el dato limpio del JSON-LD de la propia página. La moneda (ARS/MXN/CLP/COP/UYU/PEN) sale del JSON-LD, no está hardcodeada.

Países soportados

Sitio	País	Dominio	Moneda	Prefijo de ID
AR	Argentina	mercadolibre.com.ar	ARS	MLA
MX	México	mercadolibre.com.mx	MXN	MLM
CL	Chile	mercadolibre.cl	CLP	MLC
CO	Colombia	mercadolibre.com.co	COP	MCO
UY	Uruguay	mercadolibre.com.uy	UYU	MLU
PE	Perú	mercadolibre.com.pe	PEN	MPE

El prefijo del código del ítem ya indica el país (un MLA... es de Argentina, un MLM... de México). Elegí el sitio que coincida con tus productos: define el país del proxy residencial y el dominio de la búsqueda.

Features

• Delta entre ejecuciones: cada run reporta solo lo que cambió — baja/alza de precio, se agotó/volvió, entró/salió de oferta — nunca la lista entera de nuevo.
• Historial por producto: el precio y la disponibilidad anteriores quedan guardados; la alerta ya viene con el "de → a" y la variación %.
• Watchlist que evoluciona: agregá o quitá productos cuando quieras. Un producto nuevo es solo un retrato inicial (no cobra alerta); uno quitado de la lista sale del estado. Editar la lista no reinicia el monitor.
• Filtro de ruido: definí una variación mínima (%) para solo ser avisado de bajas/alzas relevantes.
• Degradación honesta: si Mercado Libre está bloqueando o fuera del aire, el monitor preserva el estado y no cobra nada — un bloqueo nunca se confunde con "el producto desapareció".
• Agendable: hecho para correr cada hora o a diario vía Schedules de Apify; la 1ª run es el baseline, las demás son la alerta.

Dos modos: watchlist y búsqueda

El Actor tiene dos modos, y elegís por el input:

• Modo watchlist (por defecto): listás productos fijos en el campo productos (URLs o códigos MLA...) y el monitor vigila exactamente esos productos. Es el modo descrito arriba.
• Modo búsqueda: en vez de productos fijos, informás una búsqueda en el campo busqueda — un término (ej.: "notebook", "iphone 15") o una URL de búsqueda/categoría de Mercado Libre (ej.: "https://listado.mercadolibre.com.ar/notebook"). El monitor lee los cards del tope de los resultados (hasta el tope max_productos) y hace el delta del conjunto entre ejecuciones. Además de las mismas alertas de precio/stock/oferta para los productos que siguen apareciendo, reporta:
  • producto_nuevo — un producto que entró en el recorte de la búsqueda (retrato inicial; no cobra alerta, como el baseline de un ítem nuevo);
  • producto_salio — un producto que salió del recorte de la búsqueda. Esta alerta solo se emite cuando el monitor vio el fin real de la lista de resultados; si la lista fue cortada por el tope, un producto que "desapareció" puede solo haber perdido posición más allá del tope, así que el monitor preserva el estado y no emite un "salió" falso.

Dejá busqueda vacío para usar el modo watchlist. Si busqueda está completado, el modo búsqueda tiene prioridad y la watchlist se ignora en esa ejecución. El estado de los dos modos es separado. El tope max_productos y la variacion_minima_pct valen para los dos modos; en el modo búsqueda, el tope también define la ventana monitoreada (el top-N de la búsqueda) y forma parte de la identidad del monitor (cambiar el tope reinicia el baseline de esa búsqueda).

Nota técnica: en el modo búsqueda, el precio viene del card de la vidriera de resultados (el mismo que ML muestra en la lista), no de la página de cada producto. Para catálogos con variaciones, el card puede mostrar un precio "desde" que difiere del precio de la variación específica en la página del producto — el monitor usa el precio del card por ser la referencia consistente entre ejecuciones.

Input example

{
  "sitio": "AR",
  "productos": [
    "https://www.mercadolibre.com.ar/p/MLA22826188",
    "MLA2024331913"
  ],
  "variacion_minima_pct": 5,
  "modo": "auto",
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Output example

Alerta de baja de precio detectada en el delta:

{
  "change_type": "alerta_precio",
  "item_id": "MLA1401055590",
  "titulo": "Samsung Galaxy A15 128 GB - Azul",
  "url": "https://www.mercadolibre.com.ar/p/MLA1401055590",
  "precio_anterior": 289999.00,
  "precio_actual": 254999.10,
  "variacion_pct": -12.1,
  "direccion": "baja",
  "moneda": "ARS",
  "precio_de": 349999.00,
  "descuento_pct": 27,
  "availability": "InStock",
  "entro_en_oferta": false,
  "nota": "El precio bajó de 289999 a 254999.1 (-12.1%).",
  "detected_at": "2026-07-19T09:00:00.000Z"
}

En la primera ejecución de una watchlist, cada producto sale como change_type: "baseline" (el retrato inicial). Un producto que se agotó sale como cambio_stock con agotado: true; uno que salió del aire sale como eliminado.

Parámetros

Campo	Tipo	Por defecto	Descripción
sitio	select	AR	País de Mercado Libre: AR/MX/CL/CO/UY/PE. Define dominio, proxy y moneda.
productos	array	1 ejemplo	Watchlist: URL del producto o código MLA.../MLM....
busqueda	string	""	Modo búsqueda: término o URL de búsqueda/categoría. Vacío = modo watchlist.
variacion_minima_pct	integer	0	Solo emite alerta de precio cuando la variación, en la ejecución, sea ≥ este %. 0 = cualquier cambio.
max_productos	integer	90	Tope de productos renderizados por ejecución (costo/tiempo; cada producto es un render de ~25-30s).
stateStoreName	string	""	Avanzado. Vacío = estado por defecto. Completá solo para correr listas independientes en paralelo.
modo	select	auto	auto = baseline en la 1ª, delta después. baseline = fuerza rebase del estado actual.
proxy	object	Residencial	El país del proxy se toma del sitio. Mercado Libre exige IP residencial del país para cargar la página.

Tips

• Agendá, no corras a mano. El valor es la recurrencia: configurá un Schedule (diario, o cada hora para ofertas relámpago). La 1ª ejecución es el baseline automáticamente; las siguientes solo te avisan de lo que cambió.
• Usá variacion_minima_pct para cortar ruido. En productos que oscilan centavos, poné 5 o 10 para solo ser avisado de bajas que valen la pena.
• Una watchlist por objetivo. Para monitorear dos listas independientes, dale a cada agendamiento un stateStoreName propio — cada nombre es un monitor aislado.
• El baseline es gratis de alerta. La primera ejecución solo cobra la ejecución (no cobra alerta) — es el retrato inicial. El dinero entra cuando un precio de hecho cambia.
• Un sitio por país. Los productos de tu watchlist deben ser del país elegido; el prefijo del ID (MLA, MLM, ...) ya indica el país.

Use cases

• Alerta de baja de precio (el Keepa de ML): seguí los productos que querés comprar y te avisamos en el minuto en que el precio baja.
• Seguimiento de stock: sabé al instante cuando un producto agotado vuelve a stock — útil para lanzamientos e ítems disputados.
• Monitoreo de competencia de precios (repricing): vendedor que hace seguimiento de precios de anuncios competidores para reprecificar los suyos.
• Cazador de ofertas / afiliados: monitoreá una canasta de productos y capturá las promociones (nueva_oferta) apenas entran.
• Compras / procurement: seguí insumos y equipos recurrentes y registrá el historial de precio para negociar mejor.
• Higiene de catálogo: el eliminado marca anuncios que salieron del aire — útil para mantener una lista de referencia limpia.

FAQ

¿Qué cambia exactamente entre la 1ª ejecución y las siguientes? La 1ª ejecución de una watchlist es el baseline: registra el precio/stock actual de cada producto y cobra solo la ejecución. De la 2ª en adelante, el monitor compara con el estado anterior y entrega el delta — solo los productos cuyo precio, stock u oferta cambió.

¿Cómo guarda el historial el monitor? En un almacenamiento nombrado que persiste entre ejecuciones. Guarda el último precio/stock/oferta de cada producto — es contra eso que la próxima ejecución compara. Editar la watchlist no borra el historial de los demás.

¿Vender una unidad cuenta como cambio? No. La cantidad vendida es ruido: el monitor solo considera "cambio" el precio, la disponibilidad y la oferta. Vender no dispara alerta (ni cobro).

Un producto quedó sin stock — ¿el precio queda null? Sí, y el Actor es honesto: un producto pausado/agotado sale con availability: "OutOfStock" y precio_actual: null (evento cambio_stock, no un falso "precio a cero").

Si Mercado Libre bloquea la ejecución, ¿el monitor borra todo? No. Una ejecución bloqueada preserva el estado y no cobra — emite un registro STATUS: NO_DISPONIBLE. Un bloqueo jamás se lee como "el producto desapareció". Un producto individual que no cargó también se preserva, no se marca como eliminado.

¿Qué cuenta como eliminado? Solo cuando Mercado Libre responde que el anuncio ya no existe (404) para un producto que estaba en tu monitor — anuncio pausado, finalizado o catálogo eliminado. Un producto nuevo con URL errada sale como no_encontrado (informativo, sin cobro).

¿Por qué necesito proxy residencial? La página de producto de Mercado Libre solo hidrata (muestra el precio) para un IP residencial del país; datacenter es bloqueado. Es el estándar del Actor y lo que fue medido funcionando; el país se toma del sitio.

¿Puedo monitorear una búsqueda/categoría entera, no una lista? Sí — usá el modo búsqueda (campo busqueda): informá un término o URL de búsqueda/categoría y el monitor vigila el top-N de los resultados (hasta el tope max_productos), avisando cuando un producto entra (producto_nuevo), sale (producto_salio) o cambia de precio/stock/oferta. Cada producto del recorte cuenta como un producto_verificado.

Pricing

Pagá por resultado (PPE) — pagás la ejecución y el cambio, no el barrido:

Evento	Cuándo se cobra
monitor_run	Una vez por ejecución válida (renderiza los productos y apura el delta). Ejecución con la fuente totalmente bloqueada/fuera del aire no cobra.
producto_verificado	Cada producto efectivamente leído en la ejecución (precio, stock y oferta capturados) — en el modo watchlist, cada producto de tu lista; en el modo búsqueda, cada producto orgánico del recorte (patrocinados y el excedente del tope no cobran). Producto bloqueado, inexistente (404) o con URL inválida no cobra.
alerta	Cada cambio real emitido: baja/alza de precio, se agotó/volvió a stock, entró/salió de oferta, producto eliminado, o (en el modo búsqueda) producto que salió del recorte. Producto que no cambió no cobra; la 1ª ejecución (baseline), un producto nuevo en la lista y un producto_nuevo en la búsqueda no cobran alerta.

No pagás por: el baseline (solo ejecución + productos leídos), productos que no cambiaron, ejecución totalmente bloqueada/fuera del aire, producto que no se pudo leer (preservado, no cobra el producto_verificado), error nuestro, o entrada inválida.

Actors relacionados

• Monitor de Preço Mercado Livre — Brasil — el mismo monitor para Mercado Livre Brasil, en portugués y con proxy residencial BR.
• Monitor de Nuevos Negocios en Google Maps — el mismo motor de delta sobre otra fuente: te avisa solo cuando aparece un negocio nuevo en el mapa.
• Reclame Aqui Scraper — si trabajás con proveedores brasileños: reputación de la empresa antes de cerrar.
• Consulta CNPJ en Lote — registro fiscal brasileño (Receita Federal) en lote, para validar proveedores de Brasil.

Changelog

• 0.1: primera versión — monitor de precios/stock/oferta de una watchlist de productos de Mercado Libre LatAm (AR/MX/CL/CO/UY/PE), con delta entre ejecuciones (baja/alza de precio, se agotó/volvió, nueva/fin de oferta, eliminado), historial por producto, estado estable a ediciones de la lista y degradación honesta.

Contacto

Dudas, problemas o pedidos: usá la pestaña Issues del Actor.