douyin-downloader

Parse Douyin share links, download watermark-free videos, and transcribe audio via Volcano Engine ASR.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/riipandi/minis-skills --skill douyin-downloader-riipandi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: douyin-downloader
Source: https://github.com/riipandi/minis-skills/tree/main/douyin-downloader
Command: npx skills add https://github.com/riipandi/minis-skills --skill douyin-downloader-riipandi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve? Downloading Douyin videos from share links normally leaves you with watermarked files and no easy way to get the spoken content as text. This Skill parses share text or links, fetches the watermark-free video URL, downloads the MP4, and optionally transcribes the audio using Volcano Engine ASR. ## Core Features & Use Cases - Share Link Parsing: Extracts video ID, title, and a watermark-free download URL from Douyin share text or short links (v.douyin.com), supporting both /video/ and /note/ URLs. - Watermark-Free Download: Converts playwm URLs to play URLs and downloads the video with progress reporting and redirect handling. - Audio Transcription: Sends audio or video files to Volcano Engine ASR (Doubao Speech) in flash or standard mode and returns the recognized text. - Use Case: A user pastes a Douyin share message like "7.43 FuL:/ ... https://v.douyin.com/xxxx/" and receives a clean MP4 saved locally plus a text transcript of the video's speech. ## Quick Start Download this Douyin video without watermark and transcribe its audio: https://v.douyin.com/iFDbjn2M/

Frequently Asked Questions about douyin-downloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download a Douyin video without watermark in Python?

Parse the share link with parse_douyin.py to get the video metadata, which converts the playwm URL to a play URL for the watermark-free version. Then pass that download_url to download_video.py with your desired output path.

How to transcribe Douyin video audio to text?

Run transcribe_audio.py on the downloaded MP4 with your Volcano Engine App Key and Access Key, either as arguments or via VOLC_APP_KEY and VOLC_ACCESS_KEY environment variables. It supports flash mode for quick results or standard mode with polling.

What input formats does the Douyin share parser accept?

The parser accepts full Douyin share text containing a link or just the bare short URL such as https://v.douyin.com/xxxx/. It extracts the first URL from the text, follows the redirect, and supports both /video/ and /note/ page types.

Why does Douyin parsing fail with 'Failed to parse video info from HTML'?

This error means the script could not find window._ROUTER_DATA in the share page HTML, usually because Douyin changed its page structure. The parsing script needs to be updated to match the new page format.

What are the limitations of Volcano Engine ASR transcription?

The transcription script requires valid Volcano Engine credentials and limits input files to 100MB. Standard mode polls for results with a default timeout of 120 seconds, after which it returns a timeout error.