---
name: video-overlays-inmobiliaria
description: Genera overlays de texto elegantes (PNGs 1920x1080 con fondo negro + textos.txt) para videos inmobiliarios editados en Filmora, a partir del URL de una propiedad. Produce 3 clips por propiedad — hook (título + ubicación), características (recámaras, baños, m²) y cierre (precio + CTA + logo) — con el branding del cliente inmobiliario. Activar SIEMPRE que el usuario pida textos u overlays para video de una propiedad, mencione "overlays inmobiliarios", "textos para video de propiedad", "clips para Filmora", dé un URL de propiedad para hacer video, o quiera generar los gráficos de los 3 clips de un video inmobiliario.
---

# Video Overlays Inmobiliaria

Genera los overlays de texto de un video inmobiliario en 3 etapas, listos para animar en Filmora con blend "Screen" (el fondo negro desaparece sobre el video).

## Entrada

El usuario da el **URL de la propiedad** (o un JSON con los datos). Normalmente son propiedades de un sitio WordPress con Schema Markup.

## Flujo (seguir en orden)

### 1. Extraer datos de la propiedad

- Descargar la página con `web_fetch` (NUNCA con curl/requests).
- Buscar el bloque `<script type="application/ld+json">` con `"@type": "RealEstateListing"` (o similar: `Product`, `House`, `SingleFamilyResidence`).
- Guardar un archivo `datos_<slug>.json` con esta estructura: `{"json_ld": { ...el JSON-LD completo... }}`.
- Si la página NO tiene JSON-LD, extraer manualmente del texto: título, ubicación, precio, recámaras, baños, m² de terreno y construcción, extras (alberca, jardín, terraza, etc.) y guardar en formato simple:

```json
{
  "titulo": "CASA EN VENTA",
  "subtitulo": "CON ALBERCA",
  "ubicacion": "Zibatá · El Marqués",
  "precio": 9500000,
  "moneda": "MXN",
  "recamaras": 3,
  "banos": 2,
  "terreno_m2": 300,
  "construccion_m2": 360,
  "extras": ["Alberca", "Jardín"],
  "cta": "Agenda tu visita"
}
```

- Si falta un dato clave (precio o ubicación), preguntar al usuario antes de generar.

### 2. Localizar la configuración de marca

- Buscar `video_overlays/brand.json` en la carpeta del proyecto/cliente. Para Nodo Inmobiliario ya existe en `Nodo Inmobiliario/video_overlays/brand.json`.
- Si es un cliente nuevo y no existe, pedir al usuario: nombre de marca, sitio web, ruta del logo (PNG transparente), y colores (acento, texto claro). Crear el `brand.json`:

```json
{
  "nombre": "NOMBRE MARCA",
  "web": "sitio.com",
  "logo": "ruta/al/logo.png",
  "dorado": "#F59E0B",
  "blanco": "#F7F3EC",
  "crema": "#E8E2D6",
  "muted": "#B8B2A6"
}
```

- Regla de diseño: sobre fondo negro usar SOLO colores claros/brillantes (el blend Screen elimina lo oscuro).

### 3. Generar los overlays

- Verificar dependencia: `pip install cairosvg --break-system-packages` si no está instalada.
- Ejecutar el script incluido en este skill (o el del cliente si existe en su carpeta `video_overlays/`):

```
python3 scripts/generate_overlays.py <datos.json> [carpeta_salida] [brand.json]
```

- Salida por propiedad (carpeta con slug del título):
  - `clip1_hook.png` — título + subtítulo distintivo + ubicación
  - `clip2_caracteristicas.png` — recámaras, baños, m² terreno/construcción + extras
  - `clip3_precio.png` — logo + precio + CTA + sitio web
  - `textos.txt` — todos los textos por clip (para texto nativo de Filmora)

- Guardar la salida en la carpeta del cliente: `<cliente>/video_overlays/output/<slug>/`.

### 4. Verificar y entregar

- Leer los 3 PNGs generados para verificar visualmente: textos completos (sin cortes), centrados, colores de marca correctos, logo visible.
- Presentar los archivos al usuario con `present_files`.
- Recordar al usuario: en Filmora importar los PNGs sobre el video, aplicar blend **Screen** (Pantalla) para que desaparezca el negro, y animar la entrada/salida.

## Notas

- Formato: 1920x1080 (16:9). Si el usuario pide vertical 9:16 o cuadrado, ajustar W/H en el script y reacomodar las posiciones proporcionalmente.
- Los overlays usan tipografía Lato (títulos, letter-spacing amplio) y Lora itálica (acentos serif) — instaladas en el entorno.
- El precio se formatea con comas automáticamente ($9,500,000).
- Para lotes de varias propiedades, repetir el flujo por cada URL; cada una queda en su propia carpeta.
