Communitygithub.com

Video hỏi-đáp từ Threads / Facebook

Transforma una publicación de preguntas y respuestas de Threads o Facebook en un video vertical 9:16 estilo TikTok — capturas reales de la publicación y comentarios que se deslizan sobre un fondo de paisaje, con voz en vietnamita y música de fondo.

¿Qué es Facebook?

Esta habilidad está diseñada para agentes de IA (como Claude Code, Cursor o Codex) que necesitan convertir hilos de preguntas y respuestas de Threads o Facebook en videos verticales formato TikTok (9:16, 1080×1920). El proceso utiliza capturas reales de pantalla de las publicaciones y comentarios (manteniendo avatares, nombres, íconos de 'me gusta' y recuentos de likes), los cuales se deslizan lentamente sobre fondos de paisajes oscurecidos, con narración en vietnamita de voz real (edge-tts) y música de fondo sin derechos (Mixkit). La habilidad es completamente gratuita y no requiere API pagas. El flujo de trabajo incluye la extracción de contenido (con scripts específicos para Threads y Facebook), la selección de comentarios, la generación de tarjetas visuales, la transcripción fonética de términos en inglés para mejorar la pronunciación, y la renderización final del video. Soporta personalización del fondo, la música, la velocidad de narración y la privacidad (difuminado de nombres reales). Es ideal para creadores de contenido que desean automatizar la producción de videos virales a partir de conversaciones reales en redes sociales.

Compatible con✓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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Video de preguntas y respuestas desde Threads / Facebook

Crea un video vertical 1080×1920: capturas reales de la publicación y los comentarios (manteniendo avatares, nombres, iconos de like y número de likes) colocados en el centro, desplazándose lentamente hacia arriba sobre un fondo de paisaje oscurecido; narración en vietnamita que lee el texto original; música de fondo que baja automáticamente cuando hay voz.

Todo es gratuito: capturas con Chrome, voz con edge-tts, fondos y música de Mixkit.

Procedimiento

Establece SK=${CLAUDE_SKILL_DIR} (directorio de esta habilidad; si la instalas manualmente, es ~/.claude/skills/social-qa-video). Cada video es un directorio de proyecto independiente.

1. Obtener el contenido

Threads (publicación pública — se captura directamente desde la web, sin necesidad de inicio de sesión):

node $SK/scripts/threads_dump.js "<url>" shot/threads.json       # ~13 bloques iniciales
node $SK/scripts/threads_links.js "<url>" shot/threads_all.json  # más profundo: abre el enlace permanente de cada respuesta
python $SK/scripts/threads_filter.py                              # filtra spam, conserva respuestas relevantes

threads_dump es rápido, pero Threads solo muestra ~13 bloques a visitantes. threads_links abre el enlace permanente de cada comentario, por lo que recopila muchos más (de una publicación con 424 respuestas, extrae 53 reales).

Facebook (requiere inicio de sesión → pide al usuario que guarde la página):

Abre la publicación con el enlace directo en formato /posts/<id>/ (no la guardes desde el Feed de noticias), expande todos los "Ver más comentarios" / "Ver más", desplázate hacia arriba hasta el inicio de la publicación, luego Ctrl+S → "Página web, completa" o .mhtml.

node $SK/scripts/fb_list.js "<archivo guardado>"   # lista los comentarios que ACTUALMENTE se muestran

2. Seleccionar comentarios y escribir objetivos

Elige comentarios largos, con una perspectiva única y muchos likes; conserva al menos un punto de vista contrario. Escribe shot/targets.json:

[{"key": "card01", "needle": "fragmento de texto distintivo", "blurName": false,
  "hideMedia": true, "url": null}]
  • needle — fragmento de texto lo suficientemente distintivo para encontrar el bloque correcto.
  • url — Threads: null = captura en la página original (conserva el número de likes), o enlace permanente separado (el texto es más grande pero se pierden los likes). Para tarjetas con números impresionantes, usa null.
  • blurName — difumina el nombre; consulta la sección Privacidad.
  • hideMedia — oculta imágenes adjuntas para que la tarjeta no sea demasiado alta.
  • Facebook añade kind: "post" para la publicación, "comment" para el comentario; keepBackground: true si la publicación es un fondo degradado con texto blanco.

3. Capturar y preparar las tarjetas

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 "<archivo guardado>" shot/targets.json shot/raw

