Communitygithub.com

Annie-246/tabcom-skills

Transforme un fil de questions-réponses sur Threads ou Facebook en vidéo verticale 9:16 style TikTok — captures d'écran réelles du post et des commentaires défilant sur un fond paysager, avec voix-off en vietnamien et musique de fond. Utilisé quand un utilisateur envoie un lien threads.com ou facebook.com avec l'intention de « faire une vidéo », « monter une vidéo à partir de ce post », « capturer les commentaires en vidéo », « faire une vidéo Q&A », « transformer ce post en TikTok/Reels », ou simplement colle un lien dans un contexte de création de vidéo courte. Utilisé aussi pour modifier le contenu, changer la voix, la musique ou re-rendre une vidéo déjà créée avec cette compétence.

Qu'est-ce que tabcom-skills ?

Cette compétence, conçue pour des agents IA comme Claude, Cursor ou Codex, automatise la création de vidéos verticales au format 9:16 (1080×1920) à partir de fils de discussion Threads ou Facebook. Elle capture les posts et commentaires réels (avatars, noms, likes) grâce à des scripts Puppeteer, puis assemble une vidéo avec un fond paysager, une voix-off vietnamienne générée par edge-tts, et une musique libre de droits de Mixkit. Le processus inclut : extraction du contenu, sélection des commentaires les plus pertinents, capture d'écran avec zoom (SHOT_ZOOM), prétraitement des images (coins arrondis, ombres), phonétisation des mots anglais pour une prononciation correcte (ex: KOC→«cây âu xi»), et montage final via ffmpeg. La compétence garantit la fidélité au texte original, brouille les noms réels sur demande, et produit des vidéos de 1,5 à 2 minutes. Fonctionnant entièrement en local, elle est gratuite et ne nécessite qu'un navigateur Chrome, Node.js, Python et ffmpeg.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Annie-246/tabcom-skills/tree/HEAD/plugins/social-qa-video/skills/social-qa-video

Demander à votre IA préférée

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

Documentation

Vidéo questions-réponses depuis Threads / Facebook

Monte une vidéo verticale 1080×1920 : captures d'écran réelles du post et des commentaires (en conservant les avatars, noms, icônes like, nombre de likes) placées au centre du cadre, défilant très lentement sur un fond paysager assombri ; voix-off en vietnamien lisant le texte original ; musique de fond baissant automatiquement pendant la voix.

Entièrement gratuit : captures via Chrome, voix via edge-tts, fonds et musique depuis Mixkit.

Processus

Définir SK=${CLAUDE_SKILL_DIR} (dossier de cette compétence ; en installation manuelle, ~/.claude/skills/social-qa-video). Chaque vidéo est un dossier de projet distinct.

1. Récupérer le contenu

Threads (post public — capture directe du web, sans connexion) :

node $SK/scripts/threads_dump.js "<url>" shot/threads.json       # ~13 premiers blocs
node $SK/scripts/threads_links.js "<url>" shot/threads_all.json  # plus profond : ouvre chaque permalien de réponse
python $SK/scripts/threads_filter.py                              # filtre les spams, garde les réponses pertinentes

threads_dump est rapide mais Threads ne montre qu'environ 13 blocs aux visiteurs. threads_links ouvre le permalien de chaque commentaire, donc en collecte bien plus (sur un post de 424 réponses, il en extrait 53 réels).

