Paris Chile Scraper

Extrae productos desde la busqueda publica de Paris.cl usando el backend JSON del sitio. El Actor recibe un termino de busqueda, recorre la paginacion disponible y guarda un dataset listo para monitoreo de precios, comparacion de productos, retail intelligence y analisis del ecommerce chileno.

El scraper esta pensado para usuarios que necesitan datos accionables de Paris: precios actuales, precio normal, precio con tarjeta, descuento, marca, categoria, vendedor, disponibilidad, URL del producto, imagen e identificadores originales para trazabilidad.

Que hace

• Busca productos en Paris Chile por termino ingresado por el usuario.
• Recorre automaticamente la paginacion completa cuando hay mas resultados.
• Permite limitar la ejecucion con maxItems, maxPages, pageSize y concurrency.
• Normaliza campos clave para analisis de datos y BI.
• Conserva el producto crudo serializado en raw_product para auditoria y enriquecimiento posterior.
• Entrega un resumen completo en OUTPUT con paginas recorridas, total reportado, facets, breadcrumbs y metadata de busqueda.

Como usarlo

Configura el input con un termino de busqueda. Para una prueba rapida:

{
  "term": "televisor",
  "maxItems": 100
}

Para recorrer mas resultados con control de paginacion:

{
  "term": "notebook",
  "maxPages": 5,
  "pageSize": 100,
  "concurrency": 4,
  "sort": "price asc"
}

Para una ejecucion acotada de monitoreo:

{
  "term": "zapatillas mujer",
  "maxItems": 50,
  "sort": "best-discount desc"
}

Inputs disponibles

Campo	Tipo	Descripcion
term	string	Termino principal de busqueda. Requerido.
maxItems	integer	Maximo de productos a guardar. Util para controlar costos y pruebas.
maxPages	integer	Maximo de paginas a recorrer. Si se omite, usa toda la paginacion disponible o se detiene al llegar a maxItems.
pageSize	integer	Productos solicitados por pagina. El maximo validado es 200.
concurrency	integer	Paginas procesadas en paralelo.
sort	string	Ordenamiento: relevance, price desc, price asc, best-discount desc, created-at desc, rating desc.
retries	integer	Reintentos por pagina.
timeoutSecs	integer	Timeout por solicitud al backend.
failOnNoResults	boolean	Si esta activo, falla cuando Paris no devuelve productos.

Output

Cada item del dataset representa un producto encontrado en Paris.cl.

Campo	Descripcion
product_id	ID original del producto en Paris.
sku	SKU principal del producto.
name	Nombre publico del producto.
brand	Marca.
price	Precio oferta o precio principal en CLP.
normal_price	Precio regular o precio anterior.
card_price	Precio con tarjeta Cencosud u otro metodo informado.
discount_percentage	Descuento porcentual respecto del precio normal.
currency	Moneda del precio.
is_available / availability	Disponibilidad normalizada.
category / category_id	Categoria principal inferida desde la busqueda.
department_id, subdepartment_id, class_id	Codigos originales de clasificacion.
seller_name, sellers, is_marketplace	Datos de vendedor y marketplace.
url	URL publica del producto.
image	Imagen principal.
rating, reviews_count	Senales de valoracion cuando Paris las informa.
page, position	Ubicacion aproximada en la busqueda.
raw_product	Producto original serializado como JSON para trazabilidad.
search_term, scraped_at	Termino usado y fecha de extraccion.

Casos de uso

• Monitoreo de precios de productos y categorias en Paris Chile.
• Comparacion de precios entre retailers chilenos.
• Seguimiento de descuentos y precios con tarjeta.
• Retail intelligence para marcas, marketplaces y equipos comerciales.
• Analisis de surtido, disponibilidad, vendedores y presencia de marca.
• Datasets para dashboards, modelos de pricing, alertas y reportes periodicos.

Beneficios

• Usa una via backend JSON rapida y estable en vez de depender del render visual del sitio.
• Reduce tiempo de ejecucion y consumo de recursos frente a un scraper de navegador completo.
• Entrega datos normalizados y datos crudos en la misma ejecucion.
• Permite controlar volumen y costo con limites configurables.

Limitaciones conocidas

• Los precios, descuentos, stock y disponibilidad pueden cambiar sin aviso en Paris.cl.
• El sitio puede aplicar limites temporales o bloqueos si se ejecuta con demasiada concurrencia.
• Algunos campos dependen de que Paris los informe en la respuesta de busqueda; si no existen, el Actor los deja vacios o null.
• La categoria principal se infiere desde breadcrumbs o facets de la busqueda, no desde una ficha de producto individual.
• Paris puede devolver resultados sugeridos o aproximados para terminos con pocas coincidencias.

Notas tecnicas

El Actor consulta el endpoint de busqueda usado por Paris:

https://be-paris-backend-cl-ms-search.ccom.paris.cl/products/

Playwright fue usado solo para descubrir el flujo de red. La ejecucion productiva usa HTTP directo con requests, paginacion concurrente y reintentos.