Kit gratis · reel sin mostrar el rostro · agentes que solo proponen

Reels de curiosidades que hace la IA. Y el modelo que genera las visualizaciones valer.

Tú das la pregunta ("¿por qué el refrigerador calienta la cocina?"). La IA investiga con fuentes, escribe 4 ganchos, muestra el storyboard y solo después graba la voz y arma el video. Dos agentes se ocupan de la cuenta y los anuncios, sin gastar nada sin tu OK. No necesitas una tarjeta gráfica: sin ella, el reel sale con subtítulos y música.

Banner: Curiosidad viral — reels sin rostro hechos con IA
En resumen

curiosidade-viral es un kit (una "skill" para Claude Code o Codex) que crea reels verticales de curiosidades sin que nadie aparezca: una voz explica y la pantalla muestra de cerca un objeto cotidiano. Sirve para quien quiere crear una cuenta de contenido corto sin grabar ni editar. El kit verifica el gancho antes de gastar, pide tu aprobación para un storyboard, graba la voz en tu computadora y monta el video con código. También incluye dos agentes que leen mensajes y cifras de anuncios y solo proponen. Necesitas Node.js, ffmpeg, Python y Claude Code o Codex.

Qué es

Hacerse viral se volvió la parte fácil. El kit se encarga de las dos partes.

En un experimento real de una semana, una cuenta que empezó desde cero tuvo un reel con más de 4 millones de visualizaciones y llegó a cerca de 19 mil seguidores. Lo que marcó la diferencia después fue el modelo: qué ofrecer, cómo medir y quién decide.

Las piezas del kit: gancho con 5 pruebas, storyboard, voz local, agente de la cuenta, agente de los anuncios, enlace por reel

🎣 Gancho que supera 5 pruebas

Lo extraño va primero, es algo de la persona, plantea una pregunta, se entiende a la primera y funciona sin sonido. Escribes 4 y los comparas de dos en dos.

🗂️ Storyboard antes de gastar

Una ficha por escena con boceto, frases, duración y lo que se ve. La voz, las imágenes y el render solo empiezan después de que des tu "adelante".

🤝 Dos agentes que solo proponen

Curio separa los mensajes y prepara las respuestas. Clic lee los anuncios y propone recortar o aumentar, con las 4 reglas escritas en código.

Cómo funciona

De la pregunta al reel, con una sola parada

La única parada es el storyboard. Antes de eso nada cuesta; después, el resto es script.

Pregunta→ Datos con fuente→ 4 ganchos→ Verificador→ Storyboard ✋→ Voz local→ Imágenes + escenas→ Render→ Publicar manualmente

El objeto siempre en pantalla

El objeto del gancho aparece grande en casi todas las escenas. Primero, tal como lo conoce la persona; después, por dentro.

Lo invisible, dibujado

Calor, fuerza, corriente: dibujados sobre la realidad, en un solo color. Lo incorrecto en rojo. El número con la fuente en gris.

El cierre se ve

La cámara se aleja hasta que el reel se convierte en un celular y un dedo toca "Enviar". El subtítulo queda arriba, lejos de los botones de la red.

Requisitos previos

Lo que necesitas tener instalado

Nada de aquí llama a API pagadas. La voz se genera en tu computadora.

Node.js 22+ y ffmpeg

El render usa HyperFrames (se descarga solo la 1.ª vez).

node --version
ffmpeg -version

Python 3 con numpy

Para el verificador, el storyboard, los agentes y la música en código. En las versiones nuevas de Ubuntu/Debian, pip del sistema está bloqueado: usa el paquete del sistema.

sudo apt install python3-numpy
# en Mac: python3 -m pip install numpy

Claude Code o Codex

Escribe datos, ganchos, guion y escenas. Es quien "usa" la skill: las instrucciones que el kit le da a la IA.

claude   # o: codex

Voz local (opcional, requiere GPU)

O voz.py usa Chatterbox (clona tu voz a partir de 10–20 s de audio) y Whisper (marca el tiempo de cada palabra), ejecutándose en una tarjeta gráfica NVIDIA. Indica dónde están con las variables de abajo. El worker de voz viene de inemavox (gratis): clónalo y sigue su README. ¿No tienes GPU? Omite la voz: el reel sale con subtítulos y música (montar.py --sem-voz).

export CHATTERBOX_PYTHON=~/miniconda3/envs/chatterbox/bin/python3
export INEMAVOX_DIR=~/inemavox   # carpeta con venv y Whisper: git clone https://github.com/inematds/inemavox
export VC_VOZ=~/mi-voz.wav   # obligatorio: TU voz (si no, busca la voz por defecto del autor)
Guía de uso · paso a paso

Tu primer reel

Ejecuta esto en la carpeta del kit. Los pasos 3, 4, 8 y 9 se los pides a Claude Code o Codex; el resto son comandos.

1

Instala