Facebook (connexion requise → demander à l'utilisateur de sauvegarder la page) :

Ouvrir le post avec le lien direct de type /posts/<id>/ (ne pas sauvegarder depuis le fil d'actualité), déplier tous les "Voir plus de commentaires" / "Voir plus", remonter en haut du post, puis Ctrl+S → "Page Web, complète" ou .mhtml.

node $SK/scripts/fb_list.js "<fichier sauvegardé>"   # liste les commentaires EFFECTIVEMENT affichés

2. Sélectionner les commentaires & écrire les cibles

Choisir des commentaires longs, avec un point de vue original, avec beaucoup de likes ; garder au moins un point de vue contradictoire. Écrire shot/targets.json :

[{"key": "card01", "needle": "extrait de texte caractéristique", "blurName": false,
  "hideMedia": true, "url": null}]
  • needle — un morceau de texte suffisamment distinctif pour trouver le bon bloc
  • url — Threads : null = capture sur la page d'origine (conserve le nombre de likes), ou un permalien séparé (texte plus grand mais perd les likes). Pour les cartes avec un nombre impressionnant de likes, laisser null.
  • blurName — flouter le nom ; voir section Vie privée
  • hideMedia — masquer les images jointes pour que la carte ne soit pas trop haute
  • Facebook ajoute kind : "post" pour le post, "comment" pour le commentaire ; keepBackground: true si le post est un fond dégradé avec texte blanc

3. Capturer et préparer les cartes

SHOT_ZOOM=1.6 node $SK/scripts/threads_shot.js "<url>" shot/targets.json shot/raw
# Facebook :
SHOT_ZOOM=1.9 node $SK/scripts/fb_shoot.js "<fichier sauvegardé>" shot/targets.json shot/raw

python $SK/scripts/prep_shots.py shot/raw <proj>/cards   # arrondir les coins, ombre portée, limiter la hauteur

SHOT_ZOOM agrandit la mise en page avant capture pour que le texte soit plus lisible une fois réduit dans le cadre vertical : 1.6 pour Threads, 1.9 pour Facebook. Toujours vérifier les images (Lire le fichier PNG) avant de rendre.

4. Écrire content.json puis rendre

python $SK/scripts/new_project.py <proj> 8     # créer le squelette content.json
cd <proj>
python $SK/scripts/phien_am.py content.json   # phonétiser les mots anglais
python $SK/scripts/tts.py
python $SK/scripts/build_bg.py
python $SK/scripts/build_final.py              # -> output/video-hoan-chinh.mp4

content.json : chaque carte a speak = texte lu. Le nombre de cartes doit correspondre au nombre d'images dans cards/.

Variables d'environnement : BG_DIR (ensemble de fonds : assets/bg/nature ou assets/bg/city), MUSIC (fichier musique), PAD (pause après chaque phrase, par défaut 0,9 s).

Règles de contenu

  • Lire le texte original. Ne pas ajouter de phrases d'introduction comme "Un autre dit que…". Uniquement développer les abréviations pour une lecture correcte par la synthèse : sx→sản xuất, 15tr→mười lăm triệu, b→bạn, ko→không, đc→được, cmt→comment, frs→freeship.
  • Phonétiser les mots anglais — obligatoire, à exécuter avant la génération vocale. edge-tts lit les mots anglais en les épelant à la vietnamienne, ce qui sonne très faux (KOC, KOL, follower…) :
    python $SK/scripts/phien_am.py <proj>/content.json          # modifier sur place
    python $SK/scripts/phien_am.py <proj>/content.json --check  # seulement consulter
    
    KOC→"cây âu xi", KOL→"cây âu eo", follower→"pho lâu ơ", TikTok→"Tích Tóc", Shopee→"Sô pi", brand→"bờ ren", data→"đây ta"… Pour les nouveaux mots non listés, les ajouter dans PHIEN_AM dans le script. Applicable uniquement à speak ; les captures d'écran conservent le texte original.
  • Ne pas inventer. Ne pas ajouter de faux nombres de likes, ni de commentaires inexistants.
  • Commencer par le commentaire le plus percutant (beaucoup de likes ou histoire forte), terminer par une phrase qui laisse une impression durable ou un point de vue opposé.
  • Si un long commentaire a été coupé en plusieurs morceaux par la plateforme, les reconstituer pour qu'il soit fluide.

Vie privée

Flouter les noms réels (Sơn Ngọc Trần, Truong Chi Cong…). Conserver les pseudonymes générés automatiquement (ProductivePersimmon7745, hdtshop.vn, sontap88…) car ils sont déjà anonymes. Mettre blurName: true pour la carte à flouter — le script floute à la fois le nom et l'avatar.

Durée

Environ 1 minute 30 à 2 minutes est idéal. Estimation : ~14 mots vietnamiens ≈ 1 seconde de lecture (vitesse +18 %). Si trop long, réduire le nombre de cartes, ne pas ralentir la lecture.

Musique

Par défaut, utilise la musique Mixkit dans assets/music (instrumentale, utilisable commercialement, sans attribution requise). Pour utiliser une musique tendance de TikTok, définir MUSIC=<fichier> — mais ces musiques sont protégées par le droit d'auteur : les publier sur TikTok est généralement sans risque car TikTok a les licences, mais pour YouTube/Facebook, il est préférable de publier une version sans musique puis d'ajouter la musique dans l'application.

Première exécution sur une nouvelle machine

python $SK/scripts/fetch_assets.py    # télécharger les clips de fond + musique Mixkit

Nécessite : ffmpeg, yt-dlp, node + puppeteer-core, Chrome, Python avec Pillow, edge-tts. Voix : vi-VN-HoaiMyNeural (féminine, phrase d'ouverture et de conclusion) et vi-VN-NamMinhNeural (masculine, les commentaires) — à modifier dans scripts/tts.py.

En cas d'échec de capture d'écran

Consulter references/troubleshooting.md — il reprend l'ensemble des pièges de Facebook et Threads (copie DOM cachée, zone de défilement distincte, popup superposée, mode sombre) ainsi que leurs solutions déjà implémentées.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés