Douyin Video Parser MCP Server

Douyin Video Parser MCP Server

MCP Server for parsing Douyin (China TikTok) share links. Extracts watermark-free video URLs, cover images, background music, and video metadata. Also includes TikTok trending retrieval.

Features

• Parse share links: Supports v.douyin.com short links and iesdouyin.com share links
• Watermark-free video: Auto-extracts direct download URL without watermark
• Cover image: Retrieves video cover image URL
• Background music: Extracts background music URL
• Video metadata: Title, author, duration
• TikTok trending: Get global TikTok trending video list

Installation

pip install git+https://github.com/521w/douyin-mcp.git

Or from source:

git clone https://github.com/521w/douyin-mcp.git
cd douyin-mcp
pip install -e .

Usage

Add to your MCP client configuration:

{
  "mcpServers": {
    "douyin": {
      "command": "python3",
      "args": ["-m", "douyin_mcp.server"]
    }
  }
}

Tools

parse_douyin

Input: { "share_url": "https://v.douyin.com/xxxxx/" }

Output:
📝 Title: video title
👤 Author: author name
⏱️ Duration: 1m30s
🖼️ Cover: https://...
🎬 Watermark-free: https://...
🎵 Music: https://...

How It Works

1. Follow short link redirect to get the real share URL
2. Extract video ID using regex
3. Extract dytk token from the share page for API authentication
4. Call Douyin official API to get video metadata
5. Replace playwm with play in video URL to remove watermark

Use Cases

• Content creators batch-downloading video assets
• Short-video data analysis and research
• AI agents needing watermark-free video for remixing

Requirements

• Python >= 3.9
• mcp >= 1.0.0
• requests >= 2.28.0

Disclaimer

This project is for educational use only. Please respect Douyin and TikTok copyright policies. Do not use parsed videos for commercial purposes without authorization.

License

MIT