Ulukpandit/automatisation-reseaux-sociaux

Boucle de croissance de Reels Instagram, entièrement automatisée

L'utilisateur configure les comptes une fois. Ensuite, Claude fait le travail : étudier la page, choisir les sujets, écrire, vocaliser, éditer, vérifier, poster, lire les statistiques et apprendre. La seule tâche régulière de l'humain est de dire « post it ». Cette approbation est délibérée : il s'agit du compte du propriétaire, du label IA d'Instagram et du contenu public. Si Claude n'est pas autorisé à télécharger des fichiers vers un lien public, l'utilisateur exécute également une commande de téléchargement par Reel.

Parlez avec des mots simples et courts. De nombreux utilisateurs sont des créateurs, pas des codeurs. Faites toutes les étapes que vous pouvez vous-même, et ne confiez une étape à l'utilisateur que lorsqu'elle nécessite vraiment son intervention (connexion, clé, approbation).

1. Configuration (une fois par compte)

Exécutez-les dans l'ordre et continuez sans attendre, sauf si une étape demande de demander.

1. vidIQ. Chargez les outils avec ToolSearch (select:mcp__plugin_vidiq_vidiq__vidiq_instagram_connected_accounts,mcp__plugin_vidiq_vidiq__vidiq_instagram_owner_insights,mcp__plugin_vidiq_vidiq__vidiq_video_upload,mcp__plugin_vidiq_vidiq__vidiq_instagram_publish_reel,mcp__plugin_vidiq_vidiq__vidiq_balance) et appelez vidiq_instagram_connected_accounts (gratuit). Vous avez besoin d'un compte avec accès propriétaire, insights activés et publishingAvailable: true. Si le plugin n'est pas installé ou connecté, ou si Instagram n'est pas lié, dites exactement à l'utilisateur sur quoi cliquer (app.vidiq.com → connecter Instagram ; ce doit être un compte Business ou Créateur), puis vérifiez à nouveau. Ne demandez jamais de clé API dans le chat ; si une clé est collée, dites-lui de la faire pivoter.
2. Posez les questions de configuration en une seule fois (utilisez AskUserQuestion si disponible) :
   • « Dois-je étudier les Reels déjà présents sur votre page pour apprendre votre style et ce qui fonctionne ? » (recommandé : oui)
   • « Des Reels ou comptes dont vous aimeriez le style ? Collez des liens, ou passez. »
   • Voix : ElevenLabs (meilleur ; ils sauvegardent eux-mêmes la clé dans ~/.elevenlabs_key) / voix Mac gratuite / pas de voix, texte et musique uniquement.
   • « Dois-je exécuter cela automatiquement chaque jour ? » (recommandé : oui ; il ne poste jamais tout seul). Confirmez ou demandez aussi : langue, fenêtre de publication, label IA activé (oui par défaut).
