ClawHub

Douyin DL

Other

Download Douyin (抖音) short videos from URLs. Supports direct video links, search page links with modal_id, share links (v.douyin.com), and note links. Uses headless browser to bypass anti-scraping and extract video source. Use when asked to "download douyin video", "下载抖音视频", "save douyin clip", or given any douyin.com URL to download.

Install

openclaw skills install douyin-dl

Douyin Video Downloader

Downloads Douyin videos by opening the page in a headless browser, extracting the <video> source URL, and downloading via curl. This bypasses yt-dlp's cookie issues with Douyin's anti-scraping.

Prerequisites

  • agent-browser (npm i -g agent-browser)
  • curl

Usage

python3 scripts/douyin_download.py <URL> [--output-dir DIR] [--filename NAME]

Supported URL Formats

  • https://www.douyin.com/video/<id> — direct video page
  • https://www.douyin.com/search/...?modal_id=<id> — search results with video modal
  • https://v.douyin.com/<code> — share short links
  • https://www.douyin.com/note/<id> — note/image posts with video

Examples

# Basic download to ~/Downloads
python3 scripts/douyin_download.py 'https://www.douyin.com/video/7577715519366576522'

# Custom output directory and filename
python3 scripts/douyin_download.py 'https://www.douyin.com/video/7577715519366576522' \
  -o ~/Videos -f my_video

# From search page URL
python3 scripts/douyin_download.py 'https://www.douyin.com/search/关键词?modal_id=7577715519366576522'

How It Works

  1. Normalize URL → extract video ID, construct direct video page URL
  2. Open page in agent-browser (headless Chromium)
  3. Extract <video> element's currentSrc (CDN direct link)
  4. Close browser
  5. Download MP4 via curl with proper Referer header

Notes

  • No login required — fresh browser session is sufficient
  • Video title auto-detected from page title for filename
  • Large videos may take 30-60s to download depending on network
  • CDN links are temporary (~2h validity); download promptly after extraction