Matriz Viralidad: descubre por qué un video rompe y escribe el siguiente

Imagina un equipo de fútbol que juega cada semana pero nunca ve la grabación de sus partidos. Juega, pierde, juega otra vez y espera que el próximo salga mejor. Así publican muchos creadores: suben un video, cruzan los dedos y pasan al siguiente.

Matriz Viralidad es el entrenador que sí ve las grabaciones. Es un agente: un Claude de Claude Code que ya trae escritas las instrucciones y sabe en qué orden hacer las cosas. Tú le dices de qué quieres hablar. Él mira los videos de tu cuenta, o los de los creadores que admiras, separa los que les fue mucho mejor que de costumbre y busca qué tenían en común.

Con eso te escribe cinco guiones nuevos, te dice qué tan bien podrían salir y te arma el calendario del mes. Tú grabas y publicas.

Lo que ganas

• Dejas de adivinar. Sabes qué tipo de video le funciona a una audiencia parecida a la tuya, con los videos reales a la vista.
• Te ahorras ver reels uno por uno y apuntar notas. Una sesión completa toma de 20 a 40 minutos, y casi todo es esperar.
• Gastas poco y lo sabes antes. Cada corrida te dice el costo estimado y tiene un tope en dólares. Un mes completo con tres cuentas ronda 1 dólar.
• No necesitas programar. Le escribes en español y él corre lo que haga falta.
• Las palabras son tuyas. El agente comprueba que tus guiones no repitan frases de nadie y solo te da la técnica.

• Matriz Viral, el método a mano

  Si prefieres entender el método armándolo tú, con prompts y el MCP de Apify, esa guía es para ti. Esta es la versión que ya viene armada.

• Claude Code. Funciona en la app de escritorio, que es lo que usa la mayoría, y también en la terminal. Esta guía empieza por la app.
• Node, versión 20 o más nueva. Es un programa chiquito que hace correr los scripts del agente. Si no lo tienes, Claude te lo revisa en el primer prompt.
• Una cuenta gratis de Apify (apify.com/sign-up). No pide tarjeta y regala unos 5 dólares de crédito al mes. Apify es el mensajero que va a las cuentas públicas y te trae lo que encontró.

Tres extras que no son obligatorios

• ffmpeg: abre los videos cuadro por cuadro para leer el subtítulo que sale en pantalla. Es gratis.
• La skill watch: baja y transcribe un video por su link.
• Una llave gratis de Gemini: le da oídos al agente, así oye el audio de los videos y no solo lee lo que ve.

Probado en Mac. En Linux debería funcionar igual. En Windows el autor no lo ha probado: usa Git Bash o WSL.

Instalar es traer una copia del agente a tu computadora. Se lo pides a Claude y él hace el trabajo.

En la app de Claude Code (el camino fácil)

Abre la app, entra a Code y abre una sesión en cualquier carpeta. Tu carpeta Documentos sirve. Pega este prompt:

Quiero instalar una herramienta que se llama Matriz Viralidad. Hazlo por mí, un paso a la vez, y explícame en frases cortas qué haces.

1. Revisa si tengo Node instalado y que sea la versión 20 o más nueva. Si no lo tengo, dime cómo instalarlo y espera a que te diga que ya.
2. Clona https://github.com/Hainrixz/matriz-viralidad dentro de mi carpeta Documentos. Si no tengo git, dímelo antes de intentar nada.
3. Dime la ruta completa de la carpeta nueva.

No instales nada más y no abras ningún archivo con contraseñas.

1. 1

   Abre la carpeta nueva

   Cuando Claude te diga la ruta, abre esa carpeta (matriz-viralidad) en una sesión nueva: Code, abrir carpeta.

2. 2

   Elige Sí, confío

   Claude Code te pregunta si confías en la carpeta. La opción que aparece resaltada empieza en No, así que cámbiala a Sí, confío. Sin eso no se activan el arranque automático ni los permisos que te protegen.

3. 3

   Deja que arranque solo

   El agente se presenta y revisa que tengas tus llaves, sin leerlas. Si no arrancó, escribe /matriz-start y empieza.

En la terminal

Si usas la terminal, es una sola línea. Trae el agente, entra a su carpeta y abre Claude Code ahí. También te pregunta si confías en la carpeta: contesta Sí.

Como plugin, sin traer la carpeta

Hay una tercera forma: instalarlo como plugin desde cualquier carpeta, escribiendo estas tres líneas dentro de Claude Code, una por una.

