matriz-analiticas

---

Cómo se ve

Una sesión real de punta a punta toma entre 20 y 40 minutos (casi todo es espera de Apify y análisis de video). Así empieza, recortada (los números son un ejemplo ilustrativo):

Agente   Hola, soy tu analista de contenido. Reviso tus llaves (sin leerlas)...
         ✓ APIFY_TOKEN presente · ✓ ffmpeg · ✓ skill watch · ✗ GEMINI_API_KEY (opcional)

Agente   ¿A quién estudiamos: tu cuenta, o 2–3 creadores de referencia?
Tú       Apenas empiezo. Sigo a @creadora_a y @creador_b, hacen finanzas para freelancers.

Agente   Costo estimado: 40 reels de cada una, 2 cuentas → ≈ $0.21. Tope duro: $1.00.
         ¿Corro?  →  Sí
Agente   Listo. Mediana de @creadora_a: 7,300 views (13 piezas). 3 piezas pasan 1.5x.
         ¿Cuáles analizo? Las 3 más virales cuestan ≈ $0.01 con audio, o $0 leyendo el subtítulo.

Agente   Matriz construida: 14 piezas, 3 patrones con evidencia suficiente (≥5 piezas).
         El que más se repite en lo que supera 1.5x: dato que sorprende + lista corta, 25–35 s.
         Lo que NO sé: hora de publicación, miniatura, edición y el humor del algoritmo.

Nada se descarga ni se gasta antes de que digas "sí".

Inicio rápido

Lo que necesitas antes: Claude Code (la app de escritorio, o la terminal), Node 20 o más nuevo y una cuenta gratis de Apify (sin tarjeta; trae unos 5 USD de crédito al mes). Opcionales: ffmpeg (leer videos por fotogramas), la skill watch (ver links de video) y una llave de Gemini (oír el audio). Probado en macOS; en Linux debería funcionar igual; en Windows usa Git Bash o WSL (no lo he probado).

1. Clónalo y ábrelo en Claude Code (app de escritorio: Code → abrir carpeta; terminal: claude dentro de la carpeta):

git clone https://github.com/Hainrixz/matriz-viralidad && cd matriz-viralidad && claude

2. Confía en la carpeta. Claude Code te pregunta si confías en ella (la opción resaltada empieza en "No": elige "Sí, confío"). Eso activa el arranque automático y los permisos del proyecto: bloquean leer tu .env, piden tu OK antes de cualquier corrida que cueste dinero y no dejan editar fuentes/.

3. Pega tu token de Apify, tú mismo. El agente nunca lee tus llaves: las pegas tú.

cp .env.example .env      # en Mac: open -e .env  (el Finder oculta los archivos con punto)
                          # pega tu token: APIFY_TOKEN=tu_token

El token sale de Apify → Settings → API & Integrations → Personal API token. .env está en .gitignore: no se sube.

4. El agente arranca solo y te hace cinco preguntas. Si no arrancó, escribe /matriz-start.

[!TIP] ¿Quieres ver cómo funciona antes de gastar o pegar nada? Con datos de ejemplo inventados (no son de ninguna cuenta real): node scripts/mediana.mjs examples/demo/fuentes/instagram-reels-cuenta_demo-posts-demo.json

Como plugin, sin clonar. Desde cualquier carpeta, dentro de Claude Code:

/plugin marketplace add Hainrixz/matriz-viralidad
/plugin install matriz-viralidad@matriz-viralidad
/matriz-viralidad:matriz-start

En modo plugin los comandos llevan el prefijo matriz-viralidad:. Tus datos y tu .env viven en la carpeta donde abriste Claude Code, nunca dentro del plugin.

[!NOTE] El modo plugin no arranca solo y no trae las reglas de permisos del proyecto (bloqueo del .env, confirmación de gasto en apify.mjs). Lo que sí viaja con el plugin es un hook que bloquea que Claude lea tus llaves, y las reglas del agente siguen aplicando; pero Claude Code te pedirá permiso en más pasos. Si puedes, clona el repo: es la experiencia completa.

El ciclo

El agente no te da un menú de cinco opciones: sigue un ciclo escrito y te dice en qué paso vas y por qué.

flowchart TD
    A["Abres el repo en Claude Code"] --> B["/matriz-start: revisa tus llaves y te entrevista (5 preguntas)"]
    B --> C{"¿Qué estudiamos?"}
    C -- "Mi cuenta" --> D["/matriz-analiticas: tu mediana y tus videos que sí rindieron"]
    C -- "Referencias" --> E["/matriz-espiar: la competencia con Apify, con costo y tope"]
    D --> F["Ve los videos: Gemini (audio) · watch · fotogramas"]
    E --> F
    F --> G["/matriz-construir: 10 columnas + patrones + un validador que la audita"]
    G --> H["/matriz-ganador: qué funciona y todavía no está saturado"]
    H --> I["/matriz-guion: 5 guiones nuevos + simulación"]
    I --> J["/matriz-calendario: el mes, cada día anclado a una pieza"]
    J --> K["/matriz-rutina cada semana: re-recolecta, actualiza, mide tus aciertos"]
    K --> E

La matriz

Cada video se vuelve una fila de una tabla con diez columnas. La que importa es RENDIMIENTO:

RENDIMIENTO = views de la pieza ÷ MEDIANA de views de ESA cuenta

Por qué la mediana y no el promedio: un solo video que explota sube el promedio y hace que todo lo demás parezca un fracaso. Y por qué por cuenta: 500k views en una cuenta de 10k seguidores