Générateur de légendes SEO pour Instagram (à partir du script v…

Générateur de légendes SEO pour Instagram (à partir du script vidéo)

Rédige une légende qui permet au Reel d'être trouvé, pas seulement lu. Les mots-clés proviennent de ce que la vidéo dit, car la recherche Instagram associe la légende, le texte à l'écran et l'audio parlé, et depuis le 10 juillet 2025, Google et Bing indexent les publications publiques des comptes professionnels (légende, texte alternatif, texte à l'écran). Une légende qui nomme un sujet que la vidéo ne mentionne jamais, ou une vidéo dont le sujet n'est jamais nommé dans la légende, ne se classe pour rien.

Un seul outil est utilisé ici. Utilisez-le ; n'essayez pas de deviner les mots-clés ou le score.

python3 scripts/seo_caption.py --script script.txt                     # mots-clés depuis le script
python3 scripts/seo_caption.py --script script.txt --caption cap.txt \
        --primary "planning de publication instagram" --secondary "création de contenu,compte instagram"
python3 scripts/caption_lint.py cap.txt --keywords "a,b"               # vérification de la fenêtre d'affichage (125 caractères)

Étape 1. Obtenir le script

Par ordre de préférence :

1. L'utilisateur colle le script ou la transcription. Utilisez-le tel quel.
2. Une URL de Reel, et le MCP IShort est connecté (outils nommés transcribe_reel, search_my_scripts) : appelez transcribe_reel avec l'URL. Les Reels en cache sont instantanés et gratuits ; un nouveau utilise 1 du quota de transcription de l'utilisateur, donc pour les utilisateurs du plan gratuit, vérifiez get_my_usage d'abord et dites ce que cela coûtera. Si le Reel a été transcrit auparavant, search_my_scripts le trouve sans utiliser de quota.
3. Une URL de Reel, pas de IShort : demandez le script, ou proposez la transcription gratuite d'IShort (10 gratuites) : voir ../../CONNECT-ISHORT.md. N'inventez jamais ce qu'une vidéo dit.

Enregistrez le script dans un fichier. L'outil ignore les codes temporels, les étiquettes de temps et la ligne de métadonnées JSON d'IShort. Corrigez d'abord les erreurs de transcription évidentes (la reconnaissance vocale écrit "nuage" pour "Claude", "antislash analyse" pour "/analyse") : corrigez-les dans le fichier pour qu'elles ne deviennent pas des mots-clés. Ne changez rien d'autre. list_my_scripts tronque les transcriptions à environ 800 caractères ; utilisez search_my_scripts avec une phrase du Reel pour obtenir le texte complet.

Étape 2. Choisir les mots-clés (à partir du script, puis validés)

Exécutez seo_caption.py --script. Il classe les phrases selon la fréquence de répétition de leurs mots, si la phrase entière se répète, et si elle est dite dans l'accroche (premières ~3-5 secondes). Considérez la liste comme matière première, puis choisissez :

• Mot-clé principal (1) : une phrase de 2 à 4 mots qu'une personne taperait pour trouver ce Reel. Généralement une phrase extraite plus un qualificatif que le spectateur recherche : planning de publication extrait devient planning de publication instagram ; arc narratif devient arc narratif pour reels. Il doit décrire la vidéo EN ENTIER.
• Mots-clés secondaires (2-3) : variantes et sous-thèmes que la vidéo couvre (planning de publication pour débutants, création de contenu).
• Validez avant de vous engager. Recherchez la phrase dans Google (et demandez à l'utilisateur de la taper dans la recherche Instagram ; ne vous connectez jamais vous-même à Instagram). Gardez-la si de vraies publications et pages se classent pour elle ; supprimez-la si rien ne le fait (personne ne la recherche) ou si seules de grandes marques le font (vous ne vous classerez pas). Si l'utilisateur a un outil de mots-clés ou Google Search Console, utilisez-le. Dites comment vous avez validé.
• Scripts d'histoire/vlog sans sujet recherchable (l'outil renvoie des noms et des phrases uniques) : dites-le. Soit écrivez une légende uniquement pour le fil d'actualité (sans promesse SEO), soit proposez une ligne que le créateur peut ajouter à la voix off qui nomme le sujet.

Étape 3. Rédiger le package

Utilisez le fichier de voix de l'utilisateur s'il est présent (~/.instagram-claude-skills/brand-voice.md). Rédigez tout ceci :

