douyin-video▌
yzfly/douyin-mcp-server · updated May 14, 2026
MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.
Douyin watermark-free video downloader with automatic speech-to-text transcription and file export.
- ›Parses Douyin share links to extract direct download URLs for watermark-free videos without requiring API keys
- ›Downloads videos locally and extracts speech content via SiliconFlow's SenseVoice API, automatically saving transcripts as Markdown files organized by video ID
- ›Supports three action modes: info retrieval, video download, and text extraction with optional concurrent video savin
抖音无水印视频下载和文案提取
从抖音分享链接获取无水印视频下载链接, 下载视频, 并使用语音识别提取视频中的文案, 自动保存到文件.
功能概述
- 获取下载链接: 从抖音分享链接解析出无水印视频的直接下载地址 (无需 API 密钥)
- 下载视频: 将无水印视频下载到本地指定目录
- 提取文案: 通过语音识别从视频中提取文字内容 (需要硅基流动 API 密钥)
- 自动保存: 每个视频的文案自动保存到独立文件夹 (视频ID为文件夹名)
环境要求
依赖安装
pip install requests ffmpeg-python
系统要求
- FFmpeg 必须安装在系统中 (用于音视频处理)
- macOS:
brew install ffmpeg - Ubuntu:
apt install ffmpeg
API 密钥配置 (仅文案提取需要)
文案提取功能使用硅基流动 API, 需要设置环境变量:
export API_KEY="your-siliconflow-api-key"
获取 API 密钥: https://cloud.siliconflow.cn/
使用方法
方法一: 使用脚本 (推荐)
# 获取视频信息和下载链接 (无需 API 密钥)
python douyin_downloader.py --link "抖音分享链接" --action info
# 下载视频到指定目录
python douyin_downloader.py --link "抖音分享链接" --action download --output ./videos
# 提取视频文案并保存到文件 (需要 API_KEY 环境变量)
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output
# 提取文案并同时保存视频
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output --save-video
# 安静模式 (减少输出)
python douyin_downloader.py --link "抖音分享链接" --action extract --output ./output --quiet
输出目录结构
提取文案后, 每个视频会保存到独立文件夹:
output/
├── 7600361826030865707/ # 视频ID为文件夹名
│ └── transcript.md # Markdown 格式文案文件
├── 7581044356631612699/
│ ├── transcript.md
│ └── 7581044356631612699.mp4 # 使用 --save-video 时保存
└── ...
Markdown 文案格式
# 视频标题
| 属性 | 值 |
|------|-----|
| 视频ID | `7600361826030865707` |
| 提取时间 | 2026-01-30 14:19:00 |
| 下载链接 | [点击下载](url) |
---
## 文案内容
(语音识别的文字内容)
方法二: 在 Python 代码中调用
from douyin_downloader import get_video_info, download_video, extract_text
# 获取视频信息
info = get_video_info("抖音分享链接")
print(f"视频ID: {info['video_id']}")
print(f"标题: {info['title']}")
print(f"下载链接: {info['url']}")
# 下载视频
video_path = download_video("抖音分享链接", output_dir="./videos")
# 提取文案并保存到文件
result = extract_text("抖音分享链接", output_dir="./output")
print(f"文案已保存到: {result['output_path']}")
print(result['text'])
工作流程
获取视频信息
- 解析抖音分享链接, 提取真实的视频 URL
- 模拟移动端请求获取页面数据
- 从页面 JSON 数据中提取无水印视频地址
- 返回视频 ID, 标题和下载链接
提取视频文案
- 解析分享链接获取视频信息
- 下载视频到临时目录
- 使用 FFmpeg 从视频中提取音频 (MP3 格式)
- 调用硅基流动 SenseVoice API 进行语音识别
- 清理临时文件, 返回识别的文本
常见问题
无法解析链接
- 确保链接是有效的抖音分享链接
- 链接格式通常为
https://v.douyin.com/xxxxx/或完整的抖音视频 URL
提取文案失败
- 检查
API_KEY环境变量是否已设置 - 确保 API 密钥有效且有足够的配额
- 确保 FFmpeg 已正确安装
下载速度慢
- 这取决于网络条件和视频大小
- 脚本会显示下载进度
注意事项
- 本工具仅供学习和研究使用
- 使用时需遵守相关法律法规
- 请勿用于任何侵犯版权或违法的目的
How to use douyin-video on Cursor
AI-first code editor with Composer
Prerequisites
Before installing skills in Cursor, ensure your development environment meets these requirements:
- ›Cursor installed and configured on your development machine
- ›Node.js version 16.0+ with npm package manager (verify with
node --version) - ›Active project directory or workspace where you want to add douyin-video
Execute installation command
Execute the skills CLI command in your project's root directory to begin installation:
The skills CLI fetches douyin-video from GitHub repository yzfly/douyin-mcp-server and configures it for Cursor.
Select Cursor when prompted
The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:
Verify installation
Confirm successful installation by checking the skill directory location:
Reload or restart Cursor to activate douyin-video. Access the skill through slash commands (e.g., /douyin-video) or your agent's skill management interface.
Security & Verification Notice
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.
List & Monetize Your Skill
Submit your Claude Code skill and start earning
Use Cases▌
Task Automation & Efficiency
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Knowledge Enhancement
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Quality Improvement
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
Implementation Guide▌
Prerequisites
- ›Claude Desktop or compatible AI client with skill support
- ›Clear understanding of task or problem to solve
- ›Willingness to iterate and refine outputs
Time Estimate
15-45 minutes depending on use case complexity
Installation Steps
- 1.Install skill using provided installation command
- 2.Test with simple use case relevant to your work
- 3.Evaluate output quality and relevance
- 4.Iterate on prompts to improve results
- 5.Integrate into regular workflow if valuable
Common Pitfalls
- ⚠Expecting perfect results without iteration
- ⚠Not providing enough context in prompts
- ⚠Using skill for tasks outside its intended scope
- ⚠Accepting outputs without review and validation
Best Practices▌
✓ Do
- +Start with clear, specific prompts
- +Provide relevant context and constraints
- +Review and refine all outputs before using
- +Iterate to improve output quality
- +Document successful prompt patterns
✗ Don't
- −Don't use without understanding skill limitations
- −Don't skip validation of outputs
- −Don't share sensitive information in prompts
- −Don't expect skill to replace human judgment
💡 Pro Tips
- ★Be specific about desired format and style
- ★Ask for multiple options to choose from
- ★Request explanations to understand reasoning
- ★Combine AI efficiency with human expertise
When to Use This▌
✓ Use When
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid When
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
Learning Path▌
- 1Familiarize yourself with skill capabilities and limitations
- 2Start with low-risk, non-critical tasks
- 3Progress to more complex and valuable use cases
- 4Build expertise through regular use and experimentation
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.4★★★★★72 reviews- ★★★★★Ishan Liu· Dec 28, 2024
We added douyin-video from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Liam Ramirez· Dec 28, 2024
Solid pick for teams standardizing on skills: douyin-video is focused, and the summary matches what you get after install.
- ★★★★★Kabir Park· Dec 24, 2024
douyin-video reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Chinedu Ndlovu· Dec 16, 2024
douyin-video has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Olivia Jain· Dec 8, 2024
douyin-video fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Chinedu Bansal· Dec 8, 2024
Useful defaults in douyin-video — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
- ★★★★★Hiroshi Zhang· Dec 4, 2024
We added douyin-video from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Kaira Kapoor· Nov 27, 2024
Registry listing for douyin-video matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Kabir Mensah· Nov 27, 2024
douyin-video is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
- ★★★★★Chinedu Malhotra· Nov 23, 2024
Solid pick for teams standardizing on skills: douyin-video is focused, and the summary matches what you get after install.
showing 1-10 of 72