En modo plugin los comandos llevan el prefijo matriz-viralidad:. Además no arranca solo y no trae las reglas de permisos del proyecto: ni el bloqueo del .env ni la confirmación antes de gastar. Sí trae el hook que impide que Claude lea tus llaves. Si puedes, trae la carpeta completa: es la experiencia entera.

El token de Apify es como la llave de la casa del mensajero: con ella Apify sabe que eres tú. Se saca así:

1. 1

   Crea tu cuenta

   Entra a apify.com/sign-up. Es gratis y no pide tarjeta.

2. 2

   Copia el token

   Dentro de Apify ve a Settings, luego API & Integrations, y copia el Personal API token.

Prepara mi archivo de llaves: copia .env.example como .env en esta carpeta y ábrelo para que yo pegue mi token de Apify.

No leas el archivo y no me pidas el token en el chat. Yo lo pego a mano y lo guardo.

Cuando se abra el archivo, pega el token justo después de APIFY_TOKEN= , sin comillas ni espacios, y guárdalo. En Mac el Finder esconde los archivos que empiezan con punto, por eso es mejor que Claude lo abra por ti.

El .env está en .gitignore, así que no se sube a ningún lado. Cuando termines, escribe /matriz-start otra vez.

Al abrir la carpeta el agente te hace cinco preguntas, una por una y en español, sin jerga:

• A quién estudiamos: tu cuenta, 2 o 3 creadores de referencia, o las dos. Si apenas empiezas y no tienes videos, elige referencias.
• En qué redes: Instagram, TikTok, YouTube o X.
• Los @usuarios exactos, de cuentas públicas. Si no sabes a quién estudiar, piensa a quién sigues y admiras.
• De qué hablas o quieres hablar, en una frase.
• Tu tono y cuántas piezas quieres publicar por semana.

Con tus respuestas crea tu perfil y unas carpetas en tu computadora donde guarda todo. Nada se descarga ni se gasta hasta que tú digas que sí.

Así se ve una sesión recortada. Los números son un ejemplo para mostrar la idea, no son de ninguna cuenta real:

El agente sigue un ciclo y te va diciendo en qué paso vas. Cada comando se escribe en el chat con una diagonal. Abajo, cada uno dicho fácil.

El orden natural es este: start, luego analiticas o espiar, construir, ganador, guion, calendario y, cada semana, rutina.

• /matriz-start

  La puerta de entrada. Revisa que tengas todo y te hace las cinco preguntas para conocerte.

  También funciona si escribes: quiero mi matriz de viralidad, o si pegas un @usuario.

• /matriz-analiticas

  Pone tus videos junto a tu propia estatura normal y te dice cuáles crecieron de verdad.

• /matriz-espiar <usuario> <red>

  Manda al mensajero a ver una cuenta pública y te trae sus videos. Tú eliges cuáles mirar a fondo.

• /matriz-ver <link>

  Mira un solo video y te cuenta cómo está hecho: la primera frase, los primeros 3 segundos, la estructura, la emoción y qué pide al final.

  También funciona si escribes: mira este video, y pegas el link.

• /matriz-construir

  Junta todo en la tabla de 10 columnas y escribe el documento de patrones. Otro ayudante la revisa antes de dártela.

• /matriz-ganador

  Busca lo que funciona y todavía no usa todo el mundo.

• /matriz-sentimiento

  Lee los comentarios de los videos más grandes y te cuenta qué piensa, qué duda y qué pide la gente.

• /matriz-guion

  Te escribe 5 guiones nuevos con el patrón que funciona y los prueba contra los videos reales.

  También funciona si escribes: escríbeme guiones, o qué grabo.

• /matriz-calendario

  Arma el mes. Cada día apunta a un video de la matriz que lo respalda.

• /matriz-rutina

  El repaso de cada semana: trae lo nuevo, actualiza la matriz, revisa si acertó y cierra con un resumen de 5 líneas.

  También funciona si escribes: rutina semanal, o qué toca esta semana.

• /matriz-doctor

  El doctor. Si algo no funciona, revisa tu instalación y te dice qué arreglar.

  También funciona si escribes: no me funciona, o me da error.

Si instalaste como plugin, cada comando lleva el prefijo matriz-viralidad: antes del nombre.

Cada video se vuelve una fila de una tabla, como una hoja de calificaciones. La columna que más importa se llama RENDIMIENTO.

La mediana: la estatura normal de tu salón

