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.

$npx skills add https://github.com/yzfly/douyin-mcp-server --skill douyin-video
0 commentsdiscussion
summary

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
skill.md

抖音无水印视频下载和文案提取

从抖音分享链接获取无水印视频下载链接, 下载视频, 并使用语音识别提取视频中的文案, 自动保存到文件.

功能概述

  • 获取下载链接: 从抖音分享链接解析出无水印视频的直接下载地址 (无需 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'])

工作流程

获取视频信息

  1. 解析抖音分享链接, 提取真实的视频 URL
  2. 模拟移动端请求获取页面数据
  3. 从页面 JSON 数据中提取无水印视频地址
  4. 返回视频 ID, 标题和下载链接

提取视频文案

  1. 解析分享链接获取视频信息
  2. 下载视频到临时目录
  3. 使用 FFmpeg 从视频中提取音频 (MP3 格式)
  4. 调用硅基流动 SenseVoice API 进行语音识别
  5. 清理临时文件, 返回识别的文本

常见问题

无法解析链接

  • 确保链接是有效的抖音分享链接
  • 链接格式通常为 https://v.douyin.com/xxxxx/ 或完整的抖音视频 URL

提取文案失败

  • 检查 API_KEY 环境变量是否已设置
  • 确保 API 密钥有效且有足够的配额
  • 确保 FFmpeg 已正确安装

下载速度慢

  • 这取决于网络条件和视频大小
  • 脚本会显示下载进度

注意事项

  • 本工具仅供学习和研究使用
  • 使用时需遵守相关法律法规
  • 请勿用于任何侵犯版权或违法的目的
how to use douyin-video

How to use douyin-video on Cursor

AI-first code editor with Composer

1

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
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/yzfly/douyin-mcp-server --skill douyin-video

The skills CLI fetches douyin-video from GitHub repository yzfly/douyin-mcp-server and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/douyin-video

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

GET_STARTED →

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. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 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

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.472 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

1 / 8