~/codigoagente
Agentes de IA

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.

El informe HTML que genera rea-video para nuestro Short de 27 s, tras la revisión visual del agente · codigoagente

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/skills o ~/.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ídeoQué te dice
Grabación realPuestas de cámara, encuadre, movimientos, iluminación (12 esquemas con lista de equipo), etalonaje
Vídeo con IAPruebas, un prompt reconstruido por plano y qué modelo usar
AvatarQué planos son un retrato movido por audio y qué material necesitas
3D o animaciónSi conviene generarlo con un modelo de vídeo o renderizarlo con código 3D
Código o plantillaTexto, maquetación y tiempos del movimiento, listo para rehacer en Remotion
Grabación de pantallaQué 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.

terminalsh
python3 -m venv .venv && .venv/bin/pip install "./rea-video[ocr]"
.venv/bin/rea-video decompose grill.mp4 -o out/grill --lang en

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

Arriba, solo con herramientas: confunde el dibujo en canvas con 3D y con vídeo de IA. Abajo, tras la revisión visual de Claude: los cuatro planos, código · codigoagente
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:

terminalsh
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 en

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

snippettext
Instala https://github.com/JuneYaooo/rea-video y analiza este vídeo: C:\videos\anuncio.mp4. El informe en inglés.

A mano:

terminalsh
git clone https://github.com/JuneYaooo/rea-video && cd rea-video
bash scripts/install_skill.sh
rea-video --help

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

snippettext
/plugin marketplace add JuneYaooo/rea-video
/plugin install rea-video@rea-video

Comandos útiles además de decompose:

ComandoPara 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

PiezaPrecio¿Obligatoria?
rea-video0 USD (Apache-2.0)Sí
Python, ffmpeg y modelos de audio (UVR MDX-Net, BandIt v2)0 USD, corren en tu CPUSí
Revisión visual con Claude Code o Codexincluida 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 imagenNo
Rehacer los planos de IA con capsule-cinemalo que cobre cada modelo de vídeo; primero hace un ensayo gratisNo
ChatCut (editor de vídeo con IA alojado, patrocinador del repo)según su planNo

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

Repositorio del artículo
El código del que habla este artículo es público: revísalo, dale una estrella o clónalo desde aquí.

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.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

Agentes de IA

guía · Guía completa de ECC para Claude Code · #8

AgentShield, el escáner de ECC, revisa CLAUDE.md, settings.json, MCP, hooks y agentes. Lo probamos con una configuración vulnerable y con el propio ECC.
  • Seguridad y revisión de código
  • Claude Code
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #7

Medimos cuánto contexto ocupa ECC con /ecc:context-budget --audit (unos 12.500 tokens en el perfil minimal) y cómo recortarlo: modelo, compactación y MCP.
  • Claude Code
  • Skills para tus agentes
leer artículo
Agentes de IA

guía · Guía completa de ECC para Claude Code · #6

Qué hacen los 28 hooks de ECC, cómo GateGuard frena la primera edición, cómo guardar y retomar sesiones y cómo funcionan los instincts del aprendizaje continuo.
  • Claude Code
  • Skills para tus agentes
leer artículo