Transcripción de enlaces de Douyin y organización de guiones orales

Analiza automáticamente el contenido multimedia desde enlaces compartidos de Douyin, genera transcripciones verbatim localmente y las organiza en guiones orales listos para usar.

Este proyecto se mantiene a partir de yzfly/douyin-mcp-server; conserva la licencia Apache-2.0 del proyecto original.

✨ Características

• 🎬 Vídeo sin marca de agua - Obtén enlaces de descarga de vídeo de alta calidad sin marca de agua

• 🛟 Degradación automática - Cuando falla el análisis HTTP, se utiliza Playwright compartido para capturar el audio firmado

• 🎙️ Reconocimiento de voz local - faster-whisper-medium / CPU int8, sin consumir API de ASR

• ✍️ Organización de guiones - DeepSeek elimina duplicados, añade puntuación y estructura, conservando el significado original

• 🌐 WebUI - Interfaz de navegador moderna, sin necesidad de línea de comandos

• 🔌 Integración MCP - Compatible con aplicaciones de IA como Claude Desktop

Related MCP server: Douyin Video Analysis MCP

Estructura del proyecto

assets/                 预览图和发布用 skill 包
douyin_mcp_server/      Python 核心包
scripts/                命令行入口
skills/douyin-video/    可复用的工作流说明
tests/                  单元测试
web/                    FastAPI WebUI

📦 Formas de uso

🌐 WebUI (Recomendado)

La forma más sencilla de uso: abre el navegador y listo.

Inicio rápido

# 1. 克隆你自己的仓库
git clone <your-repository-url>
cd douyin-mcp-server

# 2. 安装依赖
uv sync --extra web

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

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

Configurar la clave API de DeepSeek

Hay dos formas de configurar la clave API:

Opción 1: Configuración desde el navegador

1. Abre la página de WebUI

2. Haz clic en el botón «API no configurada» de la parte superior

3. Introduce la clave API en la ventana emergente y guárdala

4. La clave API se guarda localmente en el navegador y solo se envía al servicio local junto con la solicitud de extracción

Opción 2: Variable de entorno

export DOUYIN_DEEPSEEK_API_KEY="<your-deepseek-api-key>"
uv run python web/app.py

El ASR local no requiere clave; la clave de DeepSeek solo se usa para el último paso de organización del guion.

Descripción de funciones

Pasos de uso

1. Pegar el enlace - Pega el enlace compartido en el campo de entrada

2. Hacer clic en el botón - Elige «Obtener información» o «Extraer texto»

3. Ver el resultado - A la derecha se muestran la información del vídeo y el texto extraído

4. Exportar - Copia el texto o descarga el archivo Markdown

🚀 Servidor MCP

Ú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 añade:

{
  "mcpServers": {
    "douyin-mcp": {
      "command": "uvx",
      "args": ["douyin-mcp-server"],
      "env": {
        "DOUYIN_DEEPSEEK_API_KEY": "<your-deepseek-api-key>"
      }
    }
  }
}

DOUYIN_DEEPSEEK_API_KEY solo se coloca en el entorno de ejecución; no se escribe en el repositorio, en archivos de salida ni en informes de ejecución.

Herramientas disponibles

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 scripts/douyin_downloader.py --help

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

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

# 提取文案（本地 ASR；整理阶段需要 DOUYIN_DEEPSEEK_API_KEY）
export DOUYIN_DEEPSEEK_API_KEY="<your-deepseek-api-key>"
uv run python scripts/douyin_downloader.py -l "分享链接" -a extract -o ./output

Formato de salida

output/
└── 7600361826030865707/
    ├── audio.m4a          # 已校验的完整音频
    ├── transcript-raw.md  # 本地 ASR 原始逐字稿
    ├── copy.md            # DeepSeek 整理后的口播
    ├── metadata.json
    └── run-report.json    # 五阶段状态和验证证据

📋 Requisitos del sistema

🔧 Notas técnicas

Flujo de trabajo fijo

1. Análisis HTTP del enlace compartido; si falla, degradación automática a Playwright.

2. La rama HTTP descarga el vídeo; la rama del navegador descarga el audio firmado por Range.

3. La rama HTTP extrae el audio con FFmpeg; la rama del navegador verifica el audio completo con ffprobe.

4. faster-whisper-medium / CPU int8 local genera la transcripción verbatim con marcas de tiempo.

5. DeepSeek organiza el guion oral y lo escribe en run-report.json.

📝 Registro de cambios

v1.5.0 (versión actual de estación de trabajo)

• Degradación automática a Playwright compartido cuando falla el análisis HTTP

• Uso de faster-whisper-medium / CPU int8 local; el ASR ya no depende de APIs en la nube

• Uso de DeepSeek V4 Flash para organizar el guion oral

• Salida fija de audio, transcripción verbatim original, guion organizado, metadatos e informe de ejecución

v1.4.1

• 🔧 Corrección del servidor MCP - API_KEY ahora corresponde correctamente a la clave de SiliconFlow, coherente con la documentación; también es compatible con la configuración antigua DASHSCOPE_API_KEY

• ♻️ Herramientas restauradas - Se restauran las herramientas recognize_audio_file / recognize_audio_url y el parámetro context de extract_douyin_text

• 🛡️ Refuerzo de seguridad de WebUI - El endpoint de descarga ya no actúa como proxy de URLs arbitrarias; por defecto solo escucha en local

• ⚡ Rendimiento de WebUI - La extracción de texto ya no bloquea otras solicitudes

• 📦 Dependencias simplificadas - Las dependencias de WebUI pasan a ser opcionales (pip install "douyin-mcp-server[web]")

v1.4.0

• 🌐 WebUI - Nueva interfaz visual en el navegador

• 🔑 Configuración de clave API desde el navegador - Sin necesidad de variables de entorno

• 📑 Soporte de archivos grandes - Segmentación automática para audios largos

v1.3.0

• ✨ Soporte de Claude Code Skill

• 📄 Salida en formato Markdown

v1.2.0

• 🔄 Actualización de API

v1.0.0

• 🎉 Primera publicación

⚠️ Aviso legal

• Este proyecto se proporciona únicamente con fines de aprendizaje e investigación

• El usuario debe cumplir con las leyes y regulaciones aplicables

• Prohibido su uso para infringir derechos de propiedad intelectual

• Los autores no se hacen responsables de las pérdidas derivadas del uso de este proyecto

📄 Licencia

Apache License 2.0

🤝 Contribuciones

Antes de enviar un Issue o Pull Request, lee CONTRIBUTING.md. Los problemas de seguridad deben notificarse de forma privada según SECURITY.md.

Antes de publicar en tu propio repositorio de GitHub, completa project.urls en pyproject.toml con la dirección de tu repositorio y modifica el nombre del proyecto y la información del autor según sea necesario.

Fuente original

Autor del proyecto original: yzfly (GitHub).