# Catálogo de Portales

El sistema soporta **20 portales inmobiliarios**. Los **6 primeros están activos**; el resto están disponibles pero desactivados (en desarrollo o requieren verificación).

---

## Portales Activos (6)

### 1. Fotocasa
- **URL base:** https://www.fotocasa.es
- **Scraper:** `FotocasaPlaywrightScraper` (Playwright)
- **Tecnología:** React SPA — requiere Chromium headless
- **Formato URL:** `/es/comprar/viviendas/{slug}-valencia/todas-las-zonas/l`
- **Notas:** Segundo portal más grande de España. Usa stealth para evadir anti-bot.

### 2. Globaliza
- **URL base:** https://www.globaliza.com
- **Scraper:** `GlobalizaScraper` (Cheerio)
- **Formato URL:** `/venta/viviendas/{globaliza_slug}`
- **Notas:** Fuerte presencia en Comunidad Valenciana. Incluye obra nueva. El `globaliza_slug` usa el nombre valenciano del municipio (p.ej. `vilamarxant` para Villamarchante).

### 3. Habitaclia
- **URL base:** https://www.habitaclia.com
- **Scraper:** `HabitacliaScraper` (Cheerio)
- **Formato URL:** `/comprar-casas-en-{slug}` y `/comprar-pisos-en-{slug}`
- **Notas:** Fuerte presencia en Comunidad Valenciana y Cataluña.

### 4. Idealista
- **URL base:** https://www.idealista.com
- **Scraper:** `IdealistaPlaywrightScraper` (Playwright)
- **Tecnología:** JavaScript dinámico — requiere Chromium headless
- **Formato URL:** `/venta-viviendas/{slug}-valencia/municipio/`
- **Paginación:** Hasta 5 páginas por zona (≈ 60 anuncios/pág → 1300+ propiedades).
- **Excepciones:**
  - Valencia: excluida (`idealistaSkip`) — demasiados resultados.
  - Moncofa: usa sufijo `-castellon` (province suffix override).
  - Slugs especiales: eliana→l-eliana, riba-roja→riba-roja-de-turia, pobla-de-vallbona→la-pobla-de-vallbona, villamarchante→vilamarxant.
- **Notas:** El más completo de España. El scraper usa evasión stealth con Playwright.

### 5. Pisos.com
- **URL base:** https://www.pisos.com
- **Scraper:** `PisosScraper` (Cheerio)
- **Formato URL:** `/venta/{pisos_slug}/` (usa `pisos_slug` de la tabla `zones`)
- **Paginación:** Hasta 10 páginas por zona (`?pagina=N`).
- **Notas:** El slug para pisos.com es distinto al slug base; configura en la tabla `zones`.

### 6. ThinkSpain
- **URL base:** https://www.thinkspain.com
- **Scraper:** `ThinkSpainScraper` (Cheerio)
- **Formato URL:** `/property-for-sale/{thinkspain_slug}`
- **Notas:** Portal en inglés para expatriados. Zonas sin `thinkspain_slug` (NULL) son omitidas automáticamente. Cubre 12 de las 15 zonas.

---

## Portales Disponibles (Desactivados)

### 7. Casasapo
- **URL base:** https://www.casasapo.com
- **Scraper:** `CasasapoScraper` (Cheerio)
- **Formato URL:** `/venta/piso/municipio/{slug}/`
- **Notas:** Portal nacional de clasificados inmobiliarios.

### 8. Engel & Völkers
- **URL base:** https://www.engelvoelkers.com
- **Scraper:** `EngelVolkersScraper` (Cheerio)
- **Búsqueda:** `?q={nombre_zona}&contractType=buy&country=ESP`
- **Notas:** Inmobiliaria premium. Propiedades de mayor valor que la media.

### 9. ERA Spain
- **URL base:** https://www.era.es
- **Scraper:** `EraSpainScraper` (Cheerio)
- **Búsqueda:** `/comprar/residencial/?localidad={nombre_zona}`
- **Notas:** Franquicia ERA Real Estate.

