name: "douyin-download" description: "抖音影片下載工具。當用戶要求下載抖音（豆包）短影片時使用此 skill。支援短連結（如 v.douyin.com/xxx）和完整影片頁面連結，自動解析並下載到本地。下載影片為 720p 帶水印版本。" agent_created: true

douyin-download

Download Douyin (TikTok China) videos to local disk without needing yt-dlp, cookies, or login.

Workflow

Execute all steps in order.

Step 1 — Resolve Short URL

If the URL is a short link (v.douyin.com/xxx), resolve it first:

curl -sI "https://v.douyin.com/<ID>/" | grep -i location

Extract the full URL from the location: header. The numeric ID in /video/<ID>/ is the video_id_str (e.g. 7634389140783615232).

7w4.net提供免費和付費技能下載。

Step 2 — Fetch Mobile Page & Extract video_id

Fetch the mobile Douyin page and extract the internal video_id:

curl -sL "https://www.iesdouyin.com/share/video/<video_id_str>/" \
  -H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15" \
  -H "Referer: https://www.douyin.com/" \
  -o /tmp/dy_page.html

Extract video_id from the HTML:

grep -o 'video_id[^"]*"[^"]*"' /tmp/dy_page.html

This returns something like video_id=v0d00fg10000d7pc7dvog65j2bpvg940. The part after = is the internal_video_id.

Step 3 — Download Video

Construct the snssdk play URL and download:

curl -L "https://aweme.snssdk.com/aweme/v1/playwm/?video_id=<internal_video_id>&ratio=720p&line=0" \
  -H "User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15" \
  -H "Referer: https://www.douyin.com/" \
  -o ~/Downloads/<output_filename>.mp4

• playwm = 720p with Douyin watermark
• To get no-watermark version: replace playwm with play and append &watermark=0 (may need additional signature handling)
• Save to ~/Downloads/ using the video title as filename

Step 4 — Verify

Check file size and format:

ls -lh ~/Downloads/<output_filename>.mp4 && file ~/Downloads/<output_filename>.mp4

Key Notes

• No login required — the mobile endpoint (iesdouyin.com) works without authentication
• Download speed — typically reaches 10–15 MB/s on stable connections; a 100MB video finishes in ~10 seconds
• If download fails with 403/redirect: retry with a fresh curl -L (follow redirects) and verify the video_id is correct
• Watermark — playwm always includes Douyin watermark; getting no-watermark requires the play endpoint with signed parameters (complex, not covered here)
• Supported URLs: v.douyin.com/xxx short links and www.iesdouyin.com/share/video/<ID>/ direct links

Reference

See references/douyin_api.md for detailed endpoint documentation and troubleshooting.

這是一款實用的抖音下載工具，無需登入即可下載 720p 影片，速度快且操作簡單。文件說明詳細，中英文兼備，常見問題解答到位。不足之處在於只能下載帶水印版本，且實際使用時需要 AI 按步驟執行，不如專用下載軟體方便快捷。整體而言質量良好，適合有下載抖音影片需求的使用者使用。