Communitygithub.com

Annie-246/tabcom-skills

將 Threads 或 Facebook 上的問答文章轉換為 9:16 直式 TikTok 風格影片——真實截取文章與留言內容,搭配風景背景、越南語語音朗讀與背景音樂。

tabcom-skills 是什麼?

此技能能將 Threads 或 Facebook 上的公開問答文章自動轉換為 9:16 直式短影片(適合 TikTok/Reels)。它會使用 Chrome 真實截取文章與留言的螢幕截圖(包含頭像、名稱、愛心數等完整資訊),再將這些卡片以極慢速度向上滾動,疊加在經暗化處理的風景背景影片上,並以越南語語音(edge-tts)逐字朗讀留言內容,同時背景音樂會在語音播放時自動降低音量。整個流程完全免費:截圖仰賴 Chrome Puppeteer、語音使用 edge-tts、背景與音樂取自 Mixkit 免版稅素材庫。支援兩大平台:Threads 可直接透過 API 或模擬瀏覽器取得公開內容;Facebook 則需使用者手動儲存完整頁面(Ctrl+S 完整網頁),再由工具解析。技能內建隱私保護機制,可自動模糊化真實姓名與頭像,保留暱稱;同時提供英文字詞越語拼音轉換功能,確保語音朗讀正確(如 "KOC" 讀作 "cây âu xi")。適用場景包括:使用者提供社群連結並要求「製作影片」、「將這篇文章做成 TikTok」、「截取留言做成影片」等。

相容平台✓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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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ý.

Individual skills in this repo

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

相關技能