Easy Scraper - Productos, precios y stock de Easy.cl

Extrae productos publicos desde Easy.cl a partir de un termino de busqueda. El Actor recorre la paginacion disponible, deduplica productos y entrega un dataset listo para monitoreo de precios, retail intelligence, analisis de ecommerce y comparacion del mercado chileno.

Que hace este Actor

• Busca productos en Easy Chile por termino, por ejemplo Martillo, taladro, pintura blanca, ceramica o jardin.
• Usa HTTP directo contra el backend JSON VTEX de Easy: https://easycl.vtexcommercestable.com.br/api/catalog_system/pub/products/search.
• Evita scraping visual pesado. Playwright se uso solo para investigar el flujo real del sitio y confirmar que el sitio visible se alimenta de datos estructurados.
• Recorre paginas con _from y _to, detecta el total reportado por el header resources y respeta maxItems, maxPages, pageSize y concurrency.
• Guarda filas normalizadas en el dataset y un resumen completo en OUTPUT.

Datos que extrae

Cada fila representa un producto encontrado en Easy:

• Termino buscado y fecha de extraccion.
• ID de producto, SKU/itemId, EAN y referencias originales.
• Nombre, marca, categoria, IDs de categoria y URL publica.
• Vendedor, ID vendedor e indicador marketplace.
• Disponibilidad, cantidad disponible e imagen principal.
• Rating y conteo de resenas cuando el backend los entregue.
• Pagina, posicion global y posicion dentro de la pagina.
• raw_offer y raw_product para trazabilidad completa.

Columnas de precio

El Actor no usa columnas genericas como price, normal_price o card_price. Las columnas se nombran segun los precios reales observados en Easy.cl y en su backend:

Campo	Significado
easy_precio_normal	Precio Normal de Easy. Corresponde al precio base o al precio tachado cuando existe una oferta.
easy_precio_oferta	Precio Oferta cuando Easy entrega un precio menor al Precio Normal.
easy_precio_cencopay	Precio condicionado a CencoPay cuando el backend lo marca con ajuste CENCOPAY.
easy_precio_cencosud	Precio condicionado a Cencosud/CAT cuando el backend lo marca con ajuste CAT, CENCO o equivalente.
precio_principal	Campo auxiliar para analisis rapido: menor precio disponible entre los precios reportados para el producto.
discount_percentage	Descuento calculado entre easy_precio_normal y precio_principal cuando ambos existen.
promocion, badge_precio, texto_descuento, condicion_precio	Textos promocionales y condiciones comerciales detectadas desde el backend.

Los bloques originales de precio quedan disponibles dentro de raw_offer y raw_product.

Input

{
  "term": "Martillo",
  "maxItems": 100,
  "maxPages": 3,
  "pageSize": 50,
  "sort": "recommended",
  "concurrency": 4,
  "failOnNoResults": false
}

Parametros principales

• term: termino de busqueda requerido.
• maxItems: maximo de productos a guardar. Recomendado para pruebas y control de costos.
• pageSize: productos por solicitud. El backend de Easy permite hasta 50.
• maxPages: limite opcional de paginas.
• sort: recommended, price_asc, price_desc, name_asc, newest o top_sales.
• concurrency: paginas consultadas en paralelo despues de la primera.
• failOnNoResults: si debe fallar cuando no hay resultados.

Output de ejemplo

{
  "search_term": "Martillo",
  "product_id": "96869",
  "sku": "1346694",
  "name": "Martillo soldador Hela",
  "brand": "Hela",
  "currency": "CLP",
  "easy_precio_normal": 11990,
  "easy_precio_oferta": null,
  "easy_precio_cencopay": null,
  "easy_precio_cencosud": null,
  "precio_principal": 11990,
  "is_available": true,
  "availability": "available",
  "category": "Herramientas > Herramientas Manuales > Martillos y Mazas",
  "seller_name": "Easy.cl",
  "is_marketplace": false,
  "url": "https://www.easy.cl/martillo-soldador-hela-1346694/p",
  "page": 1,
  "position": 1
}

El registro OUTPUT incluye:

• status: ok, no_results, blocked o error.
• search_term, total_results_reported, total_products_scraped y pages_scraped.
• Limites aplicados: maxItems, maxPages, pageSize y concurrency.
• Paginas consultadas, warnings, errores y productos agregados.

Casos de uso

• Monitoreo de precios de Easy Chile.
• Comparacion de precios entre Easy, Sodimac, Mercado Libre, Falabella u otros retailers.
• Alertas de cambios de precio, descuentos y disponibilidad.
• Analisis de categorias de herramientas, construccion, hogar, jardin, muebles y decoracion.
• Retail intelligence, ecommerce analytics, catalogos, BI y estudios de mercado chileno.
• Seguimiento de precios CencoPay, Cencosud/CAT, Precio Oferta y Precio Normal.

Buenas practicas

• Para pruebas rapidas usa maxItems entre 20 y 100.
• Para ejecuciones completas deja maxPages vacio y usa pageSize: 50.
• Si el sitio responde lento, baja concurrency a 1 o 2.
• Guarda raw_product si necesitas auditar cambios de contrato, sellers o precios.

Limitaciones conocidas

• Easy puede cambiar su contrato VTEX, nombres de promociones o reglas comerciales. Si eso ocurre, el Actor devuelve errores claros y conserva el contexto en OUTPUT.
• Los precios CencoPay/Cencosud dependen de ajustes promocionales entregados por el backend. Si el backend no entrega esos ajustes, los campos quedan en null.
• Algunos campos como rating o resenas solo se completan si Easy los incluye en la respuesta.
• La disponibilidad corresponde a la disponibilidad publica reportada por el backend al momento de la extraccion.

Keywords

Easy scraper, Easy Chile scraper, Easy.cl API, Easy productos, Easy precios, Easy stock, Easy Chile precios, scraper retail Chile, ecommerce Chile, monitoreo de precios, price monitoring Chile, retail intelligence Chile, Apify Easy, herramientas Easy, construccion Easy, CencoPay, Cencosud, Precio Oferta, Precio Normal.