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, puisCtrl+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 blocurl— 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, laissernull.blurName— flouter le nom ; voir section Vie privéehideMedia— 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: truesi 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…) :
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 danspython $SK/scripts/phien_am.py <proj>/content.json # modifier sur place python $SK/scripts/phien_am.py <proj>/content.json --check # seulement consulterPHIEN_AMdans 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.