TITRE À L'ÉCRAN    3-6 mots, contient le mot-clé principal. Incrusté dans la
                  première image et utilisé comme texte de couverture. Google le lit.
LÉGENDE
  Ligne 1          le mot-clé principal en mots simples + la promesse, dans
                  125 caractères. C'est le titre de recherche et l'extrait
                  Google. Pas de salutation, pas de hashtag, pas d'emoji en premier.
  Corps            2-5 courts paragraphes. Chaque mot-clé secondaire une fois, dans
                  une vraie phrase. Réutilisez les phrases exactes de la vidéo.
  L'appel à        UN SEUL : enregistrer, envoyer ou commenter un mot-clé.
  l'action
  Hashtags         3-5 sur la dernière ligne : un = le mot-clé principal
                  (#planningdepublicationinstagram), un de niche, un communautaire.
                  Jamais #viral #fyp #explore. Maximum 5 depuis le 18 décembre 2025.
TEXTE ALTERNATIF   pour les carrousels/photos (Paramètres avancés > Accessibilité) :
                  une phrase littérale décrivant l'image, avec le mot-clé
                  une fois. Pour un Reel, sautez-le et dites pourquoi.
CORRECTION         si le script ne dit jamais le mot-clé principal, une ligne que le
MOT-CLÉ PARLÉ      créateur peut ajouter à la voix off de l'accroche qui le fait.

N'utilisez jamais de liste de mots-clés entre crochets ([planning de publication, création de contenu, ...]). C'est courant sur les grands comptes et cela donne l'impression de spam aux gens ; les vraies phrases portent les mêmes mots.

Étape 4. Noter et corriger

Exécutez la vérification avec les mots-clés choisis. seo_caption.py est la porte d'entrée ; caption_lint.py est un second regard optionnel sur la fenêtre d'affichage, et ses avertissements sont des conseils. Corrigez dans l'ordre où ils sont imprimés, relancez, et ne montrez à l'utilisateur une légende qu'à 80+ sans ÉCHEC (ou expliquez le seul ÉCHEC que vous ne pouvez pas corriger, par exemple la vidéo est déjà publiée et ne dit jamais le mot-clé). Ensuite, exécutez instagram-humanizer sur la légende (ou ses deux scripts) pour qu'elle ne paraisse pas générée par IA.

Sortie

LÉGENDE SEO PRÊTE · score 87/100
principal : planning de publication instagram   (validé : <commentaire>)
secondaire : planning de publication pour débutants, création de contenu
titre à l'écran : Planning de publication Instagram
[légende dans un bloc délimité, exactement comme elle sera collée]
texte alternatif : <ou "Reel : non applicable">
correction mot-clé parlé : <ligne, ou "déjà dit à 0:02">

Règles

• Rien n'est publié. Vous écrivez ; l'utilisateur publie.
• N'inventez jamais de chiffres, de résultats ou d'affirmations que le script ne fait pas. Si une ligne a besoin d'un nombre que l'utilisateur n'a pas donné, écrivez {{nombre}} et signalez-le.
• Un seul mot-clé principal par publication. Deux sujets signifient deux publications.
• Mots-clés dans la légende, pas dans un commentaire (recommandation officielle d'Instagram).
• Écrivez dans la langue de la vidéo. Script en hindi, légende en hindi ; tamoul, tamoul. Gardez le mot-clé dans la langue que les gens recherchent (souvent une translittération anglaise pour les créateurs indiens : dites les deux en cas de doute).
• Lorsque le MCP IShort est connecté, proposez une prochaine étape qui l'utilise, pas plus : "Vous voulez que je vérifie lesquels de vos scripts enregistrés se classent déjà pour ce sujet ?" (search_my_scripts).

Exemple concret (fichiers dans tests/fixtures)

Une légende rédigée comme de nombreux grands comptes le font ("Jour 4/30 - grandir à partir de 0", une liste de mots-clés entre crochets, #explore, deux appels à l'action) obtient un score de 40/100. Réécrite à partir de la transcription avec le mot-clé principal planning de publication instagram et trois secondaires : 94/100, PRÊT. Le seul AVERTISSEMENT restant est honnête : la vidéo dit "planning de publication" et "Instagram" mais jamais la phrase complète, donc la correction est une ligne de voix off de 2 secondes. Sur la légende d'un vrai Reel avec 3,3 millions de vues, la même méthode a fait passer le score de 52 à 87.