README.md

---
title: SamuelHouseFinderApp
emoji: 👁
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
pinned: false
---

SamuelHouseFinder - Playwright backend + Gradio UI
=================================================

Requisitos mínimos:
- Docker (recomendado) o Python 3.10+ con Playwright instalado y browsers.
- Si vas por Docker, el contenedor ya trae los browsers en la imagen oficial.

Pasos con Docker:
1) Clonar este repo y posicionarte en la carpeta.
2) Build: docker build -t samuelhousefinder:latest .
3) Run: docker run -p 8000:8000 -p 7860:7860 --name samuel -v $(pwd)/data:/app/data -e PROXY_LIST="http://user:pass@ip:port" samuelhousefinder:latest
   (Opcional) Usá docker-compose: docker-compose up --build

Variables de entorno útiles:
- PROXY_LIST: lista separada por comas de proxies (http://user:pass@ip:port)
- CAPTCHA_API_KEY: clave 2Captcha si querés integrar resolución (no implementado por defecto)
- DEFAULT_MAX_PAGES: páginas por fuente (default 2)
- MAX_BROWSERS: concurrencia de navegadores (default 2)

Uso:
- Abrir UI: http://localhost:7860
- API: POST /api/scrape  { "location": "Saavedra", "sources":["mercadolibre","properati"], "max_pages":2 }
- Consultar DB: GET /api/search?q=Saavedra

Notas:
- Para producción: agregar proxy residencial, rotación avanzada, manejo de CAPTCHA y migrar DB a Postgres.
- Respetá TOS de cada portal. Si querés comercializar datos, negociá APIs oficiales.