---
id: "US-SCR-002"
title: "Scraping de propiedades desde Vivanuncios"
type: "User Story"
epic: "IAI-007"
status: "Draft"
story_points: 8
priority: "Alta"
project: "inmobiliaria-analytics"
created_date: "2026-01-04"
updated_date: "2026-01-04"
---

# US-SCR-002: Scraping de propiedades desde Vivanuncios

---

## User Story

**Como** administrador del sistema
**Quiero** que el sistema extraiga automaticamente propiedades de Vivanuncios
**Para** complementar datos de Inmuebles24 y tener mayor cobertura del mercado

---

## Descripcion

Implementar un scraper para el portal Vivanuncios que reutilice la infraestructura base del scraper de Inmuebles24, adaptando los selectores y mappings especificos del sitio.

---

## Criterios de Aceptacion

### Funcionales

- [ ] El scraper navega y extrae listados de Vivanuncios
- [ ] Extrae todos los campos del schema normalizado
- [ ] Maneja paginacion del sitio
- [ ] Datos se almacenan en formato unificado

### Tecnicos

- [ ] Reutiliza motor de scraping base
- [ ] Selectores especificos para Vivanuncios
- [ ] Mappings de campos documentados
- [ ] Tests de integracion especificos

---

## Campos a Extraer

```yaml
Mappings_Vivanuncios:
  property_type:
    "Casa en Venta": house
    "Departamento en Venta": apartment
    "Terreno en Venta": land

  precio:
    selector: "[data-testid='price']"
    transform: "parse_mexican_currency"

  ubicacion:
    selector: "[data-testid='location']"
    transform: "split_city_state"

  caracteristicas:
    selector: "[data-testid='features'] li"
    parse: "extract_key_value"
```

---

## Tareas Tecnicas

| # | Tarea | Estimacion |
|---|-------|------------|
| 1 | Analizar estructura HTML Vivanuncios | 2h |
| 2 | Crear selectores especificos | 2h |
| 3 | Implementar mappings de campos | 2h |
| 4 | Adaptar navegacion de listados | 2h |
| 5 | Tests de integracion | 2h |

**Total estimado:** 10h (~1.5 dias)

---

## Definition of Done

- [ ] Scraper extrae 500+ propiedades sin bloqueos
- [ ] Datos se normalizan correctamente
- [ ] Tests pasan
- [ ] Documentacion actualizada

---

**Asignado a:** -
**Sprint:** -