Douyin Video Summary

Douyin Video Summary

Summarize Douyin videos: extract audio → transcribe locally → AI summary.

Prerequisites

Install these tools (macOS example):

brew install whisper-cpp ffmpeg
# Download whisper.cpp GGML model (small recommended for speed/quality balance)
curl -L -o models/ggml-small.bin "https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-small.bin"

Workflow

When a Douyin link is received:

Step 1: Extract Video ID

Parse the Douyin URL to get the video ID. Douyin share links come in two formats:

• Short link: https://v.douyin.com/xxxxx/ → follow redirect to get video ID
• Direct link: https://www.douyin.com/video/7604713801732365681

# Follow redirect to get final URL, extract numeric video ID
curl -sL -o /dev/null -w '%{url_effective}' 'https://v.douyin.com/xxxxx/' | grep -oE '[0-9]{15,}'

Step 2: Get Audio via Browser

Douyin blocks direct downloads (yt-dlp, aria2c all get 403). Use the browser to intercept the audio URL:

1. Open the Douyin video page in the browser 2. Inject JS to intercept network requests before navigation:

window.__audioUrls = [];
const origOpen = XMLHttpRequest.prototype.open;
XMLHttpRequest.prototype.open = function(method, url) {
  if (url && (url.includes('.mp3') || url.includes('.m4a') || url.includes('mime_type=audio'))) {
    window.__audioUrls.push(url);
  }
  return origOpen.apply(this, arguments);
};

3. Navigate to the video page, click play to trigger audio loading 4. Retrieve intercepted URLs: window.__audioUrls 5. Download with curl (Referer header required):

curl -H "Referer: https://www.douyin.com/" -o audio.mp4 "<audio_url>"

Important: aria2c will 403 on Douyin CDN URLs. Always use curl with the Referer header.

Step 3: Convert to WAV

ffmpeg -i audio.mp4 -ar 16000 -ac 1 -c:a pcm_s16le audio.wav

Step 4: Transcribe with whisper.cpp

whisper-cli -m /path/to/ggml-small.bin -l zh -f audio.wav -otxt -of output

• Use -l zh for Chinese content (auto-detect if unsure)
• Apple Silicon GPU acceleration is automatic (Metal)
• Performance: ~20s for 5min audio on M4

Step 5: Generate Summary

Read the transcription text and produce a structured summary:

📹 **[Video Title] | [Author]**
时长：X分X秒 | 发布：YYYY-MM-DD

🎯 **核心观点：[one-line core message]**

**1. [Point 1 title]**
• [detail]
• [detail]

**2. [Point 2 title]**
• [detail]

💬 **一句话总结：[concise takeaway]**

Step 6 (Optional): Sync to Feishu Doc

If Feishu integration is configured, append the summary to a Feishu document using the Feishu Open API. See references/feishu-sync.md for the API details.

Tips

• For short videos (<1min), the summary may be very brief — that's fine
• If browser interception fails, retry once; Douyin pages sometimes need a second load
• Clean up downloaded audio/wav files after processing to save disk space
• whisper.cpp small model is the best speed/quality tradeoff; medium may OOM on 8GB machines

Feishu (Lark) Document Sync

Sync video summaries to a Feishu document using the Open API.

Authentication

Get tenant access token:

curl -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id":"YOUR_APP_ID","app_secret":"YOUR_APP_SECRET"}'

Document Structure

Use heading levels for auto-generated sidebar navigation:

• H1 (block_type: 3): Date category (e.g., "2026-02-09")
• H2 (block_type: 4): Video title (e.g., "大哥的亲子教育 | 童年录播姬")
• Text (block_type: 2): Summary content
• Divider (block_type: 22): Between videos

Append Content

POST to /open-apis/docx/v1/documents/{doc_id}/blocks/{doc_id}/children:

{
  "children": [
    {
      "block_type": 4,
      "heading2": {
        "elements": [{"text_run": {"content": "Video Title | Author"}}]
      }
    },
    {
      "block_type": 2,
      "text": {
        "elements": [{"text_run": {"content": "Summary text", "text_element_style": {"bold": false}}}],
        "style": {"align": 1}
      }
    }
  ],
  "index": -1
}

Delete Blocks

Batch delete by index range:

DELETE /open-apis/docx/v1/documents/{doc_id}/blocks/{doc_id}/children/batch_delete
Body: {"start_index": 0, "end_index": N}

Required Permissions

• docx:document — read/write documents
• drive:drive — manage file permissions (optional, for sharing)

Tips

• Write in batches of 5-8 blocks to avoid API errors
• Add time.sleep(0.8) between batches for rate limiting
• Use document_revision_id: -1 for latest revision when deleting
• Bold text: set "bold": true in text_element_style