Annie-246/tabcom-skills

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

Dựng video dọc 1080×1920: ảnh chụp thật của bài đăng và bình luận (giữ nguyên avatar, tên, icon like, số lượt thích) đặt giữa khung, trôi lên rất chậm trên nền phong cảnh làm tối; giọng đọc tiếng Việt đọc nguyên văn; nhạc nền tự hạ xuống khi có giọng.

Toàn bộ miễn phí: ảnh chụp bằng Chrome, giọng bằng edge-tts, nền và nhạc từ Mixkit.

Quy trình

Đặt SK=${CLAUDE_SKILL_DIR} (thư mục của skill này; cài thủ công thì là ~/.claude/skills/social-qa-video). Mỗi video là một thư mục project riêng.

1. Lấy nội dung

Threads (bài công khai — chụp thẳng từ web, không cần đăng nhập):

node $SK/scripts/threads_dump.js "<url>" shot/threads.json       # ~13 khối đầu
node $SK/scripts/threads_links.js "<url>" shot/threads_all.json  # sâu hơn: mở permalink từng reply
python $SK/scripts/threads_filter.py                              # lọc bỏ spam, giữ reply đúng bài

threads_dump nhanh nhưng Threads chỉ cho khách xem ~13 khối. threads_links mở permalink của từng bình luận nên gom được nhiều hơn hẳn (một bài 424 reply lấy ra được 53 cái thật).

Facebook (phải đăng nhập → nhờ người dùng lưu trang):

Mở bài bằng link trực tiếp dạng /posts/<id>/ (đừng lưu từ News Feed), bung hết "Xem thêm bình luận" / "Xem thêm", cuộn lên lại đầu bài, rồi Ctrl+S → "Trang web, hoàn chỉnh" hoặc .mhtml.

node $SK/scripts/fb_list.js "<file đã lưu>"   # liệt kê bình luận ĐANG hiển thị thật

2. Chọn bình luận & viết targets

Chọn bình luận dài, có góc nhìn riêng, lượt like cao; giữ ít nhất một góc phản biện. Viết shot/targets.json:

[{"key": "card01", "needle": "đoạn text đặc trưng", "blurName": false,
  "hideMedia": true, "url": null}]

• needle — mẩu chữ đủ đặc trưng để tìm đúng khối
• url — Threads: null = chụp ở trang gốc (giữ được số like), hoặc permalink riêng (chữ to hơn nhưng mất số like). Cho các card có số ấn tượng thì để null.
• blurName — làm mờ tên; xem mục Riêng tư
• hideMedia — ẩn ảnh đính kèm cho card khỏi quá cao
• Facebook thêm kind: "post" cho bài đăng, "comment" cho bình luận; keepBackground: true nếu bài đăng là nền gradient chữ trắng

3. Chụp và chuẩn bị card

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 "<file đã lưu>" shot/targets.json shot/raw

python $SK/scripts/prep_shots.py shot/raw <proj>/cards   # bo góc, đổ bóng, giới hạn cao

SHOT_ZOOM phóng layout trước khi chụp để chữ to hơn khi thu vào khung dọc: 1.6 cho Threads, 1.9 cho Facebook. Luôn xem lại ảnh (Read file PNG) trước khi render.

4. Viết content.json rồi render

python $SK/scripts/new_project.py <proj> 8     # tạo khung content.json
cd <proj>
python $SK/scripts/phien_am.py content.json   # phiên âm từ tiếng Anh
python $SK/scripts/tts.py
python $SK/scripts/build_bg.py
python $SK/scripts/build_final.py              # -> output/video-hoan-chinh.mp4

content.json: mỗi card có speak = lời đọc. Số card phải khớp số ảnh trong cards/.

Biến môi trường: BG_DIR (bộ nền: assets/bg/nature hoặc assets/bg/city), MUSIC (file nhạc), PAD (đệm sau mỗi câu, mặc định 0.9s).

Quy tắc nội dung

• Đọc nguyên văn. Không thêm câu dẫn kiểu "Một người khác nói rằng…". Chỉ mở rộng viết tắt để máy đọc đúng: sx→sản xuất, 15tr→mười lăm triệu, b→bạn, ko→không, đc→được, cmt→comment, frs→freeship.
• Phiên âm từ tiếng Anh — bắt buộc, chạy trước khi thu giọng. edge-tts đọc từ tiếng Anh theo kiểu đánh vần tiếng Việt nghe rất sai (KOC, KOL, follower…):

  python $SK/scripts/phien_am.py <proj>/content.json          # sửa tại chỗ
  python $SK/scripts/phien_am.py <proj>/content.json --check  # chỉ xem
  

  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"… Gặp từ mới chưa có thì thêm vào PHIEN_AM trong script. Chỉ áp cho speak; ảnh chụp giữ nguyên chữ gốc.
• Không bịa. Không thêm số like giả, không thêm bình luận không có thật.
• Mở đầu bằng bình luận đắt nhất (like cao hoặc câu chuyện mạnh), kết bằng câu để lại dư âm hoặc một góc nhìn ngược.
• Một bình luận dài bị nền tảng cắt làm nhiều mảnh thì ghép lại cho liền mạch.

Riêng tư

Làm mờ tên thật (Sơn Ngọc Trần, Truong Chi Cong…). Giữ nguyên nickname tự sinh (ProductivePersimmon7745, hdtshop.vn, sontap88…) vì vốn đã ẩn danh. Đặt blurName: true cho card cần mờ — script làm mờ cả tên lẫn avatar.

Độ dài

Khoảng 1 phút 30 – 2 phút là vừa. Ước lượng: ~14 chữ tiếng Việt ≈ 1 giây đọc (tốc độ +18%). Dài quá thì bớt card, đừng đọc chậm lại.

Nhạc

Mặc định lấy nhạc Mixkit trong assets/music (không lời, dùng thương mại được, không cần ghi công). Muốn dùng nhạc trending của TikTok thì đặt MUSIC=<file> — nhưng đó là nhạc có bản quyền: đăng TikTok thường không sao vì TikTok có license, còn YouTube/Facebook thì nên đăng bản không nhạc rồi thêm nhạc trong app.

Lần đầu chạy trên máy mới

python $SK/scripts/fetch_assets.py    # tải clip nền + nhạc Mixkit

Cần sẵn: ffmpeg, yt-dlp, node + puppeteer-core, Chrome, Python có Pillow, edge-tts. Giọng: vi-VN-HoaiMyNeural (nữ, câu mở và câu kết) và vi-VN-NamMinhNeural (nam, các bình luận) — sửa trong scripts/tts.py.

Khi ảnh chụp ra sai

Đọc references/troubleshooting.md — chép lại đầy đủ các bẫy của Facebook và Threads (bản sao DOM ẩn, vùng cuộn riêng, popup che, chế độ tối) kèm cách đã xử lý.