Communitygithub.com

Upload-Post/viraloop

Habilidad para agentes de IA OpenClaw que automatiza el crecimiento de carruseles en TikTok e Instagram. Analiza cualquier URL de sitio web para extraer la marca, competidores y propuesta de valor, luego genera diapositivas virales con publicación automática y música de tendencia a través de la API de upload-post. Bucle de retroalimentación analítica integrado.

¿Qué es viraloop?

Viraloop es una habilidad para agentes de IA (como Claude Code, Cursor o Codex) que transforma cualquier sitio web en un carrusel viral de 6 diapositivas listo para publicar en TikTok e Instagram, sin necesidad de tarjeta de crédito para comenzar. La habilidad realiza primero un análisis completo del sitio web, extrayendo la marca, colores, tipografía, contenido, precios, testimonios e incluso detecta competidores mencionados (más de 20 competidores SaaS conocidos). Luego genera automáticamente tres variantes de gancho visual (SHOCK, CURIOSIDAD o CONTRADICCIÓN) usando Gemini 3.1 Flash, con estilos que evitan el aspecto genérico de stock. Las diapositivas se publican directamente en el feed (sin borradores) mediante la API de upload-post.com, que añade música de tendencia en TikTok. El sistema incluye un bucle de mejora continua: tras 24-48 horas, el agente analiza las métricas (vistas, likes, comentarios) y almacena los aprendizajes en un archivo learnings.json, permitiendo refinar la estrategia día tras día. Esta habilidad está diseñada para ejecutarse como un proceso diario: publicar, analizar, aprender y mejorar.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add Upload-Post/viraloop

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. Publica 1 carrusel al día – La constancia supera la viralidad
  2. Registra todo – Cada publicación genera datos
  3. Aprende de los datos – ¿Qué ganchos funcionan? ¿A qué horas? ¿Qué imágenes?
  4. 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:

TipoObjetivoEstilo Visual
SHOCKDetener el desplazamiento con algo imposible/absurdoSurrealista, caótico, "¿espera qué?"
CURIOSIDADCrear una brecha de informaciónMisterioso, secretos revelados
CONTRADICCIÓNMostrar una combinación imposibleRelajado + 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

  1. Genera 3 variantes con generate-hooks.sh
  2. Revisa con visión, puntúa cada una del 1 al 5 en novedad
  3. Descarta todo lo que parezca familiar
  4. Usa el mejor gancho para el carrusel
  5. 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:

DiapositivaTipoContenido
1GANCHOPregunta/problema que engancha. Establece TODO el estilo visual.
2ProblemaAgrava el dolor. "Subes a TikTok... luego a Instagram..."
3AgitaciónLa competencia avanza. Urgencia.
4SoluciónPresenta el producto con su propuesta de valor.
5CaracterísticaBeneficio principal.
6CTA"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[]=instagram
  • auto_add_music=true - Añade música en TikTok automáticamente
  • tiktok_title - Título corto (máx. 90 caracteres) + hashtags
  • title - Texto completo para Instagram
  • privacy_level=PUBLIC_TO_EVERYONE
  • media_type=IMAGE - Carrusel de fotos en Instagram
  • async_upload=true - Procesar en segundo plano
  • photos[] - Las 6 diapositivas JPG

⚠️ IMPORTANTE Instagram: Después de publicar, el usuario debe ir a Instagram y añadir música viral manualmente:

  1. Abre Instagram → Perfil → La publicación
  2. Editar → Añadir música
  3. 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:

  1. Analíticas de perfil:

    GET /api/analytics/{usuario}?platforms=tiktok
    

    → Seguidores, likes, comentarios, compartidos, impresiones

  2. Impresiones totales:

    GET /api/uploadposts/total-impressions/{usuario}?platform=tiktok&breakdown=true
    

    → Vistas totales por día

  3. 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

VariableDescripción
GEMINI_API_KEYClave de API de Google para generación de imágenes
UPLOADPOST_TOKENToken de Upload-Post para publicación y analíticas
UPLOADPOST_USERNombre de usuario de Upload-Post (obligatorio)

Ejemplos de Gancho por Nicho

NichoEjemplo 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?

ViraloopOtras habilidades
PublicaciónDirecto al feedSolo borradores
MúsicaMúsica de tendencia automáticaManual
PlataformasTikTok + InstagramUna sola plataforma
InvestigaciónAnálisis automático de URLDescripción manual
Coherencia de imagenReferencia imagen-a-imagenDiapositivas independientes
Generación de imagenGemini (nivel gratuito)Proveedores de pago
Publicaciónupload-post.com (gratis, sin TC)De pago o autoalojado
Superposición de textoNativo de IA (Gemini renderiza)Scripts externos
PromptsPlantillas estructuradasForma libre
Configuración3 variables de entornoConfiguració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_music en 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)

Skills relacionados