SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场douyin-video-extractor

douyin-video-extractor

办公与效率

查看项目

更新于 10-16 10:09

技能介绍

用途

Douyin Video Extractor（douyin-mcp-server）是一个基于 MCP Skills 集合发布的技能工具，主要用于处理抖音（TikTok 中国版）分享链接。它能够从抖音分享链接中提取无水印视频下载地址，并使用 AI 语音识别技术将视频音频内容转录为文本。

主要能力

  • 从抖音分享链接解析视频信息与元数据
  • 获取高质量的无水印视频下载链接
  • 使用 SenseVoice 模型进行 AI 语音转文字转录
  • 对超过1小时或超过50MB的大型音频文件自动分块处理（分块后自动合并，默认每块9分钟）
  • 支持批量处理多个视频链接
  • 转录结果以 Markdown 格式保存，包含视频 ID、提取时间、下载链接和文案内容
  • 提供错误处理机制（ParseError、DownloadError 等异常类）
  • 支持自定义转录设置（模型选择、分块时长）

使用方式

安装前提

需要先安装 uv（Python 包管理器）和 FFmpeg（音频处理依赖）：

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 安装 FFmpeg
# macOS
brew install ffmpeg
# Ubuntu/Debian
apt install ffmpeg
# Windows (with chocolatey)
choco install ffmpeg

安装步骤

git clone https://github.com/yzfly/douyin-mcp-server.git
cd douyin-mcp-server
uv sync
# 设置 API Key（可选，仅文本提取时需要）
export API_KEY="sk-xxxxxxxxxxxxxxxx"

三种使用模式

1. WebUI（推荐交互使用）

uv run python web/app.py
# 浏览器访问 http://localhost:8080

WebUI 功能：无需 API Key 即可解析视频信息；配置 API Key 后提取转录文本；直接下载视频；导出转录为 Markdown。API Key 可配置在浏览器 localStorage 中。

2. MCP 服务器（用于 AI 助手）

在 claude_desktop_config.json 或类似 MCP 客户端配置中添加：

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

可用 MCP 工具：

  • parse_douyin_video_info - 解析视频元数据（无需 API Key）
  • get_douyin_download_link - 获取无水印下载链接（无需 API Key）
  • extract_douyin_text - 通过 AI 提取视频转录文本（需要 API Key）

3. 命令行界面

# 获取视频信息（无需 API Key）
uv run python douyin-video/scripts/douyin_downloader.py -l "https://v.douyin.com/xxxxx/" -a info

# 下载无水印视频
uv run python douyin-video/scripts/douyin_downloader.py -l "https://v.douyin.com/xxxxx/" -a download -o ./videos

# 提取转录文本（需要 API_KEY）
uv run python douyin-video/scripts/douyin_downloader.py -l "https://v.douyin.com/xxxxx/" -a extract -o ./output

CLI 参数：-l/--link 分享链接（必填）；-a/--action 操作类型 info/download/extract（必填）；-o/--output 输出目录；--save-video 提取时保存视频；--api-key 覆盖环境变量中的密钥。

Python 集成

工具提供 Python 模块调用能力：douyin_video.parser.DouyinParser 用于解析视频信息；douyin_video.downloader.DouyinDownloader 用于下载视频；douyin_video.transcriber.VideoTranscriber 用于转录。转录器支持自定义模型（默认 FunAudioLLM/SenseVoiceSmall）和分块时长（默认540秒）。

API Key 配置

转录功能需要 API Key，可从 SiliconFlow 获取（新用户有免费额度）。支持三种配置方式：环境变量 export API_KEY="sk-xxxxxxxxxxxxxxxx"；WebUI 浏览器存储；CLI 参数 --api-key。

输出格式

提取的转录文本保存为 Markdown，包含视频标题、视频 ID、提取时间、下载链接以及文案内容。

适用场景

  • 需要获取抖音视频无水印素材用于个人留存或内容研究
  • 需要将抖音视频中的语音内容转为文字稿
  • 在 AI 助手（如 Claude Desktop）中集成抖音视频处理能力
  • 批量处理多个抖音视频的转录任务

限制与注意事项

  • 使用需要先安装 uv 和 FFmpeg，环境依赖较多
  • 转录功能依赖 SiliconFlow API Key，需自行申请并确保额度充足
  • 大文件处理需要足够的磁盘空间和稳定的网络连接
  • 链接必须是有效的抖音分享链接（以 https://v.douyin.com/ 开头）
  • 视频需仍然可访问（未被删除）
  • 输出目录需具备写入权限
  • 关于具体的收费、价格、平台可用性等细节，资料中未完整提供