YouTube Transcript

Um servidor sem configuração para extrair transcrições de vídeos do YouTube em qualquer plataforma.

Documentação

YouTube Transcript Remote MCP Server

O primeiro servidor remoto Model Context Protocol (MCP) que permite que o Claude AI extraia transcrições de vídeos do YouTube. Este servidor oferece acesso sem configuração para usuários em qualquer plataforma, incluindo dispositivos móveis.

🌟 Recursos

Zero Configuração Local: Sem necessidade de instalação - funciona diretamente da nuvem
Acesso Universal: Funciona nas versões desktop, mobile e web do Claude
Cache Inteligente: Sistema de cache eficiente usando Cloudflare KV para respostas rápidas
Suporte a Múltiplos Idiomas: Extraia transcrições em diferentes idiomas
Tratamento de Erros: Tratamento robusto de erros com mensagens amigáveis
Análises: Rastreamento de solicitações e análises de uso integrados
Flexibilidade de URL: Lida com todos os formatos de URL do YouTube (youtube.com, youtu.be, m.youtube.com, etc.)

🚀 Início Rápido

Opção 1: Use Nosso Servidor Hospedado (Recomendado)

A maneira mais fácil de começar - basta adicionar nosso servidor público ao seu Claude Desktop:

Para Usuários do Claude Desktop

Abra as Configurações do Claude Desktop
- Clique em "Claude" na barra de menu → "Configurações"
- Navegue até a aba "Desenvolvedor"
- Clique em "Editar Configuração"

Adicione a Configuração do Servidor MCP

Adicione isso ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse"
      ]
    }
  }
}

Reinicie o Claude Desktop

Após salvar o arquivo de configuração, reinicie o Claude Desktop para carregar o servidor.
Verifique a Instalação

Procure pelo ícone de ferramentas (🔧) na interface de chat. Você deve ver a ferramenta get_transcript disponível.

Opção 2: Implante o Seu Próprio

Quer executar sua própria instância? Implante no Cloudflare Workers com um clique:

Ou manualmente:

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run deploy

Para Outros Clientes MCP

O servidor suporta o protocolo MCP padrão e pode ser usado com qualquer cliente compatível:

URL do Servidor Público: https://youtube-transcript-mcp.ergut.workers.dev/sse
Transporte: Server-Sent Events (SSE) ou HTTP
Autenticação: Nenhuma necessária (servidor público)

📖 Exemplos de Uso

Extração Básica de Transcrição

Extract the transcript from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Suporte a Múltiplos Idiomas

Can you get the transcript of this video in Turkish: https://youtu.be/VIDEO_ID

Extract the Spanish transcript from: https://www.youtube.com/watch?v=VIDEO_ID

Formatos de URL Suportados

O servidor lida automaticamente com todos os formatos de URL do YouTube:

https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://m.youtube.com/watch?v=VIDEO_ID
https://www.youtube.com/live/VIDEO_ID
https://www.youtube.com/embed/VIDEO_ID
https://www.youtube.com/shorts/VIDEO_ID
Domínios internacionais (youtube.co.uk, youtube.de, etc.)

Todos os parâmetros de rastreamento (como ?si=, &t=, etc.) são removidos automaticamente.

🛠 Ferramentas Disponíveis

`get_transcript`

Extrai a transcrição de uma URL de vídeo do YouTube.

Parâmetros:

url (obrigatório): URL do vídeo do YouTube em qualquer formato
language (opcional): Código do idioma para a transcrição (ex.: 'en', 'es', 'fr'). O padrão é 'en'.

Exemplo de Uso:

{
  "name": "get_transcript",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

🔧 Configuração Avançada

Registro de Depuração

Para habilitar o registro detalhado para solução de problemas:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse",
        "--debug"
      ]
    }
  }
}

Os registros de depuração serão criados em ~/.mcp-auth/{server_hash}_debug.log.

Somente Transporte HTTP

Para forçar o transporte HTTP em vez de SSE:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

📊 Informações do Servidor

