Sodimac Chile Scraper - Ferretería y Precios

Sodimac Chile scraper para ferretería, hogar y precios

El Sodimac Chile scraper convierte la búsqueda pública de Sodimac.cl en datos estructurados de herramientas, construcción, ferretería, muebles, jardín y decoración. Extrae productos, precios, descuentos, stock publicado, marcas, vendedores, imágenes y enlaces para evitar la recolección manual.

Úsalo como una API de precios de Sodimac y Homecenter Chile para monitoreo competitivo, comparación de catálogos, inteligencia retail y reportes recurrentes. Los resultados quedan disponibles en Dataset, JSON, CSV, Excel, XML o mediante la API de Apify.

Que hace este Actor

• Busca productos por termino, marca o categoria detectada por Sodimac, por ejemplo Taladro, pintura blanca, martillo, Bosch o ceramica.
• Recorre la paginacion disponible cuando existen mas resultados.
• Respeta maxItems, maxPages y concurrency para controlar costo, velocidad y alcance.
• Deduplica productos por ID, SKU o URL.
• Guarda filas limpias en el Dataset de Apify y conserva raw_product para trazabilidad.
• Genera un OUTPUT con estado, termino, total reportado por el sitio, paginas scrapeadas, limites aplicados, warnings y errores.

Datos que extrae

Cada producto puede incluir:

Campo	Descripcion
search_term	Termino usado para la corrida.
scraped_at	Fecha y hora de extraccion.
product_id	ID original del producto en Sodimac.
sku	SKU principal o SKU del vendedor.
name	Nombre publico del producto.
brand	Marca.
price	Precio principal normalizado.
normal_price / previous_price	Precio normal, anterior o tachado cuando existe.
card_price	Precio CMR u otro precio de tarjeta cuando existe.
discount_percentage	Descuento informado o calculado.
currency	Moneda, normalmente CLP.
is_available	Disponibilidad normalizada.
availability	Texto de despacho, retiro, stock o badges asociados.
category	Categoria principal cuando el flujo la entrega.
category_id	ID de categoria reportado por Sodimac.
seller_name	Vendedor principal.
is_marketplace	Indica si el vendedor parece ser tercero.
url	URL publica del producto cuando Sodimac la entrega. En algunos resultados generales, Sodimac no entrega URL de PDP y el Actor usa una URL de busqueda por producto como fallback.
image	Imagen principal.
rating	Calificacion promedio cuando existe.
reviews_count	Numero de resenas o calificaciones.
page	Pagina donde aparecio el resultado.
position	Posicion global dentro de la extraccion.
merchant_category_id, gsc_category_id, offering_id, seller_id	Identificadores originales relevantes.
raw_product	JSON original del producto para auditoria y cambios futuros del contrato.

Ejemplo de input

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

Ejemplo de output

El Dataset contiene filas como:

{
  "search_term": "Taladro",
  "product_id": "114087187",
  "sku": "114087188",
  "name": "Kit Taladro Perc.+ Atornillador 20v + 2 Bat Dck223d2",
  "brand": "DEWALT",
  "price": 271990,
  "normal_price": 349990,
  "card_price": 254990,
  "discount_percentage": 27,
  "currency": "CLP",
  "seller_name": "TUS HERRAMIENTAS",
  "is_marketplace": true,
  "url": "https://www.sodimac.cl/sodimac-cl/articulo/114087187/Kit-Taladro-Perc.+-Atornillador-20v-+-2-Bat-Dewalt-Dck223d2?exp=so_com",
  "page": 1,
  "position": 1
}

El registro OUTPUT resume la corrida:

{
  "status": "ok",
  "search_term": "Taladro",
  "source_flow": "listing",
  "total_results_reported": 461,
  "total_products_scraped": 100,
  "pages_scraped": 3,
  "limits": {
    "maxItems": 100,
    "maxPages": 3,
    "pageSize": 28,
    "effectivePageSize": 48
  }
}

Referencia de input

Campo	Tipo	Requerido	Descripcion
term	string	si	Producto, marca o texto a buscar en Sodimac.cl.
maxItems	integer	no	Maximo de productos a guardar. Default recomendado: 100.
maxPages	integer	no	Maximo de paginas a recorrer. Si se omite, recorre hasta completar la paginacion o maxItems.
pageSize	integer	no	Tamano solicitado. Sodimac actualmente fija el tamano real del backend y el Actor reporta effective_page_size.
sort	string	no	recommended, price_asc, price_desc, newest, rating_desc, name_asc o brand_asc.
concurrency	integer	no	Paginas procesadas en paralelo. Default: 4.
retries	integer	no	Reintentos por pagina. Default: 3.
timeoutSecs	integer	no	Timeout por solicitud. Default: 30.
failOnNoResults	boolean	no	Si es true, falla cuando no hay productos. Si es false, deja OUTPUT.status = no_results.