### 10. Holprop
- **URL base:** https://www.holprop.com
- **Scraper:** `HolpropScraper` (Cheerio)
- **Formato URL:** `/property/spain/valencia/{slug}/`
- **Notas:** Portal UK para compradores británicos. Actualmente inestable — desactivado.

### 11. Inmobiliaria.es
- **URL base:** https://www.inmobiliaria.es
- **Scraper:** `InmobiliariaScraper` (Cheerio)
- **Formato URL:** `/comprar/{slug}`
- **Notas:** Directorio nacional de inmuebles en venta y alquiler.

### 12. Kyero
- **URL base:** https://www.kyero.com
- **Scraper:** `KyeroScraper` (Cheerio)
- **Formato URL:** `/es/propiedades-baratas/esp-valencia/{slug}-valencia`
- **Notas:** Portal orientado a compradores extranjeros (principalmente UK).

### 13. Milanuncios
- **URL base:** https://www.milanuncios.com
- **Scraper:** `MilanunciosScraper` (Cheerio)
- **Formato URL:** `/inmobiliaria/?demanda=n&poblacion={nombre_zona}`
- **Notas:** Clasificados. Puede incluir alquileres; requiere filtrado por precio.

### 14. Nuroa
- **URL base:** https://www.nuroa.es
- **Scraper:** `NuroaScraper` (Cheerio)
- **Formato URL:** `/venta/valencia/{slug}`
- **Notas:** Meta-buscador internacional. Agrega resultados de varios portales.

### 15. REMAX España
- **URL base:** https://www.remax.es
- **Scraper:** `RemaxScraper` (Cheerio)
- **Búsqueda:** `/comprarbuscar.aspx?term={nombre_zona}&country=ES`
- **Notas:** Red de agentes independientes; amplia cobertura nacional.

### 16. SpainHouses
- **URL base:** https://www.spainhouses.net
- **Scraper:** `SpainHousesScraper` (Cheerio)
- **Formato URL:** `/en/buy/houses-for-sale-in-{slug}.html`
- **Notas:** Portal internacional en inglés para compradores extranjeros.

### 17. Tecnocasa
- **URL base:** https://www.tecnocasa.es
- **Scraper:** `TecnocasaScraper` (Cheerio)
- **Formato URL:** `/venta/casas-y-pisos/comunidad_valenciana/valencia/{slug}.html`
- **Notas:** Franquicia inmobiliaria física con presencia en la comarca.

### 18. Trovit
- **URL base:** https://casas.trovit.es
- **Scraper:** `TrovatScraper` (Cheerio)
- **Formato URL:** `?what={nombre_zona}&country=es&type=1`
- **Notas:** **No operativo.** Trovit cerró su sección de inmuebles en España (redirige a Mitula/Nuroa). Clase conservada en el código pero portal desactivado en BD.

### 19. Vibbo
- **URL base:** https://www.vibbo.com
- **Scraper:** `VibboScraper` (Cheerio)
- **Formato URL:** `/pisos-casas/{slug}`
- **Notas:** Clasificados generales (Grupo Schibsted). Vibbo fue absorbido por Wallapop.

### 20. Yaencontre
- **URL base:** https://www.yaencontre.com
- **Scraper:** `YaencontreScraper` (Cheerio)
- **Formato URL:** `/pisos/venta/{slug}`
- **Notas:** Portal nacional integrado con pisos.com/Schibsted.

---

## Activar un Portal

Desde la interfaz web:
1. Ve a la sección **Portales**
2. Activa el toggle del portal deseado

Desde MySQL:
```sql
UPDATE portals SET active = 1 WHERE slug = 'kyero';
```

---

## Notas sobre Portales con Anti-bot

Los portales más grandes (Idealista, Fotocasa) usan Playwright para simular un navegador real. Si empiezan a bloquear el scraping:
1. Aumenta el delay entre peticiones (`pageTimeoutMs`)
2. Rota el User-Agent manualmente en `playwrightBaseScraper.ts`
3. Considera usar un proxy residencial