MCPHub Lab
MCPHub LabRegistrydouyin-mcp-server
yzfly

douyin mcp server

Built by yzfly • 831 stars

Visit Repository

What is douyin mcp server?

提取抖音无水印视频链接，视频文案，douyin-mcp-server，mcp，claude skill，支持龙虾

How to use douyin mcp server?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add douyin mcp server using the following command: npx @modelcontextprotocol/douyin-mcp-server 4. Restart the client and verify the new tools are active.
🛡️ Scoped (Restricted)
npx @modelcontextprotocol/douyin-mcp-server --scope restricted
🔓 Unrestricted Access
npx @modelcontextprotocol/douyin-mcp-server

Key Features

Native MCP Protocol Support
Real-time Tool Activation & Execution
Verified High-performance Implementation
Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities
Automating system workflows via natural language
Connecting external data sources to LLM context windows

douyin mcp server FAQ

Q

Is douyin mcp server safe?

Yes, douyin mcp server follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Q

Is douyin mcp server up to date?

douyin mcp server is currently active in the registry with 831 stars on GitHub, indicating its reliability and community support.

Q

Are there any limits for douyin mcp server?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub

短视频文案提取器

PyPI version Python version License

从短视频分享链接下载无水印视频，AI 自动提取语音文案。

WebUI 界面预览

<a href="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server/badge" alt="douyin-mcp-server MCP server" /> </a>

✨ 功能特性

  • 🎬 无水印视频 - 获取高质量无水印视频下载链接
  • 🎙️ AI 语音识别 - 使用硅基流动 SenseVoice 自动提取文案
  • 📑 大文件支持 - 自动分段处理超过 1 小时或 50MB 的音频
  • 🌐 WebUI - 现代化浏览器界面，无需命令行
  • 🔌 MCP 集成 - 支持 Claude Desktop 等 AI 应用

📦 使用方式

方式适用场景特点
WebUI普通用户浏览器操作，最简单
MCP ServerClaude Desktop 用户AI 对话中直接调用
命令行开发者批量处理，脚本集成

🌐 WebUI (推荐)

最简单的使用方式，打开浏览器即可使用。

快速开始

# 1. 克隆项目
git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server

# 2. 安装依赖
uv sync

# 3. 启动服务
uv run python web/app.py

打开浏览器访问 http://localhost:8080

配置 API Key

有两种方式配置 API Key：

方式一：浏览器内配置（推荐）

  1. 打开 WebUI 页面
  2. 点击顶部的「API 未配置」按钮
  3. 在弹窗中输入 API Key 并保存
  4. API Key 保存在浏览器本地，刷新页面后仍有效

方式二：环境变量

export API_KEY="sk-xxxxxxxxxxxxxxxx"
uv run python web/app.py

💡 获取免费 API Key：硅基流动（新用户有免费额度）

功能说明

操作说明需要 API
获取信息解析视频标题、ID，获取无水印下载链接❌
提取文案下载视频 → 提取音频 → AI 语音识别✅
下载视频点击下载链接保存无水印视频❌
复制/下载文案一键复制或下载 Markdown 格式文案-

使用步骤

  1. 粘贴链接 - 将分享链接粘贴到输入框
  2. 点击按钮 - 选择「获取信息」或「提取文案」
  3. 查看结果 - 右侧显示视频信息和提取的文案
  4. 导出 - 复制文案或下载 Markdown 文件

🚀 MCP Server

在 Claude Desktop、Cherry Studio 等支持 MCP 的应用中使用。

配置方法

编辑 MCP 配置文件，添加：

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "API_KEY": "sk-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

可用工具

工具名功能需要 API
parse_douyin_video_info解析视频信息❌
get_douyin_download_link获取下载链接❌
extract_douyin_text提取视频文案✅

对话示例

用户：帮我提取这个视频的文案 https://v.douyin.com/xxxxx/

Claude：我来帮你提取视频文案...
[调用 extract_douyin_text 工具]
提取完成，文案内容如下：
...

🛠️ 命令行工具

适合开发者和批量处理场景。

安装

git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
uv sync

命令说明

# 查看帮助
uv run python douyin-video/scripts/douyin_downloader.py --help

# 获取视频信息（无需 API）
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a info

# 下载无水印视频
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a download -o ./videos

# 提取文案（需要 API_KEY）
export API_KEY="sk-xxx"
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output

# 提取文案并保存视频
uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output --save-video

输出格式

output/
└── 7600361826030865707/
    ├── transcript.md    # 文案文件
    └── *.mp4            # 视频文件（可选）

transcript.md 内容：

# 视频标题

| 属性 | 值 |
|------|-----|
| 视频ID | `7600361826030865707` |
| 提取时间 | 2026-01-30 14:19:00 |
| 下载链接 | [点击下载](url) |

---

## 文案内容

这里是 AI 识别的语音文案...

📋 系统要求

依赖说明安装方式
uvPython 包管理curl -LsSf https://astral.sh/uv/install.sh | sh
Python3.10+uv python install 3.12
FFmpeg音视频处理brew install ffmpeg (macOS) <br> apt install ffmpeg (Ubuntu)

🔧 技术说明

大文件处理

当音频文件超过 API 限制时（1 小时或 50MB），自动执行：

  1. 检测音频时长和文件大小
  2. 使用 FFmpeg 分割成 9 分钟的片段
  3. 逐段调用 API 转录
  4. 合并所有文本结果

API 说明

语音识别使用 硅基流动 SenseVoice API：

  • 模型：FunAudioLLM/SenseVoiceSmall
  • 限制：单次最大 1 小时 / 50MB（已自动处理）
  • 费用：新用户有免费额度

📝 更新日志

v1.4.0 (最新)

  • 🌐 WebUI - 新增浏览器可视化界面
  • 🔑 浏览器配置 API Key - 无需环境变量
  • 📑 大文件支持 - 自动分段处理长音频

v1.3.0

  • ✨ Claude Code Skill 支持
  • 📄 Markdown 格式输出

v1.2.0

  • 🔄 API 升级

v1.0.0

  • 🎉 首次发布

⚠️ 免责声明

  • 本项目仅供学习和研究使用
  • 使用者需遵守相关法律法规
  • 禁止用于侵犯知识产权的行为
  • 作者不对使用本项目产生的损失承担责任

📄 许可证

Apache License 2.0

👨‍💻 作者

yzfly - GitHub | Email

Global Ranking

-
Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "douyin-mcp-server": { "command": "npx", "args": ["douyin-mcp-server"] } } }