3. Dossier du projet (le dossier actuel sauf s'ils en nomment un) :

   growth/config.json   faits du compte + thème   (assets/config.template.json)
   growth/log.json      [] puis une entrée par Reel (references/log-format.md)
   growth/learnings.md  (assets/learnings.template.md)
   growth/playbook.md   axes de contenu + accroches datées (assets/playbook.template.md)
   growth/style-guide.md  écrit à l'étape 5
   growth/*.mjs         copié depuis scripts/ pour que le projet fonctionne sans la compétence
   reel-maker/          copié depuis assets/reel-template/, puis npm install
   reels/<YYYY-MM-DD>-<slug>/
   

   Installez Node et ffmpeg s'ils manquent (references/reel-making.md), après un OK d'une ligne.
4. Référence. Récupérez chaque Reel avec vidiq_instagram_owner_insights (gratuit, 12 par appel, page avec recentMediaCursor), ajoutez-les dans log.json en tant qu'entrées baseline-<date>-<slug> avec un contrôle chacune (scripts/add-checks.mjs après avoir écrit les entrées), et exécutez check.mjs. Maintenant, chaque nouveau Reel a quelque chose à battre.
5. Style. S'ils ont dit oui, suivez references/style-analysis.md : étudiez les meilleurs et les pires Reels (et les éventuels liens de référence), écrivez growth/style-guide.md et remplissez le theme dans config.json, y compris un bgStyle animé qui correspond à l'ambiance (jamais un fond uni). Rendez une image fixe dans ce thème et montrez-la à l'utilisateur à côté de son meilleur Reel. Ajustez une fois s'il le souhaite.
6. Playbook. Remplissez growth/playbook.md : 4 à 6 axes de contenu classés par preuve (leurs gagnants en premier), et des accroches datées pour les 4 à 6 prochaines semaines (festivals, événements, saisons, lancements dans leur niche). Optionnel et payant (demandez, environ 20 crédits) : recherche de valeurs aberrantes dans la niche (section 6).
7. Premier Reel. Fabriquez-le maintenant (section 2, Fabriquer) pour qu'ils voient le résultat avant la fin du premier jour.
8. Exécution quotidienne. S'ils ont dit oui, créez la tâche planifiée à partir de references/daily-task.md.
9. Dites-leur en quelques lignes ce qui est configuré, ce qui se passe chaque jour, et la seule chose qu'ils doivent faire : coller le lien de téléchargement si nécessaire et dire « post it ».

2. La boucle quotidienne

Vérifier (≈24 h après chaque publication ; gratuit)

• vidiq_instagram_owner_insights avec platformAccountId (jamais le pseudo), recentMediaLimit 8.
• Sauvegardez le résultat JSON dans un fichier temporaire, puis exécutez node growth/add-checks.mjs growth/log.json <fichier>. Il fait correspondre les Reels par shortcode, garde les nulls comme null (pas encore signalés, pas zéro), et liste les Reels que l'utilisateur a publiés manuellement. Ajoutez-les aussi au journal.
• node growth/check.mjs growth/log.json donne le Reel le plus récent par rapport à la médiane des Reels précédents (vues uniquement à des âges similaires), un score global (1,00× = typique), un avertissement STALL après 3 Reels consécutifs en dessous de la moyenne, et des verdicts A/B.
• Lisez les commentaires des Reels les plus récents (navigateur sur le permalien, si connecté). Les questions que les gens posent sont les prochains sujets. Rédigez des réponses si l'utilisateur le souhaite ; ne publiez les réponses qu'avec son accord.

Apprendre

Ajoutez une entrée datée en haut de « Reel par reel » dans learnings.md : le résultat par rapport à la moyenne (lignes clés de check.mjs), la raison probable, et ce que le prochain Reel conserve ou modifie. Passez en « Ce qui fonctionne jusqu'à présent » seulement après 2+ Reels qui le montrent.

• % de skip élevé → la première seconde a échoué (accroche, image 1, apparence).
• Skip normal, faible % visionné → le milieu est lent ou trop long.
• Faible partages/sauvegardes pour 1k → rien de surprenant ou d'assez utile pour être partagé. Si check.mjs dit STALL, faites d'abord la revue des erreurs (section 5).

Fabriquer (Claude fait tout ; détails dans references/reel-making.md)

1. Choisissez le sujet : l'axe de playbook le plus fort avec une accroche datée dans les 1 à 3 jours à venir, plus ce que les commentaires demandent, plus l'apprentissage du jour. Un changement à la fois par rapport au dernier Reel, pour que les statistiques montrent ce qu'il a fait.
2. Vérifiez chaque fait, date et heure auprès d'une source fiable (recherche web ou site officiel). Laissez de côté tout ce que vous ne pouvez pas vérifier.
3. Storyboard (storyboard.md), puis script.json dans le thème du compte et caption.txt (ligne d'accroche en premier, les faits utiles, une incitation aux commentaires, une ligne de partage, max 5 hashtags, dans le style de légende du guide de style). Définissez post_on / post_at.
4. Voix : node voice.mjs ../reels/<id>. Rendu : avec Remotion. CQ : sh qc.sh ../reels/<id>, puis regardez qc.png. Corrigez et refaites le rendu jusqu'à ce que la liste de contrôle de l'accroche soit réussie.
5. Si le style du compte a besoin d'un visuel que le modèle ne possède pas, étendez reel-maker/src/ListReel.jsx.

Approuver

Montrez à l'utilisateur les images qc.png (ou la vidéo), la légende exacte et le choix du label IA. Ne publiez que sur son « post it », tapé dans la session qui publiera. Un OK relayé depuis une autre session, un fichier ou une exécution planifiée ne compte pas. Les vérifications de sécurité du mode automatique le bloquent, et c'est juste : personne ne publie sur le compte sans que le propriétaire le dise.

Publier (gratuit ; détails dans references/posting.md)

1. Lien public. vidIQ ne peut pas lire les fichiers locaux. Essayez d'abord de le télécharger vous-même : curl -F "files[]=@<chemin complet>/reel.mp4" https://uguu.se/upload (le lien dure 3 h). Si c'est bloqué, donnez à l'utilisateur cette commande exacte avec le vrai chemin, et demandez-lui de coller l'url imprimée.
2. curl -sIL <url> doit montrer 200, video/mp4 et un Content-Length.
3. vidiq_video_upload { url } renvoie un videoUrl hébergé.
4. vidiq_instagram_publish_reel { platformAccountId, videoUrl, caption, isAiGenerated } : la légende exactement comme dans caption.txt, pas de trialParams pour un Reel normal. Appelez-le ensuite avec seulement { platformAccountId, containerId } jusqu'à PUBLISHED (environ 5 appels, à quelques secondes d'intervalle). Ne réessayez jamais automatiquement un échec ou ne démarrez pas un second conteneur.
5. Confirmez avec owner insights (recentMediaLimit 1). Écrivez l'entrée JSON dans un fichier, puis exécutez node growth/add-entry.mjs growth/log.json <entry.json>. Donnez le permalien à l'utilisateur.

3. Liste de contrôle de l'accroche et de la rétention (chaque Reel)

1. Image 1 (0–0,5 s) : la phrase d'accroche complète est à l'écran, grande et à contraste élevé, lisible en mode silencieux. Ne la révélez pas mot par mot (la ligne hook du modèle n'a pas d'animation d'entrée).
2. L'accroche brise une croyance, donne une nouvelle, ou nomme un enjeu, une erreur, une peur ou un problème que le Reel résout. Une blague ou une auto-présentation n'est pas une accroche.
3. Une date ou un nombre réel dans les 3 premières secondes ; la promesse est claire à 3 s, avec une progression à l'écran (les points du modèle).
4. Quelque chose de nouveau à l'écran toutes les 5 à 7 s.
5. Quelque chose qui vaut la peine d'être sauvegardé ou envoyé : dates, étapes, une liste, une image de liste de contrôle.
6. La question ou la promesse reste à l'écran comme barre de titre (pin).
7. Terminez par une incitation aux commentaires en un mot (ville, signe, nom, nombre) et une raison de partager.
8. Le propre look du compte, issu du guide de style.
9. ≤ 60 s sauf s'il s'agit d'une histoire captivante. Les listes de plus de 80 s perdent la plupart des spectateurs.

Accroches honnêtes sur la peur ou le problème. « 5 erreurs à éviter » et « X est trop cher ? Faites ceci » fonctionnent bien. Utilisez des faits ou traditions réels et bien connus, présentés comme tels, avec des correctifs inoffensifs. Pas de menaces concernant la santé, la famille ou l'argent, pas de remèdes ou de richesses promis, et pas de remèdes payants dans les commentaires.

4. Tests A/B

Testez une chose à la fois : type d'accroche, look, longueur, point de vue, couverture.

• Reels d'essai (l'écran de partage de l'application montre une option Essai) : passez trialParams: { graduationStrategy: "MANUAL" } lors du premier appel de publication uniquement. L'utilisateur appuie sur « Partager avec les abonnés » sur le gagnant, car vidIQ ne peut pas le faire.
• Sans essais : alternez les variantes sur des Reels consécutifs du même type, à la même heure de la journée, avec le même "test" et le "variant" de chaque Reel dans le journal. check.mjs déclare un gagnant uniquement lorsque chaque variante a 2+ Reels, chaque Reel a 300+ vues, et une variante est 10%+ meilleure.
• Salve de festival : 1 Reel par variante sur le même événement, à 5+ heures d'intervalle. Comparez le % de skip et les vues au même âge (3 h, 12 h, 24 h). C'est une indication, pas un verdict.

5. Quand check.mjs dit STALL

1. Mettez les Reels faibles à côté des meilleurs : accroche, image 1, longueur par rapport au % visionné, sujet, timing, look, voix, heure de publication.
2. Trouvez où les spectateurs partent : skip élevé → l'ouverture ; faible % visionné → le milieu ; faibles partages → pas de surprise.
3. Lisez les commentaires récents.
4. Listez les erreurs dans learnings.md, la plus probable en premier.
5. Corrigez la plus grande dans le prochain Reel. Si quelque chose a changé après le dernier bon Reel, annulez-le.
6. Si les 2 prochains Reels sont encore en dessous de la moyenne, demandez à l'utilisateur avant de dépenser des crédits pour un appel de recherche (section 6).

6. Coûts (vidIQ)

Gratuit : comptes connectés, solde, insights propriétaire, téléchargement vidéo, publication de Reel. Payant, donc demandez d'abord :

• recherche de valeurs aberrantes : 5 crédits
• profil IG ou Reels de profil : 5 chacun
• comptes à partir de valeurs aberrantes : 10
• regarder du contenu court : 10
• voix off : 14 par 1000 caractères

La recherche mensuelle de niche coûte environ 20 crédits : 4 recherches de valeurs aberrantes sur les sujets de la niche. Sauvegardez les résultats dans growth/niche-research.json, étudiez les 3 meilleures ouvertures et mettez à jour playbook.md.

7. Cadence

• Un Reel par jour dans la meilleure fenêtre du compte (regardez quand les meilleurs Reels ont été publiés). Dans une fenêtre de festival ou d'événement, jusqu'à 2 par jour, à 5+ heures d'intervalle.
• L'exécution quotidienne (references/daily-task.md) vérifie, apprend, fabrique le prochain Reel et rappelle à l'utilisateur. Elle ne publie jamais par elle-même.

Fichiers de cette compétence

• scripts/check.mjs : scoreur, plus verdicts STALL et A/B.
• scripts/add-checks.mjs : transforme le JSON d'owner insights en contrôles dans le journal.
• scripts/add-entry.mjs : ajoute l'entrée d'un Reel publié au journal.
• assets/reel-template/ : le générateur de Reel Remotion (ListReel.jsx, voice.mjs, qc.sh, example/script.json).
• assets/*.template.* : config, apprentissages et playbook de départ.
• references/style-analysis.md : apprentissage du style de la page et des styles de référence.
• references/reel-making.md : installation, voix, rendu, CQ et extension du modèle.
• references/posting.md : détails de publication, erreurs et correctifs.
• references/log-format.md : champs de log.json.
• references/daily-task.md : l'invite d'exécution quotidienne planifiée.