web2clip · De página web a serie de clips con narración
Convierte una página web (preferiblemente interactiva) en una serie de clips cortos por capítulos + 1 clip resumen, en formato vertical 9:16 u horizontal 16:9, con presentador AI (voz ElevenLabs), efectos visuales sincronizados con la narración (bordes brillantes, cursor que hace clic, desplazamiento de barras, subtítulos) y datos 100% precisos porque se graban desde la página real.
Subcomandos (para usar solo una fase)
| Comando | Fase |
|---|---|
/web2clip-setup | 1–2 · Verificar conexión, herramientas, permisos de red, cuentas |
/web2clip-plan | 3 · Leer la web, proponer ideas, guion + panel de revisión (dashboard) |
/web2clip-voice | 4–5 · Proponer voces, generar voz para cada clip, descargar archivos |
/web2clip-record | 4 · Grabar video sincronizado con la voz, exportar cada clip |
/web2clip-merge | 6 · Unir el clip resumen, nombrar, entregar archivos, almacenar |
Ejecutar /web2clip = recorrer las 7 fases siguientes en orden. No omitir el paso de revisión.
Reglas de oro (extraídas de proyectos reales)
- Revisar el texto antes de gastar dinero: el guion debe ser aprobado antes de generar la voz (la voz consume créditos).
- Hacer un clip de prueba primero (piloto) para que el usuario apruebe la voz + el estilo de efectos, y luego producir en masa.
- La voz es la del presentador, no lee el texto de la web. Tiene un nombre de personaje (ej. "Chip, asistente de Juan"), usa un tono amigable, comienza con una pregunta o situación y termina con un enlace al siguiente segmento.
- Divide la serie en clips cortos por capítulos (1–2 minutos) y luego únelos en el clip resumen. No hagas un clip largo desde el principio.
- El video debe seguir la narración: cuando se menciona una parte, esa parte se ilumina en el momento exacto. Usa el grabador sincronizado con marcadores ocultos (
scripts/w2c/record.py), no estimes manualmente. - Pregunta al usuario máximo 1–3 veces por interacción, con opciones predefinidas. Informa honestamente sobre los límites.
Proceso de 7 fases
1. Verificar conexión → ver /web2clip-setup
Ejecuta python -m w2c.check_env (dentro del directorio scripts/). Muestra una tabla: qué herramientas están disponibles, qué conexiones están activas (ElevenLabs, Drive, Canva, navegador). Si falta algo, sugiere instalarlo + instrucciones para crear cuentas.
2. Preparar MCP / API / permisos
Si faltan permisos de red → guía al usuario para que abra los dominios correctos (lista en setup). Si falta la conexión a ElevenLabs → invita a conectarse. Recuerda elegir "Permitir siempre" cuando aparezca el mensaje de permiso de la herramienta.
3. Generar ideas → ver /web2clip-plan
Lee la página web, enumera capítulos/secciones, propone: encuadre, duración, voz, presentador, cuántos clips dividir. Escribe un guion de dos columnas (Narración · Efecto en la web). Crea un panel de revisión (w2c.dashboard) y envía el enlace para que el usuario tenga una visión general y apruebe cada clip.
4. Guion → voz → grabación → edición de cada clip
Voz: /web2clip-voice. Grabación: /web2clip-record. Actualiza el panel después de cada clip.
5. Proponer voz
Filtra voces por idioma, género, edad, región; ofrece 2–3 opciones con justificación; por defecto elige una voz natural, narrativa.
6. Clip resumen → ver /web2clip-merge
Une en orden, nombra <Proyecto>_Clip<N>_<NombreParte>.mp4, el clip resumen se llama 0. ..._RESUMEN para que siempre aparezca primero en el directorio.
7. Entrega hasta que esté 100% satisfecho
Envía el archivo + actualiza el panel, revisa automáticamente el encuadre antes de enviar (extrae 4–6 fotogramas por clip), lista los errores detectados automáticamente, corrige hasta que el usuario lo apruebe. Guarda el guion, la voz y las especificaciones para poder hacer cambios rápidamente.
Documentación de referencia
references/errores-comunes.md— errores encontrados y cómo evitarlos (OBLIGATORIO leer antes de grabar).references/escribir-guion.md— cómo escribir una narración atractiva + plantilla de guion.references/elegir-voz.md— cómo proponer voces, estimar créditos, planes de ElevenLabs.examples/spec_example.json(en la raíz del repositorio) — ejemplo de archivo de especificaciones para el guion.