Hospedagem: Cloudflare Workers
Cache: Cloudflare KV com cache de 7 dias para transcrições bem-sucedidas
Limite de Taxa: Lógica de repetição integrada com backoff exponencial
Disponibilidade: Disponibilidade de 99,9%+ através da rede global da Cloudflare
Tempo de Resposta: Normalmente <3 segundos para conteúdo em cache, <10 segundos para novas solicitações

🚨 Tratamento de Erros

O servidor fornece mensagens de erro claras para problemas comuns:

"URL do YouTube inválida fornecida": O formato da URL não é reconhecido
"Nenhuma transcrição disponível para este vídeo": O vídeo não tem legendas/transcrição
"Vídeo não encontrado ou privado": O vídeo é privado, foi excluído ou não existe
"Serviço temporariamente ocupado, tente novamente em alguns minutos": Limite de taxa do YouTube
"As transcrições estão desativadas para este vídeo": O criador desativou as legendas

🌍 Suporte a Idiomas

O servidor suporta qualquer idioma para o qual o YouTube forneça transcrições. Códigos de idioma comuns:

en - Inglês (padrão)
tr - Turco
es - Espanhol
fr - Francês
de - Alemão
it - Italiano
pt - Português
ja - Japonês
ko - Coreano
zh - Chinês

🔒 Privacidade e Segurança

Nenhuma Autenticação Necessária: Servidor público para facilidade de uso
Nenhum Armazenamento de Dados: As transcrições são armazenadas em cache temporariamente apenas para desempenho
Nenhuma Informação Pessoal: Apenas IDs de vídeo do YouTube e transcrições são processados
Somente HTTPS: Todas as comunicações são criptografadas
CORS Habilitado: Suporta clientes MCP baseados na web

🚀 Endpoints de API

Para desenvolvedores que desejam integrar diretamente:

HTTP POST `/mcp`

Endpoint JSON-RPC MCP padrão para integração direta.

Server-Sent Events `/sse`

Endpoint de transporte SSE MCP para comunicação em tempo real.

Informações `/`

Endpoint de informações e status do servidor.

Exemplo de Chamada Direta de API:

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

🐛 Solução de Problemas

Problemas Comuns

"Erro de Conexão" no Claude Desktop
- Certifique-se de ter a versão mais recente do Claude Desktop
- Verifique se o mcp-remote está configurado corretamente
- Tente adicionar a flag --debug para ver registros detalhados
"Não foi possível conectar ao servidor MCP"
- Verifique sua conexão com a internet
- Verifique se a URL do servidor está correta
- Reinicie o Claude Desktop após alterações na configuração
Nenhuma transcrição retornada
- Verifique se a URL do YouTube é válida e acessível
- Verifique se o vídeo tem legendas habilitadas
- Tente um código de idioma diferente, se disponível

Obtendo Ajuda

Verifique os registros: Procure em ~/.mcp-auth/ por registros de depuração
Teste a conexão direta: Use npx -p mcp-remote@latest mcp-remote-client https://youtube-transcript-mcp.ergut.workers.dev/sse
Verifique o status do servidor: Visite https://youtube-transcript-mcp.ergut.workers.dev/
Abra um problema: GitHub Issues

🤝 Contribuindo

Este é um projeto de código aberto. Contribuições são bem-vindas!

Relate Problemas: Encontrou um bug? Por favor, abra um problema
Solicitações de Recursos: Tem ideias para melhorias? Nos avise!
Contribuições de Código: PRs são bem-vindos para melhorias

Configuração de Desenvolvimento

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run dev

📜 Licença

Este projeto é de código aberto e está disponível sob a Licença MIT.

🙏 Agradecimentos

Construído com o Model Context Protocol da Anthropic
Hospedado no Cloudflare Workers
Usa a biblioteca youtube-transcript
Inspirado pela comunidade MCP e pelos servidores de transcrição locais existentes

Pronto para turbinar o Claude com extração de transcrições do YouTube? Adicione este servidor à sua configuração do Claude Desktop e comece a extrair transcrições de qualquer vídeo do YouTube instantaneamente! 🎉