¿Qué hace viraloop?
Analiza cualquier sitio web y genera un carrusel de 6 diapositivas para TikTok/Instagram con coherencia visual. Publica directamente en tu feed (sin borradores) con música de tendencia automática. Ambas APIs (Gemini + upload-post.com) tienen planes gratuitos, sin necesidad de tarjeta de crédito para empezar.
Filosofía: Bucle de Iteración Diaria
La clave del crecimiento es la constancia + el aprendizaje:
- Publica 1 carrusel al día – La constancia supera la viralidad
- Registra todo – Cada publicación genera datos
- Aprende de los datos – ¿Qué ganchos funcionan? ¿A qué horas? ¿Qué imágenes?
- Itera y mejora – Cada carrusel es mejor que el anterior
Día 1: Publicar → Analizar → Aprender
Día 2: Publicar (mejorado) → Analizar → Aprender
Día 3: Publicar (mejor) → Analizar → Aprender
...
Día 30: Tienes 30 puntos de datos y una estrategia refinada
La habilidad mantiene un learnings.json que acumula información de todas las publicaciones:
- Ganchos con mejor rendimiento
- Horarios óptimos de publicación
- Estilos visuales que funcionan
- CTAs que convierten
Esto no es una herramienta de un solo uso. Es un motor de crecimiento.
Inicio Rápido
# 1. Investigación completa del negocio
node {baseDir}/scripts/analyze-web.js https://tu-sitio-web.com
# 2. Genera 3 variantes de gancho (SHOCK, CURIOSIDAD, CONTRADICCIÓN)
GEMINI_API_KEY="tu-clave" bash {baseDir}/scripts/generate-hooks.sh
# 3. Revisa los ganchos con visión, elige el mejor
# 4. Genera diapositivas usando el tipo de gancho seleccionado
GEMINI_API_KEY="tu-clave" bash {baseDir}/scripts/generate-slides.sh [shock|curiosidad|contradiccion]
# 5. Revisa las diapositivas (el agente verifica texto y calidad)
# El agente usa visión para revisar cada diapositiva
# 6. Publica en TikTok + Instagram
UPLOADPOST_TOKEN="tu-token" bash {baseDir}/scripts/publish-carousel.sh
# 7. Consulta las analíticas (después de 24-48 h)
UPLOADPOST_TOKEN="tu-token" bash {baseDir}/scripts/check-analytics.sh 7
# 8. Aprende de los datos para los próximos carruseles
node {baseDir}/scripts/learn-from-analytics.js
Categorías de Gancho (Sistema de Novedad Visual)
La clave para superar el techo de las 1000 visualizaciones es la novedad visual en la primera diapositiva. Generamos 3 tipos de gancho:
| Tipo | Objetivo | Estilo Visual |
|---|---|---|
| SHOCK | Detener el desplazamiento con algo imposible/absurdo | Surrealista, caótico, "¿espera qué?" |
| CURIOSIDAD | Crear una brecha de información | Misterioso, secretos revelados |
| CONTRADICCIÓN | Mostrar una combinación imposible | Relajado + intenso, "¿cómo es posible?" |
Filtro Anti-Stock
Todos los ganchos incluyen prompt anti-stock para evitar:
- Estética genérica de fotos de stock
- Tropo de chica bonita sorprendida
- Poses típicas de influencers
- Escenarios sobreutilizados de laptop-café
- Escenas de apretones de manos corporativos
Flujo de Prueba de Ganchos
- Genera 3 variantes con
generate-hooks.sh - Revisa con visión, puntúa cada una del 1 al 5 en novedad
- Descarta todo lo que parezca familiar
- Usa el mejor gancho para el carrusel
- Rastrea qué TIPO de gancho funciona mejor con el tiempo
Modelo de Imagen
Usa gemini-2.0-flash-exp-image-generation para generar las diapositivas.
- Script local:
{baseDir}/scripts/generate_image.py - Soporta imagen-a-imagen para coherencia visual entre diapositivas
Paso 1: Investigación Completa (analyze-web.js)
Realiza una INVESTIGACIÓN COMPLETA del negocio:
1. Análisis de Marca
- Nombre de la marca (del dominio o título)
- Logotipo (URL o SVG)
- Colores CSS (fondo, primario, enlaces, títulos)
- Tipografía (fuente del cuerpo, fuente de títulos)
- Favicon
2. Análisis de Contenido
- Titular y eslogan
- Todos los títulos (estructura de la página)
- Características/beneficios (título + descripción)
- Precios/planes
- Testimonios
- Estadísticas/métricas
- CTAs
- Metaetiquetas (título, descripción, og:image)
3. Páginas Internas
- Navega por precios, características, acerca de, testimonios
- Extrae contenido adicional de cada página
4. Detección de Competidores
- Busca menciones de competidores conocidos en el contenido
- Lista de más de 20 competidores SaaS conocidos (Buffer, Hootsuite, Later, etc.)
- Detecta secciones "vs", "alternativa", "comparar"
- No requiere búsquedas externas; todo proviene del propio sitio web
5. Narrativa
- Detecta el tipo de negocio (SaaS, ecommerce, app)
- Detecta el nicho (herramientas-redes-sociales, herramientas-desarrollador, etc.)
- Genera ganchos basados en los puntos de dolor del cliente
- Define puntos de dolor a partir de las características
- Crea narrativa de transformación (antes → después)
6. Contexto Visual
- Colores de marca en formato CSS
- Descripción del color para los prompts
- Tipografía para las diapositivas
- Temas de imagen según el nicho
- Guía de estilo para la coherencia
Salida: /tmp/carousel/analysis.json
Paso 2: Generar Diapositivas (generate-slides.sh)
Genera 6 diapositivas con coherencia visual usando imagen-a-imagen:
| Diapositiva | Tipo | Contenido |
|---|---|---|
| 1 | GANCHO | Pregunta/problema que engancha. Establece TODO el estilo visual. |
| 2 | Problema | Agrava el dolor. "Subes a TikTok... luego a Instagram..." |
| 3 | Agitación | La competencia avanza. Urgencia. |
| 4 | Solución | Presenta el producto con su propuesta de valor. |
| 5 | Característica | Beneficio principal. |
| 6 | CTA | "Enlace en la bio 👆" + llamada a la acción. |
Coherencia Visual
- La diapositiva 1 genera el estilo base (colores, tipografía, ambiente)
- Las diapositivas 2-6 usan imagen-a-imagen con la diapositiva 1 como referencia
- Mantiene la misma paleta de colores, fuentes y estética
Prompts por Diapositiva
Cada diapositiva tiene:
- Texto: El mensaje principal
- Escena: Descripción visual detallada para el fondo
- Estilo: Basado en el análisis de marca
Salida:
/tmp/carousel/slide-{1-6}.jpg/tmp/carousel/caption.txt
Paso 3: Revisión con Visión
Después de generar, el agente DEBE revisar cada diapositiva:
- ✓ El texto es legible y correcto
- ✓ Las palabras no están cortadas
- ✓ Ortografía correcta
- ✓ Coherencia visual entre diapositivas
- ✓ Calidad de imagen aceptable
Si hay errores, regenera la diapositiva específica.
Formato de Imagen
- Resolución: 768x1376 (proporción vertical 9:16)
- Formato: JPG (TikTok NO acepta PNG)
- Texto: Grande, negrita, con sombra para legibilidad
- Fondo: Escena relevante para el negocio, no solo colores sólidos
Paso 4: Publicar en TikTok + Instagram (publish-carousel.sh)
Publica el carrusel en TikTok e Instagram usando la API de Upload-Post.
UPLOADPOST_TOKEN="tu-token" bash {baseDir}/scripts/publish-carousel.sh
Endpoint: POST /api/upload_photos
Parámetros enviados:
platform[]=tiktok+platform[]=instagramauto_add_music=true- Añade música en TikTok automáticamentetiktok_title- Título corto (máx. 90 caracteres) + hashtagstitle- Texto completo para Instagramprivacy_level=PUBLIC_TO_EVERYONEmedia_type=IMAGE- Carrusel de fotos en Instagramasync_upload=true- Procesar en segundo planophotos[]- Las 6 diapositivas JPG
⚠️ IMPORTANTE Instagram: Después de publicar, el usuario debe ir a Instagram y añadir música viral manualmente:
- Abre Instagram → Perfil → La publicación
- Editar → Añadir música
- Buscar una canción de tendencia/viral
Salida: Guarda request_id en post-info.json para seguimiento.
Paso 5: Analizar Rendimiento (check-analytics.sh)
Obtiene analíticas de TikTok e Instagram para ver qué funciona.
UPLOADPOST_TOKEN="tu-token" bash {baseDir}/scripts/check-analytics.sh 7
Endpoints utilizados:
-
Analíticas de perfil:
GET /api/analytics/{usuario}?platforms=tiktok→ Seguidores, likes, comentarios, compartidos, impresiones
-
Impresiones totales:
GET /api/uploadposts/total-impressions/{usuario}?platform=tiktok&breakdown=true→ Vistas totales por día
-
Analíticas por publicación:
GET /api/uploadposts/post-analytics/{request_id}→ Vistas, likes, comentarios del carrusel específico (TikTok + Instagram)
Docs: https://docs.upload-post.com/api/get-analytics
Paso 6: Aprender y Mejorar (learn-from-analytics.js)
Analiza los datos y guarda los aprendizajes para futuros carruseles.
node {baseDir}/scripts/learn-from-analytics.js
Genera:
learnings.json- Base de conocimiento acumulada- Mejores ganchos (los que generan más vistas)
- Horarios óptimos de publicación
- Recomendaciones para el siguiente carrusel
Flujo Completo
# 1. Investigar el negocio
node {baseDir}/scripts/analyze-web.js https://mi-producto.com
# 2. Generar diapositivas
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh
# 3. Revisar con visión (el agente verifica el texto)
# El agente revisa cada imagen de diapositiva
# 4. Publicar
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="miusuario" bash {baseDir}/scripts/publish-carousel.sh
# 5. (Después de unas horas/días) Analizar
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="miusuario" bash {baseDir}/scripts/check-analytics.sh 7
# 6. Aprender para los próximos carruseles
node {baseDir}/scripts/learn-from-analytics.js
Archivos
{baseDir}/
├── SKILL.md # Esta documentación
└── scripts/
├── analyze-web.js # Investigación completa del negocio
├── generate-slides.sh # Generar 6 diapositivas con coherencia
├── generate_image.py # Imagen Gemini
├── review-slides.js # Preparar diapositivas para revisión
├── publish-carousel.sh # Publicar mediante API Upload-Post
├── check-analytics.sh # Obtener analíticas (TikTok + Instagram)
├── learn-from-analytics.js # Aprender de los datos
└── search-competitors.js # Búsqueda externa opcional
Variables de Entorno
| Variable | Descripción |
|---|---|
GEMINI_API_KEY | Clave de API de Google para generación de imágenes |
UPLOADPOST_TOKEN | Token de Upload-Post para publicación y analíticas |
UPLOADPOST_USER | Nombre de usuario de Upload-Post (obligatorio) |
Ejemplos de Gancho por Nicho
| Nicho | Ejemplo de Gancho |
|---|---|
| Herramientas de Redes Sociales | "¿Todavía publicas en redes sociales UNA POR UNA? 😩" |
| SaaS General | "¿Todavía haces esto MANUALMENTE?" |
| Ecommerce | "El producto que TikTok no para de recomendar" |
| App | "La app que me gustaría haber descubierto antes" |
| Herramientas para Desarrolladores | "La API que va a cambiar tu código" |
¿Por qué Viraloop?
| Viraloop | Otras habilidades | |
|---|---|---|
| Publicación | Directo al feed | Solo borradores |
| Música | Música de tendencia automática | Manual |
| Plataformas | TikTok + Instagram | Una sola plataforma |
| Investigación | Análisis automático de URL | Descripción manual |
| Coherencia de imagen | Referencia imagen-a-imagen | Diapositivas independientes |
| Generación de imagen | Gemini (nivel gratuito) | Proveedores de pago |
| Publicación | upload-post.com (gratis, sin TC) | De pago o autoalojado |
| Superposición de texto | Nativo de IA (Gemini renderiza) | Scripts externos |
| Prompts | Plantillas estructuradas | Forma libre |
| Configuración | 3 variables de entorno | Configuración compleja con múltiples herramientas |
Notas
- El análisis extrae competidores del contenido del sitio web en sí (más de 20 SaaS conocidos)
- Imagen-a-imagen mantiene la coherencia pero toma ~20 s por diapositiva
- El texto generado incluye hashtags relevantes al nicho
- Siempre revisa el texto de las diapositivas (a veces se corta)
auto_add_musicen TikTok mejora el engagement- Consulta las analíticas después de 24-48 h para obtener datos significativos
- Los aprendizajes se acumulan y mejoran con cada carrusel publicado
- El título de TikTok tiene un máximo de 90 caracteres (se trunca automáticamente con hashtags)