Exito Supermarket & Retail Data Extractor 🛒🇨🇴

Desbloquea el catálogo completo de exito.com, una de las cadenas de retail, tecnología y supermercados más grandes de Colombia. Obtén acceso inmediato y en tiempo real a miles de productos, precios actualizados, descuentos, marcas y especificaciones técnicas detalladas.

Diseñado con tecnología de extracción inteligente de alta velocidad y conexión directa optimizada, este actor garantiza la máxima velocidad, fiabilidad y eficiencia de costos del mercado.

---

🌟 Casos de Uso Principales

• 📉 Monitoreo de Precios y Competencia: Rastrea cambios de precios diarios, ofertas relámpago y promociones para ajustar tu estrategia comercial.
• 📊 Investigación de Mercado: Analiza qué marcas dominan cada categoría y descubre tendencias de mercado en Colombia.
• 🛍️ Enriquecimiento de Catálogos y E-commerce: Sincroniza productos con tu propia tienda online o base de datos en cuestión de minutos.

---

🔍 Modo Descubrimiento (discovery_mode)

[!IMPORTANT] ¿CÓMO FUNCIONAN LOS FILTROS EN ÉXITO? En Éxito.com, cada categoría tiene filtros únicos (por ejemplo: la categoría Televisores tiene el filtro resolucion-de-la-pantalla, mientras que Calzado tiene talla).

Si deseas conocer exactamente qué filtros existen para una búsqueda específica, activa el Modo Descubrimiento (discovery_mode: true).

[!WARNING] ATENCIÓN SOBRE EL MODO DESCUBRIMIENTO: Este modo se utiliza SOLAMENTE para detectar e identificar la lista de filtros válidos y sus opciones disponibles para una búsqueda. EL MODO DESCUBRIMIENTO NO EXTRAE PRODUCTOS.

Una vez que identifiques la clave y el valor del filtro que te interesa (ej. resolucion-de-la-pantalla=Uhd-4K o talla=40), desactiva el Modo Descubrimiento (discovery_mode: false) y coloca esos valores en los selectores de entrada o en el campo Filtros Dinámicos Adicionales (custom_filters).

---

🚀 Flujo de Trabajo Recomendado

1. Paso 1 (Opcional - Descubrir Filtros):
   • Ingresa tu palabra clave en search_term (ej. televisor).
   • Activa discovery_mode: true.
   • Ejecuta el actor. Obtendrás un listado estructurado con todos los filtros disponibles para esa búsqueda (ej. Clave: resolucion-de-la-pantalla, Opciones: Uhd-4K, Full-Hd, etc.).
2. Paso 2 (Configurar Búsqueda Normal):
   • Desactiva discovery_mode: false.
   • Si el filtro que deseas está en los menú desplegables (Departamento, Marca, etc.), selecciónalo directamente.
   • Si es un filtro específico descubierto en el Paso 1, escríbelo en Filtros Dinámicos Adicionales (custom_filters) con el formato Clave=Valor (ej: resolucion-de-la-pantalla=Uhd-4K).
3. Paso 3 (Ejecutar y Descargar):
   • Ejecuta el actor y descarga los resultados en JSON, CSV, Excel o consúmelos directamente por la API de Apify.

---

🧾 Campos estándar para comparar cadenas (nuevo)

Además de los campos de siempre, cada producto trae columnas iguales en los scrapers de Éxito, Carulla, Jumbo y Olímpica, para cruzarlos sin limpiar datos:

Campo	Qué es
Cadena	Éxito
EAN	Código de barras (EAN/GTIN) con dígito de control verificado. Es la llave para comparar el mismo producto entre cadenas.
SKU, Referencia_Cadena	Identificadores internos de la tienda.
Precio_Lista, Precio_Venta, Descuento_Pct, En_Promocion	Precios numéricos y descuento calculado.
Promociones	Nombres de las promociones activas (cuando la tienda las publica).
Contenido_Total, Unidad_Base, Unidades_Empaque	Contenido total del empaque en g, ml o unidades (ej. bolsa x6 de 1.100 ml = 6.600 ml).
Precio_Kg_L	Precio por kilo, por litro o por unidad: compara presentaciones distintas.
Disponible, Stock_Disponible	Disponibilidad online (el stock solo es informativo por debajo de 10.000).
Vendedor, Vendido_Por_Cadena	Quién vende: la cadena o un vendedor del marketplace.
Departamento, Categoria_Nivel_2, Categoria_Nivel_3, Ruta_Categoria	Árbol de categorías de la tienda.
Imagen_URL, Fecha_Extraccion, Moneda	Imagen, fecha UTC de la lectura y moneda (COP).

🧺 Modo canasta: los mismos productos en todas las cadenas (nuevo)

Ideal para monitorear precios todos los días con la misma canasta:

{
  "eans": ["7702001029716", "7702511000045"],
  "terms": ["leche deslactosada", "café molido"],
  "max_items_per_term": 50
}

• eans: busca cada código de barras y devuelve ese producto exacto. Los que la cadena no vende quedan en el registro OUTPUT como no_encontrados.
• terms: toma los primeros max_items_per_term productos de cada búsqueda, sin repetir, con el mismo orden en todas las cadenas.
• Si usas cualquiera de los dos, el actor no hace la búsqueda normal. Corre la misma entrada en los cuatro scrapers y une los resultados por EAN.

⚙️ Parámetros de Entrada (Input)

Parámetro	Tipo	Descripción	Ejemplo
search_term	String	Palabra clave o término de búsqueda en Éxito.	"televisor"
max_items	Integer	Cantidad máxima de productos a extraer. Usa 0 para extraer todo el catálogo devuelto.	100
discovery_mode	Boolean	SOLO para detectar filtros. Si se activa, devuelve los filtros disponibles y se detiene (NO extrae productos).	false
custom_filters	String	Filtros dinámicos en formato Clave=Valor separados por coma.	"resolucion-de-la-pantalla=Uhd-4K"
category_1	String	Selección de Departamento principal.	"tecnologia"
category_2	String	Selección de Categoría secundaria.	"televisores"
brand	String	Selección de Marca.	"samsung"
price	String	Rango de precio en formato Min:Max.	"1000000:3000000"

---

📊 Ejemplo de Resultados (Output)

1. Salida en Modo Búsqueda Normal (Extracción de Productos)

{
  "ID": "3688427",
  "Nombre": "Televisor SAMSUNG 58 pulgadas LED Uhd4K Smart TV",
  "Marca": "SAMSUNG",
  "Precio_Original": 2399900,
  "Precio_Final": 1699900,
  "URL_Producto": "https://www.exito.com/televisor-samsung-58-pulgadas-led-uhd4k-smart-tv-3688427/p",
  "Informacion_Adicional": {
    "Referencia": "UN58U8000FKXZL",
    "Resolución de la pantalla": "Uhd-4K",
    "Tipo de pantalla": "LED",
    "Tamaño de pantalla": "58\" pulgadas",
    "Garantía": "1 AÑO"
  }
}

2. Salida en Modo Descubrimiento (discovery_mode: true)

{
  "Filtro": "Resolución de la pantalla",
  "Clave": "resolucion-de-la-pantalla",
  "Opciones": [
    {
      "Nombre": "Uhd-4K",
      "Valor_Slug": "Uhd-4K"
    },
    {
      "Nombre": "Full-HD",
      "Valor_Slug": "Full-HD"
    }
  ]
}

---

💰 Rentabilidad y Costos

Optimizado para consumir el mínimo de memoria y tiempo de CPU:

• Solo ~$1 USD por cada 1,000 productos extraídos.

---

⚡ Rendimiento y Alta Disponibilidad

• Arquitectura optimizada para extracción masiva de alta velocidad.
• Sistema de resiliencia automatizado con reintentos inteligentes ante fluctuaciones de red.
• Integración nativa con Apify Proxy para máxima estabilidad y continuidad operativa.