version: "1.0.0" name: douyin-video-to-report description: "抖音影片連結 → 完整圖文報告。自動完成：繞過驗證抓取影片 → 下載 → 音訊提取 → 語音轉文字 → 炫酷HTML報告 → 飛書傳送。觸發詞：抖音影片總結、抖音影片分析、這個影片說了什麼、總結這個影片" override-tools: - douyin_report

本技能來自小蔥技能站7w4.net。

Douyin Video → Report Pipeline

將抖音影片連結自動轉換為可閱讀的 HTML 報告，適合需要提煉影片內容的場景。

完整工作流程

抖音短鏈 (v.douyin.com/xxx)
    │
    ▼
1. Playwright (headless Chrome)
   - 繞過 JS 驗證 / 滑動驗證碼
   - 提取影片直鏈
    │
    ▼
2. curl 下載影片 (.mp4)
    │
    ▼
3. ffmpeg 提取音訊 (.mp3)
    │
    ▼
4. miaoda-studio-cli speech-to-text
   - 中文普通話識別
   - 100% 轉錄
    │
    ▼
5. 生成炫酷 HTML 報告
   - 深色漸變主題
   - 核心資料卡片
   - 洞察總結
   - 完整轉錄（可展開）
   - Ctrl+P 可列印成 PDF
    │
    ▼
6. 飛書附件傳送給使用者

核心指令碼

指令碼位於：/home/gem/workspace/agent/skills/douyin-video-to-report/douyin_pipeline.py

使用方式

# 方式一：直接執行（傳入抖音URL）
python3 /home/gem/workspace/agent/skills/douyin-video-to-report/douyin_pipeline.py "https://v.douyin.com/xxxxx"

# 方式二：分步執行（見下方分步說明）

分步執行命令

Step 1：提取影片直鏈

# douyin_fetch.py - Playwright 提取影片 URL
import asyncio
from playwright.async_api import async_playwright

async def get_video_url(douyin_url):
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=True, args=[
            '--no-sandbox', '--disable-setuid-sandbox',
            '--disable-blink-features=AutomationControlled',
        ])
        context = await browser.new_context(
            user_agent='Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1',
            viewport={'width': 390, 'height': 844},
            locale='zh-CN',
        )
        page = await context.new_page()
        await page.goto(douyin_url, timeout=30000, wait_until="networkidle")
        await asyncio.sleep(3)
        # 從 video 元素獲取直鏈
        video_info = await page.evaluate("""
            () => {
                const v = document.querySelector('video');
                if (v && v.src) return v.src;
                return null;
            }
        """)
        await browser.close()
        return video_info

Step 2：下載影片

curl -L -o /tmp/douyin_video.mp4 "影片直鏈" \
  -H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1" \
  --max-time 60 -s

Step 3：提取音訊

ffmpeg -i /tmp/douyin_video.mp4 -vn -acodec libmp3lame -q:a 2 /tmp/douyin_audio.mp3 -y

Step 4：語音轉文字

miaoda-studio-cli speech-to-text --file /tmp/douyin_audio.mp3 --lang zh --output text

Step 5：生成報告

使用 miaoda_coding 或直接使用 report_generator.py（見下方）

依賴環境

關鍵經驗

1. 必須用 Playwright headless Chrome，不能用 requests/httpx，抖音會攔截
2. 移動端 UA 更容易繞過，用 iPhone UA 而非桌面 Chrome
3. 影片直鏈從 document.querySelector('video').src 獲取，不要從 network 請求裡找
4. 下載影片時必須加 User-Agent header，否則 403
5. 飛書附件傳送：檔案必須放在 /home/gem/workspace/agent/workspace/ 或 /tmp/openclaw/ 目錄

報告模板結構

• Hero：標題 + 影片元資訊
• 資料卡片：關鍵數字高亮
• 洞察區：6個核心發現卡片
• 對比表：進門 vs 留存因素
• 案例區：引用高亮
• 行動指南：5項建議
• 完整轉錄：可展開/收起

相關工具

• miaoda-studio-cli speech-to-text：音訊轉文字
• miaoda-studio-cli doc-parse：文件解析
• miaoda-coding：生成視覺化報告

這個 Skill 功能完整，能將抖音影片自動轉化為可閱讀的報告，處理流程覆蓋抓取、轉錄、生成報告等環節。文件寫得清楚明白，操作步驟有詳細說明，對關鍵技術問題（如繞過驗證、設定請求頭）有明確提示。不足之處是缺少測試驗證，部分路徑寫死不夠靈活，外部工具依賴說明不夠完整。整體質量中等偏上，功能實用，但配置和使用上需要一定技術基礎。