Casos de uso

Caso de uso	Como ayuda
Monitoreo de precios Sodimac	Captura precio actual, precio normal, descuento y precio CMR cuando existen.
Retail intelligence Chile	Analiza surtido, marcas, categorias, sellers y cambios en resultados de busqueda.
Comparacion de productos	Cruza herramientas, materiales, muebles o articulos de construccion con otros retailers.
Inteligencia competitiva	Detecta precios de marketplace, productos patrocinados y cambios de posicion.
Analisis ecommerce	Crea datasets para dashboards, BI, alertas de precio, catlogos y estudios de mercado.
Reportes recurrentes	Programa corridas en Apify y exporta JSON, CSV, Excel, XML o API.

Buenas practicas

• Usa maxItems para pruebas y monitoreos diarios. Un valor de 100 suele ser suficiente para smoke tests y validaciones.
• Aumenta maxPages o elimina el limite solo cuando necesites cobertura completa.
• Baja concurrency si el sitio responde lento o ves errores temporales.
• Revisa OUTPUT.warnings: Sodimac fija el tamano real de pagina en el backend, aunque el input conserve pageSize para compatibilidad.
• Para terminos amplios como pintura blanca, define maxItems para controlar costo y volumen.

Precio

Este Actor usa pago por evento. Cada producto guardado correctamente cuesta USD 0.003 mediante el evento result, y cada ejecución agrega un evento inicial de USD 0.00005. Usa maxItems y maxPages para controlar el volumen. La pestaña Pricing de Apify es la referencia vigente antes de ejecutar.

Limitaciones conocidas

• Sodimac usa dos flujos publicos distintos. El Actor los detecta automaticamente, pero cambios de contrato pueden requerir ajustes.
• Algunas busquedas generales no entregan URL de producto en el JSON; en esos casos el campo url usa una URL de busqueda por producto como fallback y el objeto crudo queda en raw_product.
• Disponibilidad, despacho, retiro y stock dependen de lo que Sodimac entregue publicamente en el momento de la corrida.
• Los precios y promociones pueden cambiar por ubicacion, sesion, campana o reglas comerciales del sitio.
• Si Sodimac bloquea, limita o cambia la respuesta, el Actor marca status como blocked o error y registra el detalle en OUTPUT.errors.

Uso desde API

Python

from apify_client import ApifyClient

client = ApifyClient("<APIFY_API_TOKEN>")
run = client.actor("scraperschile/sodimac").call(
    run_input={"term": "Taladro", "maxItems": 100}
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item["price"], item["url"])

cURL

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <APIFY_API_TOKEN>' \
  -d '{"term":"Taladro","maxItems":100}' \
  'https://api.apify.com/v2/acts/scraperschile~sodimac/runs?waitForFinish=60'

Uso responsable

Este Actor extrae informacion publica de catalogo. No usa cuentas de clientes, no recopila datos privados, no interactua con carritos, pedidos ni credenciales. Usalo de forma responsable y respeta los terminos aplicables de Apify y Sodimac.

Preguntas frecuentes

¿Puedo monitorear precios y ofertas de Sodimac?

Si. Programa búsquedas recurrentes con el mismo término y compara price, normal_price, card_price y discount_percentage cuando esos valores estén publicados.

¿Incluye productos de vendedores marketplace?

Cuando la respuesta pública identifica al vendedor, el Dataset incluye seller_name e is_marketplace. La cobertura depende del flujo de resultados utilizado por Sodimac para cada búsqueda.

¿Confirma stock de una tienda específica?

No. is_available y availability son señales públicas observadas durante la corrida. Verifica despacho, retiro y disponibilidad final en la ficha del producto antes de tomar una decisión.

¿Necesita una cuenta de Sodimac?

No. El Actor utiliza resultados públicos y no accede a cuentas, carritos, pedidos ni credenciales.

Independencia

Este Actor es una herramienta no oficial e independiente. No está afiliado, patrocinado ni respaldado por Sodimac, Homecenter ni Sodimac.cl.