python $SK/scripts/prep_shots.py shot/raw <proj>/cards   # redondea esquinas, añade sombra, limita la altura

SHOT_ZOOM amplía el diseño antes de la captura para que el texto sea más grande al ajustarlo al marco vertical: 1.6 para Threads, 1.9 para Facebook. Siempre revisa las imágenes (Read el archivo PNG) antes de renderizar.

4. Escribir content.json y luego renderizar

python $SK/scripts/new_project.py <proj> 8     # crea el marco content.json
cd <proj>
python $SK/scripts/phien_am.py content.json   # transcripción fonética de términos en inglés
python $SK/scripts/tts.py
python $SK/scripts/build_bg.py
python $SK/scripts/build_final.py              # -> output/video-hoan-chinh.mp4

content.json: cada tarjeta tiene speak = texto a narrar. El número de tarjetas debe coincidir con el número de imágenes en cards/.

Variables de entorno: BG_DIR (conjunto de fondos: assets/bg/nature o assets/bg/city), MUSIC (archivo de música), PAD (pausa después de cada frase, por defecto 0.9s).

Reglas de contenido

  • Leer el texto original. No agregues frases introductorias como "Otra persona dijo que…". Solo expande abreviaturas para que la máquina las lea correctamente: sx→sản xuất (producción), 15tr→mười lăm triệu (quince millones), b→bạn (tú), ko→không (no), đc→được (puede), cmt→comment (comentario), frs→freeship (envío gratis).
  • Transcripción fonética de términos en inglés — obligatorio, ejecutar antes de la grabación de voz. edge-tts lee palabras en inglés como si deletreara en vietnamita, lo que suena muy incorrecto (KOC, KOL, follower…):
    python $SK/scripts/phien_am.py <proj>/content.json          # corrige en el lugar
    python $SK/scripts/phien_am.py <proj>/content.json --check  # solo revisar
    
    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"… Si encuentras una palabra nueva no incluida, agrégala a PHIEN_AM en el script. Solo se aplica a speak; la imagen capturada conserva el texto original.
  • No inventes. No agregues likes falsos ni comentarios inexistentes.
  • Comienza con el comentario más impactante (con muchos likes o una historia fuerte), termina con una frase que deje una impresión duradera o un punto de vista contrario.
  • Si un comentario largo fue dividido por la plataforma en varios fragmentos, únelos para que sean fluidos.

Privacidad

Difumina los nombres reales (Sơn Ngọc Trần, Truong Chi Cong…). Conserva los apodos generados automáticamente (ProductivePersimmon7745, hdtshop.vn, sontap88…) porque ya son anónimos. Establece blurName: true para la tarjeta que necesites difuminar; el script difumina tanto el nombre como el avatar.

Duración

Aproximadamente 1 minuto 30 segundos a 2 minutos es lo ideal. Estimación: ~14 palabras en vietnamita ≈ 1 segundo de lectura (velocidad +18%). Si es demasiado largo, reduce el número de tarjetas, no disminuyas la velocidad de lectura.

Música

Por defecto, usa música de Mixkit en assets/music (sin letra, apta para uso comercial, sin necesidad de atribución). Si quieres usar música de tendencia de TikTok, establece MUSIC=<archivo> — pero esa música tiene derechos de autor: publicar en TikTok generalmente no es un problema porque TikTok tiene licencia, mientras que en YouTube/Facebook es mejor publicar la versión sin música y luego agregar la música desde la aplicación.

Primera ejecución en una máquina nueva

python $SK/scripts/fetch_assets.py    # descarga clips de fondo y música de Mixkit

Necesitas tener instalados: ffmpeg, yt-dlp, node + puppeteer-core, Chrome, Python con Pillow, edge-tts. Voces: vi-VN-HoaiMyNeural (femenina, para la frase de apertura y cierre) y vi-VN-NamMinhNeural (masculina, para los comentarios) — se configuran en scripts/tts.py.

Cuando las capturas de pantalla salen mal

Consulta references/troubleshooting.md — contiene una lista completa de los problemas comunes de Facebook y Threads (copias ocultas del DOM, áreas de desplazamiento separadas, ventanas emergentes que bloquean, modo oscuro) junto con las soluciones ya implementadas.

Individual skills in this repo

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

Skills relacionados