Forma a todos los niños de tu salón en una fila y mira al que quedó en medio. Esa es la mediana. Si entra un niño gigante, el promedio se dispara y todos parecen chaparros, pero la mediana casi no se mueve.

Con los videos pasa igual. Un solo video que explota sube el promedio y hace que todo lo demás parezca un fracaso. Por eso el agente usa la mediana.

Y la mide dentro de cada cuenta. 500 mil views en una cuenta de 10 mil seguidores valen más que 600 mil en una de un millón. Así que divide los views de cada video entre la mediana de esa cuenta. Un 3.2x quiere decir el triple de lo normal ahí.

Arriba de 1.5x, el video funcionó. Debajo de 0.7x, no funcionó.

Las diez columnas

Junto a la tabla sale un segundo documento con cuatro partes: qué funciona, qué no funciona, el patrón de viralidad en un párrafo y lo que no sabemos. Esa última parte importa: la hora de publicación, la miniatura, la edición y el humor del algoritmo no están en los datos, y el documento lo dice.

Un video no se lee como un texto, así que el agente tiene tres caminos para verlo.

Qué camino usa lo decide una línea del archivo .env, MATRIZ_ANALIZADOR. Déjala en auto: prueba con Gemini y, si no se puede, cae a los fotogramas y te avisa lo que pierdes, que es el audio.

Un video sin subtítulo en pantalla deja el hook como s/d. El agente nunca usa el texto de la descripción como si fuera lo que se dice.

Revisa si tengo ffmpeg instalado en mi computadora.

Si no lo tengo, dime cuál es el comando para instalarlo en mi sistema y explícame en una frase qué hace. Espera mi sí antes de correrlo.

• Videos a skills

  Cómo instalar la skill watch y sacar una llave de Gemini, con la tabla de cuánto gasta cada opción.

Antes de cada corrida el agente te dice cuánto va a costar, y nada se gasta hasta que contestes que sí. Estos son los precios del plan gratis de Apify, consultados el 17 de octubre de 2026. Los planes de pago son más baratos y los precios cambian: revisa apify.com/pricing.

• Cada corrida suma 0.001 USD de arranque.
• Un mes completo con 3 cuentas de Instagram (el análisis inicial de 40 reels de cada una y 4 rutinas semanales de 15) ronda 1 dólar, con Gemini incluido si analizas una docena de videos. Tu crédito gratis de Apify es de unos 5 dólares al mes.
• Las transcripciones de Apify son un extra de pago, unos 0.048 USD por minuto, y este agente no las activa. El hook sale de ver el video con Gemini, watch o fotogramas.
• Los topes por defecto son 40 videos y 1 dólar para el análisis inicial, y 15 videos y 0.50 dólares para la rutina semanal. Si Apify rechaza el tope, el script se detiene en vez de correr sin freno.

• Nunca copies frases literales. La matriz te da la estructura y la técnica, las palabras son tuyas. Un script comprueba en cada guion que no repitas frases de nadie.
• Nunca dejes que Claude invente métricas. Lo que no hay se queda como s/d.
• Publica también lo que puntúe bajo. La simulación ordena prioridades, no censura. Es una estimación basada en videos pasados, no una predicción.

Lo que cuida por ti

• Solo contenido público. No entra a cuentas privadas, no usa tu sesión ni tus cookies y no baja mensajes directos.
• Todo lo que gasta pide tu sí en el mismo turno, con el costo a la vista.
• La carpeta fuentes/ es de solo lectura: guarda lo que salió del scraper tal cual, para que nadie lo retoque.
• Nada se publica ni se programa desde aquí. El agente prepara y tú publicas.

Lo que bajas se queda en tu computadora y es para estudiar patrones, no para copiar ni republicar el trabajo de nadie. El contenido sigue siendo de sus autores. Respeta los términos de cada red y las leyes de datos personales de tu país.

• No arrancó solo. Escribe /matriz-start. En algunas versiones de la app el arranque automático no se dispara.
• No sabes qué falla. Escribe /matriz-doctor: revisa Node, ffmpeg, la skill watch, tus llaves (sin mostrarlas), las carpetas y cuánto llevas gastado, y te dice qué arreglar.
• Un video no se descarga y marca error 403 o 404. Las direcciones de video de Instagram y TikTok caducan en minutos. Vuelve a correr /matriz-espiar y descarga enseguida.
• Quieres ver cómo funciona sin gastar ni pegar nada. El repo trae datos de ejemplo inventados y puedes pedirle a Claude que los use para enseñarte una matriz de prueba.