Communitygithub.com

Viraloop – Publication de carrousels auto-gérée

Compétence pour agent IA OpenClaw dédiée à la croissance automatisée de carrousels TikTok et Instagram. Analyse n’importe quelle URL de site web pour extraire la marque, les concurrents et la proposition de valeur, puis génère des diapositives virales avec publication automatique et musique tendance via l’API upload-post. Boucle de rétroaction analytique intégrée.

Qu'est-ce que Viraloop – Publication de carrousels auto-gérée ?

Viraloop est une compétence d’agent IA conçue pour automatiser la création et la publication de carrousels sur TikTok et Instagram à partir d’un simple site web. Elle analyse en profondeur une URL pour extraire l’identité de marque, les concurrents, les arguments de vente et les éléments visuels (couleurs, typographie, favicon). Ensuite, elle génère 6 diapositives visuellement cohérentes en utilisant Gemini 3.1 Flash, en s’appuyant sur le principe de « nouveauté visuelle » pour capter l’attention (hooks de type CHOC, CURIOSITÉ, CONTRADICTION). Les diapositives sont publiées directement sur le fil (pas de brouillons) avec ajout automatique de musique tendance via l’API upload-post.com. La compétence inclut également une boucle d’apprentissage continu : chaque publication génère des données analytiques qui sont stockées dans `learnings.json`, permettant d’affiner les hooks, les horaires de publication et les styles visuels au fil du temps. L’objectif est de construire un moteur de croissance par itération quotidienne, où chaque carrousel est meilleur que le précédent. Les API utilisées (Gemini et upload-post.com) disposent de plans gratuits sans carte bancaire.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Viraloop

Analysez n'importe quel site web et générez un carrousel de 6 diapositives pour TikTok/Instagram avec une cohérence visuelle. Publiez directement sur votre fil (pas de brouillons) avec musique tendance automatique. Les deux API (Gemini + upload-post.com) ont des offres gratuites – aucune carte bancaire nécessaire pour commencer.

Philosophie : Boucle d'itération quotidienne

La clé de la croissance est la cohérence + l'apprentissage :

  1. Publier 1 carrousel par jour – La cohérence bat la viralité
  2. Tout suivre – Chaque publication génère des données
  3. Apprendre des données – Quels hooks fonctionnent ? À quels moments ? Quels visuels ?
  4. Itérer et améliorer – Chaque carrousel est meilleur que le précédent
Jour 1 : Publier → Analyser → Apprendre
Jour 2 : Publier (amélioré) → Analyser → Apprendre
Jour 3 : Publier (encore mieux) → Analyser → Apprendre
...
Jour 30 : Vous avez 30 points de données et une stratégie affinée

La compétence maintient un fichier learnings.json qui accumule des informations sur toutes les publications :

  • Hooks les plus performants
  • Horaires de publication optimaux
  • Styles visuels qui fonctionnent
  • Appels à l'action qui convertissent

Ce n'est pas un outil à usage unique. C'est un moteur de croissance.

Démarrage rapide

# 1. Recherche complète sur l'entreprise
node {baseDir}/scripts/analyze-web.js https://votre-site.com

# 2. Générer 3 variantes de hook (CHOC, CURIOSITÉ, CONTRADICTION)
GEMINI_API_KEY="votre-clé" bash {baseDir}/scripts/generate-hooks.sh

# 3. Examiner les hooks avec la vision, choisir le meilleur

# 4. Générer les diapositives en utilisant le type de hook choisi
GEMINI_API_KEY="votre-clé" bash {baseDir}/scripts/generate-slides.sh [shock|curiosity|contradiction]

# 5. Examiner les diapositives (l'agent vérifie le texte et la qualité)
# L'agent utilise la vision pour chaque diapositive

# 6. Publier sur TikTok + Instagram
UPLOADPOST_TOKEN="votre-jeton" bash {baseDir}/scripts/publish-carousel.sh

# 7. Vérifier les analyses (après 24-48h)
UPLOADPOST_TOKEN="votre-jeton" bash {baseDir}/scripts/check-analytics.sh 7

# 8. Apprendre des données pour les prochains carrousels
node {baseDir}/scripts/learn-from-analytics.js

Catégories de hooks (Système de nouveauté visuelle)

La clé pour dépasser le plafond des 1000 vues est la nouveauté visuelle dans la première diapositive. Nous générons 3 types de hooks :

TypeObjectifStyle visuel
CHOCArrêter le défilement avec l'impossible/absurdeSurréaliste, chaotique, « attends, quoi ? »
CURIOSITÉCréer un fossé d'informationMystérieux, secrets révélés
CONTRADICTIONMontrer une combinaison impossibleDétendu + intense, « comment est-ce possible ? »

Filtre anti-stock

Tous les hooks incluent des instructions anti-stock pour éviter :

  • Les esthétiques génériques de photos de stock
  • Le cliché de la jolie fille surprise
  • Les poses typiques d'influenceurs
  • Les configurations ordinateur-café trop utilisées
  • Les scènes de poignée de main corporate

