douyin

xiaoyiv/douyin-skill

Download Douyin videos and extract metadata from short links and full URLs.

What is douyin?

This skill enables downloading videos from Douyin (抖音) and retrieving video metadata such as title, author, and statistics. Use it when you need to save Douyin videos locally or gather information about specific video content.

Download Douyin videos from short links (v.douyin.com) and full URLs
Extract video metadata including title, author, and view statistics
Retrieve video information without downloading the full file
Specify custom output directories for downloaded videos
Support interactive browser-based authentication

How to install douyin

npx skills add https://github.com/xiaoyiv/douyin-skill --skill douyin

Prerequisites

Python environment with nodriver_kit installed
One-time interactive login to Douyin account via browser automation

Claude Code

Cursor

Windsurf

Cline

How to use douyin

1.Run the one-time setup: python -m nodriver_kit.tools.login_interactive --url https://www.douyin.com --profile douyin
2.To download a video, run: python scripts/download.py "<douyin_url>"
3.To get video info only without downloading, add the --info-only flag
4.To save to a custom directory, use: python scripts/download.py "<douyin_url>" --output ./your_folder

Use cases

Good for

Download a Douyin video shared via short link for offline viewing
Get video title and author information from a Douyin URL
Batch retrieve metadata from multiple Douyin videos
Save videos to a specific folder for content organization
Verify video details before deciding to download

Who it's for

Content creators working with Douyin videos
Researchers analyzing Douyin video metadata
Users archiving Douyin content
Developers building Douyin-integrated applications

douyin FAQ

What URL formats does this skill support?

It supports both short links (v.douyin.com) and full Douyin URLs.

Do I need to log in?

Yes, one-time interactive browser-based login is required during setup.

Can I get video information without downloading?

Yes, use the --info-only flag to retrieve metadata only.

Where are downloaded videos saved by default?

Videos are saved to the current directory unless you specify a custom output path with --output.

Full instructions (SKILL.md)

Source of truth, from xiaoyiv/douyin-skill.

name: douyin description: "Download Douyin (抖音) videos. Use when user wants to: (1) download Douyin videos, (2) get video info (title, author, stats). Supports short links (v.douyin.com) and full URLs."

Douyin Skill

Download videos from Douyin using browser automation.

Setup (One-Time)

python -m nodriver_kit.tools.login_interactive --url https://www.douyin.com --profile douyin

Download Video

python scripts/download.py "https://v.douyin.com/xxx"
python scripts/download.py "https://v.douyin.com/xxx" --info-only
python scripts/download.py "https://v.douyin.com/xxx" --output ./videos