Activa la skill en Claude Code y Codex, ejecuta las pruebas y crea el tuyo preferencias.md (público y cierre).

git clone https://github.com/inematds/curiosidade-viral.git
cd curiosidade-viral
bash instalar.sh
2

Crea la carpeta del reel

Un nombre corto y la pregunta. Sale exemplos/<nome>/ con roteiro.json, fatos.md y pie.txt para completar.

python3 ferramentas/novo.py chuveiro "¿por qué la ducha se enfría cuando alguien abre la llave?" --duracao 30 --idioma es
3

Primero, los datos

Pídele a la IA: "completa el fatos.md con fuentes". Para cada cifra, incluye el valor, la frase exacta, el enlace y la fecha. Si no hay fuente, se queda fuera.

# en Claude Code, dentro de la carpeta del kit:
haz el fatos.md de exemplos/chuveiro siguiendo el SKILL.md
4

4 ganchos y el guion

La IA escribe 4 ganchos, cada uno de una forma (contrario, objeto, número, personal, pregunta), el guion en un bucle de curiosidad y las escenas. Las reglas están en metodo/gancho.md y metodo/roteiro.md.

escribe los 4 ganchos y el guion de exemplos/chuveiro
5

Ejecuta el verificador

Marca comienzos con fecha o "según un estudio", tono de noticia, "yo/mi canal", ganchos con la misma forma, números sin fuente, duración excedida, cierre faltante, hashtag en la publicación.

python3 ferramentas/gancho_check.py exemplos/chuveiro   # OK = 0 errores

Justo después del paso 2, señala varios errores (está todo vacío): es lo esperado. Vuelve a ejecutarlo después del paso 4.

6

Aprueba el storyboard

La única parada. Una ficha por escena con boceto, frases (palabra clave destacada), duración, entrada y sonido; arriba, el gancho y los 3 de reserva. Aprueba, cambia una escena o reemplaza el gancho.

python3 ferramentas/storyboard.py exemplos/chuveiro --abrir
7

Voz local, sincronizada con cada palabra

Graba cada frase y marca el segundo de cada palabra, para que la pantalla cambie en la palabra correcta.

python3 ferramentas/voz.py --projeto exemplos/chuveiro exemplos/chuveiro/roteiro.json --simular   # solo muestra lo que va a grabar
python3 ferramentas/voz.py --projeto exemplos/chuveiro exemplos/chuveiro/roteiro.json
8

Imágenes y escenas

de 3 a 5 fotos de LO MISMO: tómala con el celular (de frente, abierta, por detrás, de cerca), con luz neutra y sin texto, y ponlas en exemplos/chuveiro/media/. Quien tenga Codex puede pedirle que genere las fotos. La IA arma la página del reel copiando el ejemplo del refrigerador.

arma las escenas de exemplos/chuveiro a partir de exemplos/geladeira
9

Reloj, música y render

Elige uno de los dos caminos. Antes del render (unos 5 minutos), extrae fotogramas fijos y mira cada escena.

# A) CON voz grabada en el paso 7 (GPU)
python3 ferramentas/montar.py --projeto exemplos/chuveiro
python3 ferramentas/mezcla.py --projeto exemplos/chuveiro --id chuveiro --musica tranquila
python3 ferramentas/preparar.py --projeto exemplos/chuveiro
# B) SIN voz (sin GPU): subtítulos + música, la duración se calcula a partir del texto
python3 ferramentas/montar.py --projeto exemplos/chuveiro --sem-voz
python3 ferramentas/mezcla.py --projeto exemplos/chuveiro --id chuveiro --musica tranquila
python3 ferramentas/preparar.py --projeto exemplos/chuveiro
# después, en ambos casos
cd exemplos/chuveiro
npx hyperframes check
npx hyperframes snapshot --at 0,5,12,20 -o stills   # mira las imágenes en stills/
npx hyperframes render --output renders/chuveiro.mp4
cd ../..   # vuelve a la carpeta del kit
10

Enlace etiquetado y publicación manual

Un enlace por reel, para saber qué atrajo a cada persona. Publícalo desde el celular: en el caso real, la publicación automática redujo el alcance.

python3 agentes/link.py https://tu-sitio.com --conta micuenta --onde reel --reel chuveiro
Los dos agentes

Ellos proponen. Tú decides.

Las reglas están en el código, no solo en el prompt: el agente no puede olvidarse de ninguna. Fichas para pegar en tu agente: agentes/curio.md y agentes/clic.md.

💬 Curio — la cuenta

Separa los DM y los comentarios: "¿cómo se hace?" recibe una respuesta preparada con el enlace; las quejas, los reembolsos y las marcas van para ti; los elogios, solo un «me gusta». Solo avisa cuando haya novedades. El script no envía nada: tú copias y envías, o conectas la ficha agentes/curio.md a uno de tus agentes.

