rea-video: analiza cómo está hecho cualquier vídeo (real, IA o código) con Claude Code
Ves un anuncio en TikTok que funciona y te preguntas: ¿está grabado con móvil, generado con IA o animado con código? ¿Cuántas cámaras usaron? ¿La voz es real o sintética? rea-video es una herramienta open source pensada para que un agente como Claude Code o Codex analice cómo está hecho un vídeo, plano a plano, y te entregue un informe con la receta para rehacerlo con tu propio material.
No genera vídeo: lo desmonta. Corta el vídeo en planos, separa voz, música y efectos, mide pruebas técnicas (cadencia de fotogramas, ruido del sensor, metadatos de IA), lee los subtítulos y decide qué técnica hay detrás de cada plano. Lo instalamos en un entorno en la nube de Claude Code (versión 0.1.0, commit 7515969 del 14 de noviembre de 2026) y lo probamos con un Short nuestro del que sabemos exactamente cómo se hizo.
Qué es rea-video
- Repositorio: github.com/JuneYaooo/rea-video
- Licencia: Apache-2.0, no MIT. Igual de permisiva para usarla gratis y en trabajos comerciales; si redistribuyes una versión modificada, conserva el aviso de licencia y el archivo
NOTICE. - Qué instala: una CLI en Python (
rea-video) y una skill para agentes (skills/rea-video/SKILL.md) que se enlaza en~/.claude/skills,~/.codex/skillso~/.agents/skills. - Requisitos: Python 3.10 o superior y ffmpeg.
- Idioma: el README está traducido al español, pero la documentación técnica (
docs/) y la skill están en chino, y los informes salen en chino o en inglés (--lang en). No hay informe en español.
Cada análisis produce dos salidas: un informe (report.html, exportable a PDF) para ti y un VIDEO.md, un formato abierto en capas para que la IA lea solo lo que necesita: una ficha de unos cientos de tokens, un resumen, una línea por plano y un archivo por plano.
Qué detecta en cada plano
| Tipo de vídeo | Qué te dice |
|---|---|
| Grabación real | Puestas de cámara, encuadre, movimientos, iluminación (12 esquemas con lista de equipo), etalonaje |
| Vídeo con IA | Pruebas, un prompt reconstruido por plano y qué modelo usar |
| Avatar | Qué planos son un retrato movido por audio y qué material necesitas |
| 3D o animación | Si conviene generarlo con un modelo de vídeo o renderizarlo con código 3D |
| Código o plantilla | Texto, maquetación y tiempos del movimiento, listo para rehacer en Remotion |
| Grabación de pantalla | Qué partes son material real que tendrás que grabar tú |
Además de la imagen, analiza los subtítulos (inicio y fin de cada línea, exportados a SRT y ASS con su estilo), stickers y textos animados, el montaje (dónde corta, a qué ritmo, si va al beat) y el sonido: voz humana o sintética, música de IA o de biblioteca con sus BPM y dónde cae cada efecto.
Prueba real: le pasamos un Short que hicimos nosotros
Para saber si acierta hay que darle un vídeo cuyo origen conozcas. Usamos el Short de 27 s sobre la skill grill-me, que hicimos 100 % con código con la skill animate: dibujo en canvas, una captura real de terminal, voz sintética local y música compuesta en código.
python3 -m venv .venv && .venv/bin/pip install "./rea-video[ocr]"
.venv/bin/rea-video decompose grill.mp4 -o out/grill --lang enTardó 151 s en un contenedor de 4 núcleos sin GPU, incluida la primera descarga de unos 216 MB de modelos de separación de audio. Este fue su primer veredicto, solo con las herramientas y sin ninguna IA mirando la imagen:
Producción mixta: vídeo de IA 43 % + render 3D 31 % + código 26 %. Confianza: 0,485.
Falla, y lo avisa: la propia salida dice que sin un modelo de visión la confianza es limitada y propone el paso siguiente. Ese paso es lo interesante para quien usa Claude Code. Si tu agente puede ver imágenes, hace de modelo de visión sin coste extra:
rea-video review out/grill
# el agente mira las hojas de cada plano y rellena review_answers.json
rea-video apply-review out/grill --by claude-code --lang enTras la revisión (Claude miró el storyboard y las hojas de los 4 planos y rellenó las respuestas), el veredicto pasó a código o plantilla 100 %, con un 86 % de confianza, y detectó bien:
- la captura real de terminal (marcada como material que tendrías que aportar tú),
- 12 líneas de subtítulo con palabras clave resaltadas en amarillo y su archivo
subtitles.srt, - voz sintética (TTS) en off y 2 efectos de sonido,
- un ritmo de 6,7 cortes por minuto, sin planos grabados con cámara.
Falló en un detalle: clasificó la música como "probablemente de biblioteca" (145,6 BPM, Fa mayor) cuando la compuso el código de animate. El informe lo marca como "por confirmar", que es lo honesto.
Cómo instalarlo
La forma recomendada es dejar que el agente lo haga. En Claude Code o Codex:
Instala https://github.com/JuneYaooo/rea-video y analiza este vídeo: C:\videos\anuncio.mp4. El informe en inglés.A mano:
git clone https://github.com/JuneYaooo/rea-video && cd rea-video
bash scripts/install_skill.sh
rea-video --helpinstall_skill.sh busca un Python entre 3.10 y 3.14, instala la CLI (con pip, pipx o un .venv si tu sistema no deja instalar paquetes globales), resuelve un conflicto conocido entre opencv-python y opencv-python-headless y enlaza la skill en las carpetas de los agentes que tengas. En Windows, ejecútalo desde Git Bash o WSL, o instala a mano con pip install -e ".[ocr]".
Como plugin de Claude Code también funciona, pero la CLI sigue haciendo falta:
/plugin marketplace add JuneYaooo/rea-video
/plugin install rea-video@rea-videoComandos útiles además de decompose:
| Comando | Para qué |
|---|---|
| `rea-video probe video.mp4` | Solo metadatos: cámara, marcas de IA, C2PA, firma del editor |
| `rea-video stems video.mp4 -o out` | Separa voz, música y efectos en WAV |
| `rea-video summary out/breakdown.json` | Resumen corto y planos con baja confianza |
| `rea-video pdf out` | Exporta el informe a PDF con tu Chrome o Edge |
| `rea-video correct out --shots 3 --label ...` | Corrige un plano; lo recuerda para la próxima |
Cuánto cuesta
| Pieza | Precio | ¿Obligatoria? |
|---|---|---|
| rea-video | 0 USD (Apache-2.0) | Sí |
| Python, ffmpeg y modelos de audio (UVR MDX-Net, BandIt v2) | 0 USD, corren en tu CPU | Sí |
| Revisión visual con Claude Code o Codex | incluida en tu plan (Claude Pro desde 20 USD/mes) | Recomendada |
| Modelo de visión por API (Gemini, GPT-4o o cualquiera compatible con OpenAI) | lo que cobre el proveedor por imagen | No |
| Rehacer los planos de IA con capsule-cinema | lo que cobre cada modelo de vídeo; primero hace un ensayo gratis | No |
| ChatCut (editor de vídeo con IA alojado, patrocinador del repo) | según su plan | No |
La opción más barata: análisis offline + revisión visual con tu propio agente = 0 USD extra. Con vídeos originales (no descargados de redes) los autores miden un 98-99 % de acierto solo con las herramientas; con vídeos recomprimidos por las plataformas baja al 88,6 % y necesitas la revisión visual para volver a superar el 99 %. Nuestro caso, un vídeo dibujado a mano en canvas, es justo el que más confunde a las herramientas.
Lo que no te cuenta el README
- Los informes no salen en español. Pide el informe en inglés (
--lang en) o déjalo en chino y pídele al agente que te lo resuma. - El primer análisis descarga modelos. Unos 67 MB para voz y música y 149 MB para efectos, en
~/.cache/rea-video/models. Los pesos de BandIt v2 son CC BY-SA 4.0. - Alguna descarga puede fallar en redes restringidas. En nuestro contenedor el modelo de detección de caras devolvió un 403; rea-video siguió sin él y no afectó al resultado.
- El empaquetado y la voz necesitan extras. La transcripción local de lo que se dice (
rea-video[asr], SenseVoice) es opcional y no entiende español: solo chino, inglés, japonés, coreano y cantonés, más un modelo aparte para bengalí. - No es para copiar vídeos ajenos. El propio README lo dice: sirve para aprender la estructura y la técnica y rehacerlo con material sobre el que tengas derechos.
Preguntas frecuentes
¿Sirve para saber si un vídeo está hecho con IA? Sí, es lo que mejor hace: busca marcas de IA en los metadatos, cadencia de fotogramas típica de modelos (24 fps), ausencia de ruido de sensor y fallos visuales como manos deformes o letras sin sentido. En vídeos descargados de redes, añade la revisión visual.
¿Necesito una API de pago? No. El modo de herramientas es offline y gratis, y Claude Code puede hacer la revisión visual. La API de un modelo de visión es opcional.
¿Rehace el vídeo solo? En parte. Los planos de código los reconstruye como un proyecto (code-remake), los de IA los puede regenerar con capsule-cinema si lo instalas y pagas los modelos, y los planos grabados te los da como plan de rodaje para que los grabes tú.
¿En qué se diferencia de reverse-engineer-marketing? reverse-engineer-marketing analiza la web y los mensajes de un competidor. rea-video analiza sus vídeos. Juntos te dan la estrategia y la producción.
Conclusión
rea-video es la forma gratuita más completa que hemos probado de saber cómo está hecho un vídeo: si es real, IA o código, qué voz y música usa y cómo rehacerlo. Su punto débil es que, sin ojos, se equivoca con estilos poco comunes; con Claude Code haciendo la revisión visual, el resultado pasó del 48 % al 86 % de confianza y acertó la técnica de todos los planos. Úsalo para estudiar los anuncios que funcionan en tu sector y luego produce tu versión con animate o con las herramientas de la guía cómo crear vídeos con IA usando Claude Code o Codex.
// código fuente
Nos ayuda a crecer
codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.
- Compártelo con alguien a quien le sirvaWhatsAppLinkedInXFacebook
- Llévate el kit para agenciasVer qué incluyeComprar
- Conoce a nuestro patrocinadorSafe Build Labs
Más sobre Agentes de IA

guía · Guía completa de ECC para Claude Code · #8
- Seguridad y revisión de código
- Claude Code

guía · Guía completa de ECC para Claude Code · #7
- Claude Code
- Skills para tus agentes

guía · Guía completa de ECC para Claude Code · #6
- Claude Code
- Skills para tus agentes