Skip to content
Back to search

douyin-mcp-server

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yzfly--douyin-mcp-server/badge.svg)](/listings/yzfly--douyin-mcp-server)

HTML

<a href="/listings/yzfly--douyin-mcp-server"><img src="/api/listings/yzfly--douyin-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 278 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 短视频文案提取器
  2. [![PyPI version](https://badge.fury.io/py/douyin-mcp-server.svg)](https://badge.fury.io/py/douyin-mcp-server)
  3. [![Python version](https://img.shields.io/pypi/pyversions/douyin-mcp-server.svg)](https://pypi.org/project/douyin-mcp-server/)
  4. [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
  5. 从短视频分享链接下载无水印视频,AI 自动提取语音文案。
  6. ![WebUI 界面预览](douyin-video.png)
  7. <a href="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server">
  8. <img width="380" height="200" src="https://glama.ai/mcp/servers/@yzfly/douyin-mcp-server/badge" alt="douyin-mcp-server MCP server" />
  9. </a>
  10. ## ✨ 功能特性
  11. - 🎬 **无水印视频** - 获取高质量无水印视频下载链接
  12. - 🎙️ **AI 语音识别** - 使用硅基流动 SenseVoice 自动提取文案
  13. - 📑 **大文件支持** - 自动分段处理超过 1 小时或 50MB 的音频
  14. - 🌐 **WebUI** - 现代化浏览器界面,无需命令行
  15. - 🔌 **MCP 集成** - 支持 Claude Desktop 等 AI 应用
  16. ---
  17. ## 📦 使用方式
  18. | 方式 | 适用场景 | 特点 |
  19. |------|----------|------|
  20. | [**WebUI**](#-webui-推荐) | 普通用户 | 浏览器操作,最简单 |
  21. | [**MCP Server**](#-mcp-server) | Claude Desktop 用户 | AI 对话中直接调用 |
  22. | [**命令行**](#️-命令行工具) | 开发者 | 批量处理,脚本集成 |
  23. ---
  24. ## 🌐 WebUI (推荐)
  25. 最简单的使用方式,打开浏览器即可使用。
  26. ### 快速开始
  27. ```bash
  28. # 1. 克隆项目
  29. git clone https://github.com/yzfly/douyin-mcp-server.git
  30. cd douyin-mcp-server
  31. # 2. 安装依赖
  32. uv sync
  33. # 3. 启动服务
  34. uv run python web/app.py
  35. ```
  36. 打开浏览器访问 **http://localhost:8080**
  37. ### 配置 API Key
  38. 有两种方式配置 API Key:
  39. **方式一:浏览器内配置(推荐)**
  40. 1. 打开 WebUI 页面
  41. 2. 点击顶部的「API 未配置」按钮
  42. 3. 在弹窗中输入 API Key 并保存
  43. 4. API Key 保存在浏览器本地,刷新页面后仍有效
  44. **方式二:环境变量**
  45. ```bash
  46. export API_KEY="sk-xxxxxxxxxxxxxxxx"
  47. uv run python web/app.py
  48. ```
  49. > 💡 获取免费 API Key:[硅基流动](https://cloud.siliconflow.cn/i/TxUlXG3u)(新用户有免费额度)
  50. ### 功能说明
  51. | 操作 | 说明 | 需要 API |
  52. |------|------|:--------:|
  53. | **获取信息** | 解析视频标题、ID,获取无水印下载链接 | ❌ |
  54. | **提取文案** | 下载视频 → 提取音频 → AI 语音识别 | ✅ |
  55. | **下载视频** | 点击下载链接保存无水印视频 | ❌ |
  56. | **复制/下载文案** | 一键复制或下载 Markdown 格式文案 | - |
  57. ### 使用步骤
  58. 1. **粘贴链接** - 将分享链接粘贴到输入框
  59. 2. **点击按钮** - 选择「获取信息」或「提取文案」
  60. 3. **查看结果** - 右侧显示视频信息和提取的文案
  61. 4. **导出** - 复制文案或下载 Markdown 文件
  62. ---
  63. ## 🚀 MCP Server
  64. 在 Claude Desktop、Cherry Studio 等支持 MCP 的应用中使用。
  65. ### 配置方法
  66. 编辑 MCP 配置文件,添加:
  67. ```json
  68. {
  69. "mcpServers": {
  70. "douyin-mcp": {
  71. "command": "uvx",
  72. "args": ["douyin-mcp-server"],
  73. "env": {
  74. "API_KEY": "sk-xxxxxxxxxxxxxxxx"
  75. }
  76. }
  77. }
  78. }
  79. ```
  80. > 💡 `API_KEY` 填写[硅基流动](https://cloud.siliconflow.cn/i/TxUlXG3u)的密钥。也兼容旧版配置:设置 `DASHSCOPE_API_KEY`(阿里云百炼密钥)同样可用,两者设其一即可。
  81. ### 可用工具
  82. | 工具名 | 功能 | 需要 API |
  83. |--------|------|:--------:|
  84. | `parse_douyin_video_info` | 解析视频信息 | ❌ |
  85. | `get_douyin_download_link` | 获取下载链接 | ❌ |
  86. | `extract_douyin_text` | 提取视频文案 | ✅ |
  87. | `recognize_audio_file` | 识别本地音频文件 | ✅ (百炼) |
  88. | `recognize_audio_url` | 识别在线音频链接 | ✅ (百炼) |
  89. ### 对话示例
  90. ```
  91. 用户:帮我提取这个视频的文案 https://v.douyin.com/xxxxx/
  92. Claude:我来帮你提取视频文案...
  93. [调用 extract_douyin_text 工具]
  94. 提取完成,文案内容如下:
  95. ...
  96. ```
  97. ---
  98. ## 🛠️ 命令行工具
  99. 适合开发者和批量处理场景。
  100. ### 安装
  101. ```bash
  102. git clone https://github.com/yzfly/douyin-mcp-server.git
  103. cd douyin-mcp-server
  104. uv sync
  105. ```
  106. ### 命令说明
  107. ```bash
  108. # 查看帮助
  109. uv run python douyin-video/scripts/douyin_downloader.py --help
  110. # 获取视频信息(无需 API)
  111. uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a info
  112. # 下载无水印视频
  113. uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a download -o ./videos
  114. # 提取文案(需要 API_KEY)
  115. export API_KEY="sk-xxx"
  116. uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output
  117. # 提取文案并保存视频
  118. uv run python douyin-video/scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output --save-video
  119. ```
  120. ### 输出格式
  121. ```
  122. output/
  123. └── 7600361826030865707/
  124. ├── transcript.md # 文案文件
  125. └── *.mp4 # 视频文件(可选)
  126. ```
  127. **transcript.md 内容:**
  128. ```markdown
  129. # 视频标题
  130. | 属性 | 值 |
  131. |------|-----|
  132. | 视频ID | `7600361826030865707` |
  133. | 提取时间 | 2026-01-30 14:19:00 |
  134. | 下载链接 | [点击下载](url) |
  135. ---
  136. ## 文案内容
  137. 这里是 AI 识别的语音文案...
  138. ```
  139. ---
  140. ## 📋 系统要求
  141. | 依赖 | 说明 | 安装方式 |
  142. |------|------|----------|
  143. | uv | Python 包管理 | `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
  144. | Python | 3.10+ | `uv python install 3.12` |
  145. | FFmpeg | 音视频处理 | `brew install ffmpeg` (macOS) <br> `apt install ffmpeg` (Ubuntu) |
  146. ---
  147. ## 🔧 技术说明
  148. ### 大文件处理
  149. 当音频文件超过 API 限制时(1 小时或 50MB),自动执行:
  150. 1. 检测音频时长和文件大小
  151. 2. 使用 FFmpeg 分割成 9 分钟的片段
  152. 3. 逐段调用 API 转录
  153. 4. 合并所有文本结果
  154. ### API 说明
  155. 语音识别使用 [硅基流动 SenseVoice API](https://cloud.siliconflow.cn/):
  156. - 模型:`FunAudioLLM/SenseVoiceSmall`
  157. - 限制:单次最大 1 小时 / 50MB(已自动处理)
  158. - 费用:新用户有免费额度
  159. ---
  160. ## 📝 更新日志
  161. ### v1.4.1 (最新)
  162. - 🔧 **MCP Server 修复** - `API_KEY` 现在正确对应硅基流动密钥,与文档一致;同时兼容旧版 `DASHSCOPE_API_KEY` 配置
  163. - ♻️ **恢复工具** - 恢复 `recognize_audio_file` / `recognize_audio_url` 工具及 `extract_douyin_text` 的 `context` 参数
  164. - 🛡️ **WebUI 安全加固** - 下载接口不再代理任意 URL,默认仅监听本机
  165. - ⚡ **WebUI 性能** - 提取文案不再阻塞其他请求
  166. - 📦 **依赖精简** - WebUI 依赖改为可选安装(`pip install "douyin-mcp-server[web]"`)
  167. ### v1.4.0
  168. - 🌐 **WebUI** - 新增浏览器可视化界面
  169. - 🔑 **浏览器配置 API Key** - 无需环境变量
  170. - 📑 **大文件支持** - 自动分段处理长音频
  171. ### v1.3.0
  172. - ✨ Claude Code Skill 支持
  173. - 📄 Markdown 格式输出
  174. ### v1.2.0
  175. - 🔄 API 升级
  176. ### v1.0.0
  177. - 🎉 首次发布
  178. ---
  179. ## ⚠️ 免责声明
  180. - 本项目仅供学习和研究使用
  181. - 使用者需遵守相关法律法规
  182. - 禁止用于侵犯知识产权的行为
  183. - 作者不对使用本项目产生的损失承担责任
  184. ---
  185. ## 📄 许可证
  186. Apache License 2.0
  187. ## 👨‍💻 作者
  188. **yzfly** - [GitHub](https://github.com/yzfly) | [Email](mailto:yz.liu.me@gmail.com)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.