Douyin MCP Server

Extrae enlaces de video sin marca de agua y cópialos desde Douyin.

GitHub
1.3k
Prueba este MCPPatrocinado

Documentación

Extractor de texto de videos cortos

PyPI version Python version License

Descarga videos sin marca de agua desde enlaces compartidos de videos cortos, y la IA extrae automáticamente el texto de voz.

WebUI 界面预览

douyin-mcp-server MCP server

✨ Características

  • 🎬 Video sin marca de agua - Obtén enlaces de descarga de videos de alta calidad sin marca de agua
  • 🎙️ Reconocimiento de voz con IA - Usa SenseVoice de 硅基流动 para extraer texto automáticamente
  • 📑 Soporte para archivos grandes - Procesa automáticamente por segmentos audio de más de 1 hora o 50MB
  • 🌐 WebUI - Interfaz de navegador moderna, sin necesidad de línea de comandos
  • 🔌 Integración MCP - Compatible con aplicaciones de IA como Claude Desktop

📦 Formas de uso

MétodoCaso de usoCaracterística
WebUIUsuarios normalesOperación en navegador, la más sencilla
MCP ServerUsuarios de Claude DesktopLlamada directa en conversaciones de IA
Línea de comandosDesarrolladoresProcesamiento por lotes, integración con scripts

🌐 WebUI (recomendado)

La forma más sencilla de uso, abre el navegador y úsalo.

Inicio rápido

# 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

Abre el navegador y visita http://localhost:8080

Configurar API Key

Hay dos formas de configurar la API Key:

Método 1: Configuración en el navegador (recomendado)

  1. Abre la página WebUI
  2. Haz clic en el botón «API no configurada» en la parte superior
  3. Ingresa la API Key en la ventana emergente y guárdala
  4. La API Key se guarda localmente en el navegador y sigue siendo válida después de actualizar la página

Método 2: Variables de entorno

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

💡 Obtén una API Key gratuita: 硅基流动 (los nuevos usuarios tienen cuota gratuita)

Descripción de funciones

OperaciónDescripción¿Requiere API?
Obtener informaciónAnaliza el título e ID del video, obtén el enlace de descarga sin marca de agua❌
Extraer textoDescargar video → Extraer audio → Reconocimiento de voz con IA✅
Descargar videoHaz clic en el enlace de descarga para guardar el video sin marca de agua❌
Copiar/descargar textoCopia o descarga con un clic el texto en formato Markdown-

Pasos de uso

  1. Pega el enlace - Pega el enlace compartido en el campo de entrada
  2. Haz clic en el botón - Selecciona «Obtener información» o «Extraer texto»
  3. Ver resultados - El lado derecho muestra la información del video y el texto extraído
  4. Exportar - Copia el texto o descarga el archivo Markdown

🚀 MCP Server

Úsalo en aplicaciones compatibles con MCP como Claude Desktop, Cherry Studio, etc.

Método de configuración

Edita el archivo de configuración de MCP y agrega:

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

💡 API_KEY completa la clave de 硅基流动. También es compatible con la configuración anterior: configurar DASHSCOPE_API_KEY (clave de 阿里云百炼) también funciona, basta con configurar una de las dos.

Herramientas disponibles

Nombre de la herramientaFunción¿Requiere API?
parse_douyin_video_infoAnalizar información del video❌
get_douyin_download_linkObtener enlace de descarga❌
extract_douyin_textExtraer texto del video✅
recognize_audio_fileReconocer archivos de audio locales✅ (百炼)
recognize_audio_urlReconocer enlaces de audio en línea✅ (百炼)

Ejemplo de conversación

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

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

🛠️ Herramienta de línea de comandos

Adecuada para desarrolladores y escenarios de procesamiento por lotes.

Instalación

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

Descripción de comandos

# 查看帮助
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

Formato de salida

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

Contenido de transcript.md:

# 视频标题

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

---

## 文案内容

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

📋 Requisitos del sistema

DependenciaDescripciónMétodo de instalación
uvGestión de paquetes de Pythoncurl -LsSf https://astral.sh/uv/install.sh | sh
Python3.10+uv python install 3.12
FFmpegProcesamiento de audio y videobrew install ffmpeg (macOS)
apt install ffmpeg (Ubuntu)

🔧 Notas técnicas

Procesamiento de archivos grandes

Cuando el archivo de audio supera el límite de la API (1 hora o 50MB), se ejecuta automáticamente:

  1. Detecta la duración del audio y el tamaño del archivo
  2. Usa FFmpeg para dividir en segmentos de 9 minutos
  3. Llama a la API para transcribir cada segmento
  4. Combina todos los resultados de texto

Descripción de la API

El reconocimiento de voz usa API SenseVoice de 硅基流动:

  • Modelo: FunAudioLLM/SenseVoiceSmall
  • Límite: Máximo 1 hora / 50MB por solicitud (ya procesado automáticamente)
  • Costo: Los nuevos usuarios tienen cuota gratuita

📝 Registro de cambios

v1.4.1 (última)

  • 🔧 Corrección de MCP Server - API_KEY ahora corresponde correctamente a la clave de 硅基流动, consistente con la documentación; también es compatible con la configuración anterior de DASHSCOPE_API_KEY
  • ♻️ Herramientas restauradas - Restaura las herramientas recognize_audio_file / recognize_audio_url y el parámetro context de extract_douyin_text
  • 🛡️ Refuerzo de seguridad de WebUI - La interfaz de descarga ya no actúa como proxy para cualquier URL, por defecto solo escucha en la máquina local
  • ⚡ Rendimiento de WebUI - La extracción de texto ya no bloquea otras solicitudes
  • 📦 Dependencias simplificadas - Las dependencias de WebUI ahora son de instalación opcional (pip install "douyin-mcp-server[web]")

v1.4.0

  • 🌐 WebUI - Nueva interfaz visual en el navegador
  • 🔑 Configuración de API Key en el navegador - Sin necesidad de variables de entorno
  • 📑 Soporte para archivos grandes - Procesamiento automático por segmentos de audio largo

v1.3.0

  • ✨ Soporte de Claude Code Skill
  • 📄 Salida en formato Markdown

v1.2.0

  • 🔄 Actualización de API

v1.0.0

  • 🎉 Primera versión

⚠️ Descargo de responsabilidad

  • Este proyecto es solo para fines de aprendizaje e investigación
  • Los usuarios deben cumplir con las leyes y regulaciones aplicables
  • Prohibido su uso para infringir derechos de propiedad intelectual
  • El autor no se hace responsable de las pérdidas derivadas del uso de este proyecto

📄 Licencia

Apache License 2.0

👨‍💻 Autor

yzfly - GitHub | Email