inmobiliaria-analytics/docs/01-fase-alcance-inicial/IAI-007-webscraper/historias-usuario/US-SCR-002.md

id	title	type	epic	status	story_points	priority	project	created_date	updated_date
US-SCR-002	Scraping de propiedades desde Vivanuncios	User Story	IAI-007	Draft	8	Alta	inmobiliaria-analytics	2026-01-04	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

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: -