Workflow de test des hooks

  1. Générer 3 variantes avec generate-hooks.sh
  2. Examiner avec la vision, noter chaque de 1 à 5 sur la nouveauté
  3. Éliminer tout ce qui semble familier
  4. Utiliser le meilleur hook pour le carrousel
  5. Suivre quel TYPE de hook fonctionne le mieux au fil du temps

Modèle d'image

Utilise gemini-3.1-flash-image-preview pour générer les diapositives.

  • Script local : {baseDir}/scripts/generate_image.py
  • Prend en charge l'image-à-image pour la cohérence visuelle entre les diapositives

Étape 1 : Recherche complète (analyze-web.js)

Effectue une analyse COMPLÈTE de l'entreprise :

1. Analyse de marque

  • Nom de la marque (d'après le domaine ou le titre)
  • Logo (URL ou SVG)
  • Couleurs CSS (fond, primaire, liens, titres)
  • Typographie (police du corps, police des titres)
  • Favicon

2. Analyse de contenu

  • Titre et slogan
  • Tous les titres (structure de la page)
  • Fonctionnalités/avantages (titre + description)
  • Tarifs/forfaits
  • Témoignages
  • Statistiques/métriques
  • Appels à l'action
  • Balises meta (titre, description, og:image)

3. Pages internes

  • Navigue vers les pages tarifs, fonctionnalités, à propos, témoignages
  • Extrait le contenu supplémentaire de chaque page

4. Détection des concurrents

  • Recherche les mentions de concurrents connus dans le contenu
  • Liste de plus de 20 concurrents SaaS connus (Buffer, Hootsuite, Later, etc.)
  • Détecte les sections « vs », « alternative », « comparer »
  • Aucune recherche externe requise – tout provient du site web lui-même

5. Storytelling

  • Détecte le type d'entreprise (SaaS, e-commerce, application)
  • Détecte la niche (outils-réseaux-sociaux, outils-développeurs, etc.)
  • Génère des hooks basés sur les points de douleur des clients
  • Définit les points de douleur à partir des fonctionnalités
  • Crée un récit de transformation (avant → après)

6. Contexte visuel

  • Couleurs de la marque au format CSS
  • Description des couleurs pour les prompts
  • Typographie pour les diapositives
  • Thèmes d'images basés sur la niche
  • Guide de style pour la cohérence

Sortie : /tmp/carousel/analysis.json

Étape 2 : Génération des diapositives (generate-slides.sh)

Génère 6 diapositives avec cohérence visuelle en utilisant l'image-à-image :

DiapositiveTypeContenu
1ACCROCHEQuestion/problème qui accroche. Établit TOUT le style visuel.
2ProblèmeAgiter la douleur. « Vous publiez sur TikTok... puis sur Instagram... »
3AgitationLa concurrence avance. Urgence.
4SolutionPrésenter le produit avec sa proposition de valeur.
5FonctionnalitéAvantage principal.
6CTA« Lien dans la bio 👆 » + appel à l'action.

Cohérence visuelle

  • La diapositive 1 génère le style de base (couleurs, typographie, ambiance)
  • Les diapositives 2 à 6 utilisent l'image-à-image avec la diapositive 1 comme référence
  • Maintient la même palette de couleurs, les mêmes polices et la même esthétique

Prompts par diapositive

Chaque diapositive a :

  • Texte : Le message principal
  • Scène : Description visuelle détaillée de l'arrière-plan
  • Style : Basé sur l'analyse de la marque

Sortie :

  • /tmp/carousel/slide-{1-6}.jpg
  • /tmp/carousel/caption.txt

Étape 3 : Révision avec vision

Après la génération, l'agent DOIT examiner chaque diapositive :

  • ✓ Le texte est lisible et correct
  • ✓ Les mots ne sont pas coupés
  • ✓ Orthographe correcte
  • ✓ Cohérence visuelle entre les diapositives
  • ✓ Qualité d'image acceptable

S'il y a des erreurs, régénérer la diapositive concernée.

Format d'image

  • Résolution : 768 × 1376 (ratio vertical 9:16)
  • Format : JPG (TikTok n'accepte PAS le PNG)
  • Texte : Grand, gras, avec ombre pour la lisibilité
  • Arrière-plan : Scène pertinente pour l'entreprise, pas seulement des couleurs unies

Étape 4 : Publication sur TikTok + Instagram (publish-carousel.sh)

Publie le carrousel sur TikTok et Instagram en utilisant l'API Upload-Post.

UPLOADPOST_TOKEN="votre-jeton" bash {baseDir}/scripts/publish-carousel.sh

Point d'accès : POST /api/upload_photos

Paramètres envoyés :

  • platform[]=tiktok + platform[]=instagram
  • auto_add_music=true – Ajoute de la musique automatiquement sur TikTok
  • tiktok_title – Titre court (max 90 caractères) + hashtags
  • title – Légende complète pour Instagram
  • privacy_level=PUBLIC_TO_EVERYONE
  • media_type=IMAGE – Carrousel de photos sur Instagram
  • async_upload=true – Traiter en arrière-plan
  • photos[] – Les 6 diapositives JPG

⚠️ IMPORTANT Instagram : Après la publication, l'utilisateur doit aller sur Instagram et ajouter manuellement une musique virale :

  1. Ouvrir Instagram → Profil → La publication
  2. Modifier → Ajouter de la musique
  3. Rechercher une chanson tendance/virale

Sortie : Enregistre request_id dans post-info.json pour le suivi.

Étape 5 : Analyser les performances (check-analytics.sh)

Récupère les analyses TikTok et Instagram pour voir ce qui fonctionne.

UPLOADPOST_TOKEN="votre-jeton" bash {baseDir}/scripts/check-analytics.sh 7

Points d'accès utilisés :

  1. Analyse du profil :

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

    → Abonnés, likes, commentaires, partages, impressions

  2. Impressions totales :

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

    → Vues totales par jour

  3. Analyse par publication :

    GET /api/uploadposts/post-analytics/{request_id}
    

    → Vues, likes, commentaires pour le carrousel spécifique (TikTok + Instagram)

Documentation : https://docs.upload-post.com/api/get-analytics

Étape 6 : Apprendre et améliorer (learn-from-analytics.js)

Analyse les données et enregistre les apprentissages pour les futurs carrousels.

node {baseDir}/scripts/learn-from-analytics.js

Génère :

  • learnings.json – Base de connaissances accumulée
  • Meilleurs hooks (ceux générant le plus de vues)
  • Horaires de publication optimaux
  • Recommandations pour le prochain carrousel

Flux complet

# 1. Rechercher l'entreprise
node {baseDir}/scripts/analyze-web.js https://mon-produit.com

# 2. Générer les diapositives
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh

# 3. Réviser avec la vision (l'agent vérifie le texte)
# L'agent examine chaque image de diapositive

# 4. Publier
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="monutilisateur" bash {baseDir}/scripts/publish-carousel.sh

# 5. (Après quelques heures/jours) Analyser
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="monutilisateur" bash {baseDir}/scripts/check-analytics.sh 7

# 6. Apprendre pour les prochains carrousels
node {baseDir}/scripts/learn-from-analytics.js

Fichiers

{baseDir}/
├── SKILL.md                      # Cette documentation
└── scripts/
    ├── analyze-web.js            # Recherche complète de l'entreprise
    ├── generate-slides.sh        # Générer 6 diapositives cohérentes
    ├── generate_image.py         # Image Gemini 3.1 flash
    ├── review-slides.js          # Préparer les diapositives pour la révision
    ├── publish-carousel.sh       # Publier via l'API Upload-Post
    ├── check-analytics.sh        # Obtenir les analyses (TikTok + Instagram)
    ├── learn-from-analytics.js   # Apprendre des données
    └── search-competitors.js     # Recherche externe optionnelle

Variables d'environnement

VariableDescription
GEMINI_API_KEYClé API Google pour la génération d'images
UPLOADPOST_TOKENJeton Upload-Post pour la publication et les analyses
UPLOADPOST_USERNom d'utilisateur Upload-Post (obligatoire)

Exemples de hooks par niche

NicheExemple de hook
Outils réseaux sociaux« Vous publiez encore sur les réseaux sociaux UN PAR UN ? 😩 »
SaaS général« Vous faites encore ça MANUELLEMENT ? »
E-commerce« Le produit que TikTok ne va pas arrêter de recommander »
Application« L'appli que j'aurais aimé découvrir plus tôt »
Outils développeurs« L'API qui va changer votre code »

Pourquoi Viraloop ?

ViraloopAutres compétences
PublicationDirectement sur le filBrouillons uniquement
MusiqueMusique tendance automatiqueManuelle
PlateformesTikTok + InstagramPlateforme unique
RechercheAnalyse automatique d'URLDescription manuelle
Cohérence imageRéférence image-à-imageDiapositives indépendantes
Génération d'imageGemini (offre gratuite)Fournisseurs payants
Publicationupload-post.com (gratuit, sans CB)Payant ou auto-hébergé
Superposition de texteIA native (Gemini rend)Scripts externes
PromptsModèles structurésLibre
Configuration3 variables d'environnementConfiguration multi-outils complexe

Remarques

  • L'analyse extrait les concurrents du contenu du site web lui-même (plus de 20 SaaS connus)
  • L'image-à-image maintient la cohérence mais prend environ 20 s par diapositive
  • La légende générée inclut des hashtags pertinents à la niche
  • Toujours réviser le texte des diapositives – parfois il est coupé
  • auto_add_music sur TikTok améliore l'engagement
  • Vérifier les analyses après 24-48 h pour des données significatives
  • Les apprentissages s'accumulent et s'améliorent avec chaque carrousel publié
  • Titre TikTok max 90 caractères (tronqué automatiquement avec les hashtags)

Skills associés