python3 agentes/curio_triagem.py agentes/exemplos/mensagens.json \
  --link "https://tu-sitio.com/?utm_medium=dm" --estado curio.json

📈 Clic — los anuncios

1. sin OK no se gasta · 2. límite por día · 3. solo aumenta con un retorno de 1,5 veces o más · 4. corta rápido lo que no vende. Y dos alertas: medición rota y presupuesto disperso.

python3 agentes/clic_regras.py agentes/exemplos/metricas.json

De dónde vienen los datos

Los agentes no entran en tu cuenta: tú (o la herramienta que ya usas) exportas los datos a dos archivos sencillos. El kit incluye dos ejemplos en agentes/exemplos/.

mensagens.json (Curio)

Los nuevos mensajes directos y comentarios, copiados a mano o exportados de la red.

[{"id": "d1", "de": "@marina", "onde": "dm",
  "texto": "¿Cómo haces estos videos?"}]

metricas.json (Clic)

Del administrador de anuncios (gasto, presupuesto) y de tu tienda (ventas, ingresos), en la misma moneda.

{"config": {"teto_dia": 150, "retorno_min": 1.5},
 "medicao_ok": true, "compradores_excluidos": true,
 "anuncios": [{"id": "geladeira-h1", "orcamento_dia": 40,
   "gasto": 82, "vendas": 4, "receita": 178}]}
# salida de Clic con el ejemplo del kit (las herramientas responden en portugués)
Clic · proposta de anúncios (nada muda sem o seu OK)
⚠ Quem já comprou ainda vê o anúncio: exclua os compradores do público.
  SUBIR    geladeira-h1: 40 → 50/dia · retorno 2.17 ≥ 1.5 com 4 venda(s)
  CORTAR   geladeira-h2: 30 → 0/dia · gastou 35 sem nenhuma venda (limite 30)
  ↻ geladeira-h2: subir um anúncio novo com outro gancho da reserva no lugar
  REDUZIR  cebola-h1: 30 → 15/dia · vende, mas devolve menos do que custa (retorno 0.72)
Total proposto: 85/dia (teto 150).
Ejemplo

El reel del refrigerador

El ejemplo completo está en exemplos/geladeira/: datos con fuente, 4 ganchos y la elección, guion, storyboard, voz, imágenes y la página del reel. Para hacer el tuyo, copia esta carpeta y cambia el contenido.

Storyboard del reel del refrigerador
El storyboard: una ficha por escena, aprobada antes de gastar.
El reel terminado (40 s): el refrigerador aparece en pantalla todo el tiempo, el calor se dibuja encima y el cierre aparece en el celular.
El caso real

Las 6 lecciones de una semana

Cifras de un experimento de una semana; no son una promesa de resultados.

1. Ofrece lo que ya enseñas

La pregunta que más llegaba era "¿cómo haces esto?". Lo que ofreció fue justamente eso.

2. Mide desde el primer minuto

Un día, sin medir, 19 personas abrieron la página de pago y nadie compró. Sin medición, nada se publica.

3. Concentra el presupuesto

Unos pocos anuncios con presupuesto devolvieron cerca de 2 veces lo gastado; muchos con poco presupuesto, cerca de la mitad.

4. Etiqueta cada enlace

Si no sabes de dónde vino una venta, no puedes repetirla.

5. Automatiza la atención, no las decisiones

Los agentes responden y supervisan. Tú decides sobre el dinero.

6. El contenido orgánico también vende

La bio vendió 7 veces sin ningún anuncio.

Términos

Palabras que aparecen en la guía

Skill

Una carpeta de instrucciones que Claude Code o Codex sigue para realizar una tarea. Aquí, hacer el reel.

Gancho

La primera frase y la primera imagen del reel: lo que hace que alguien deje de desplazarse.

Storyboard

El reel diseñado en fichas, escena por escena, antes de existir.

slug

El nombre corto de la carpeta del reel, sin espacios ni tildes (ej.: chuveiro).

pie.txt

El texto que va en la descripción de la publicación.

Lazo de curiosidad

Cada frase responde a la anterior y abre una pregunta nueva, hasta la respuesta final.

HyperFrames

La herramienta que transforma una página web animada en un video MP4.

Retorno de 1,5 veces

Por cada 10 que gastaste en el anuncio, volvieron 15 en ventas.

Enlace etiquetado (UTM)

El mismo enlace con un final (?utm_…, el patrón para marcar enlaces) que indica de dónde vino la persona: qué reel, la bio o un DM.

DM

Mensaje directo y privado en la red social.

Gancho de reserva

Los 3 ganchos que no se eligieron: sirven para una versión B del mismo reel o para un anuncio nuevo.

Límite diario

El máximo que pueden gastar al día todos los anuncios en total, en la moneda que uses en metricas.json.

Chatterbox y Whisper

Programas gratuitos que funcionan en tu computadora: Chatterbox habla con tu voz; Whisper escucha y marca el tiempo de cada palabra.