Douyin MCP Server

Extrator de Legendas de Vídeos Curtos

Baixe vídeos curtos sem marca d'água a partir de links de compartilhamento, com extração automática de legendas por IA.

✨ Recursos

• 🎬 Vídeo sem marca d'água - Obtenha links de download de vídeos de alta qualidade sem marca d'água
• 🎙️ Reconhecimento de fala por IA - Extração automática de legendas com SenseVoice da SiliconFlow
• 📑 Suporte a arquivos grandes - Processamento automático em segmentos para áudios acima de 1 hora ou 50MB
• 🌐 WebUI - Interface moderna no navegador, sem necessidade de linha de comando
• 🔌 Integração MCP - Suporte a aplicativos de IA como Claude Desktop

---

📦 Como usar

Método	Cenário de uso	Destaques
WebUI	Usuários comuns	Operação pelo navegador, a mais simples
MCP Server	Usuários do Claude Desktop	Chamada direta durante conversas com IA
Linha de comando	Desenvolvedores	Processamento em lote, integração com scripts

---

🌐 WebUI (recomendado)

A forma mais simples de usar: basta abrir o navegador.

Início 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

Abra o navegador e acesse http://localhost:8080

Configurar a chave da API

Há duas formas de configurar a chave da API:

Opção 1: Configuração no navegador (recomendada)

1. Abra a página do WebUI
2. Clique no botão "API não configurada" no topo
3. Digite a chave da API na janela e salve
4. A chave fica salva no navegador e continua válida após atualizar a página

Opção 2: Variável de ambiente

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

💡 Obtenha uma chave de API gratuita: SiliconFlow (novos usuários recebem créditos gratuitos)

Funcionalidades

Operação	Descrição	Precisa de API
Obter informações	Analisa título e ID do vídeo, obtém link de download sem marca d'água	❌
Extrair legendas	Baixar vídeo → extrair áudio → reconhecimento de fala por IA	✅
Baixar vídeo	Clique no link de download para salvar o vídeo sem marca d'água	❌
Copiar/baixar legendas	Copie ou baixe as legendas em formato Markdown com um clique	-

Passos de uso

1. Cole o link - Cole o link de compartilhamento no campo de entrada
2. Clique no botão - Escolha "Obter informações" ou "Extrair legendas"
3. Veja o resultado - As informações do vídeo e as legendas extraídas aparecem à direita
4. Exporte - Copie as legendas ou baixe o arquivo Markdown

---

🚀 MCP Server

Use em aplicativos compatíveis com MCP, como Claude Desktop e Cherry Studio.

Como configurar

Edite o arquivo de configuração do MCP e adicione:

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

💡 API_KEY preencha com a chave da SiliconFlow. Também é compatível com a configuração antiga: definir DASHSCOPE_API_KEY (chave do Alibaba Cloud Bailian) também funciona; basta definir uma das duas.

Ferramentas disponíveis

Ferramenta	Função	Precisa de API
parse_douyin_video_info	Analisa informações do vídeo	❌
get_douyin_download_link	Obtém link de download	❌
extract_douyin_text	Extrai legendas do vídeo	✅
recognize_audio_file	Reconhece arquivo de áudio local	✅ (Bailian)
recognize_audio_url	Reconhece link de áudio online	✅ (Bailian)

Exemplo de conversa

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

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

---

🛠️ Ferramenta de linha de comando

Ideal para desenvolvedores e processamento em lote.

Instalação

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

Descrição dos 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 saída

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

Conteúdo do transcript.md:

# 视频标题

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

---

## 文案内容

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

---

📋 Requisitos do sistema

Dependência	Descrição	Como instalar
uv	Gerenciador de pacotes Python	curl -LsSf https://astral.sh/uv/install.sh | sh
Python	3.10+	uv python install 3.12
FFmpeg	Processamento de áudio e vídeo	brew install ffmpeg (macOS) apt install ffmpeg (Ubuntu)

---

🔧 Detalhes técnicos

Processamento de arquivos grandes

Quando o arquivo de áudio excede o limite da API (1 hora ou 50MB), o processo automático é:

1. Detecta a duração e o tamanho do arquivo de áudio
2. Usa FFmpeg para dividir em segmentos de 9 minutos
3. Chama a API para transcrição de cada segmento
4. Combina todos os resultados de texto

Sobre a API

O reconhecimento de fala usa a API SenseVoice da SiliconFlow:

• Modelo: FunAudioLLM/SenseVoiceSmall
• Limite: máximo de 1 hora / 50MB por chamada (já tratado automaticamente)
• Custo: novos usuários recebem créditos gratuitos

---

📝 Histórico de versões

v1.4.1 (mais recente)

• 🔧 Correção no MCP Server - API_KEY agora corresponde corretamente à chave da SiliconFlow, alinhado com a documentação; também compatível com a configuração antiga DASHSCOPE_API_KEY
• ♻️ Ferramentas restauradas - Restauradas as ferramentas recognize_audio_file / recognize_audio_url e o parâmetro context de extract_douyin_text
• 🛡️ Segurança reforçada no WebUI - O endpoint de download não faz mais proxy de URLs arbitrárias; por padrão, escuta apenas na máquina local
• ⚡ Desempenho do WebUI - A extração de legendas não bloqueia mais outras requisições
• 📦 Dependências reduzidas - Dependências do WebUI agora são opcionais (pip install "douyin-mcp-server[web]")

v1.4.0

• 🌐 WebUI - Nova interface visual no navegador
• 🔑 Configuração da chave da API no navegador - Sem necessidade de variável de ambiente
• 📑 Suporte a arquivos grandes - Processamento automático em segmentos para áudios longos

v1.3.0

• ✨ Suporte a Claude Code Skill
• 📄 Saída em formato Markdown

v1.2.0

• 🔄 Atualização da API

v1.0.0

• 🎉 Primeira versão

---

⚠️ Aviso legal

• Este projeto destina-se apenas a fins de estudo e pesquisa
• O usuário deve cumprir as leis e regulamentos aplicáveis
• É proibido o uso para violação de direitos de propriedade intelectual
• Os autores não se responsabilizam por perdas decorrentes do uso deste projeto

---

📄 Licença

Apache License 2.0

👨‍💻 Autor

yzfly - GitHub | E-mail