YouTube Transcript Extractor
Extrai transcrições de vídeos públicos do YouTube.
Documentação
YouTube Transcript Extractor MCP 🎥
Um servidor Model Context Protocol (MCP) que permite que assistentes de IA extraiam transcrições de vídeos do YouTube. Construído para integração com Cursor e Claude Desktop, esta ferramenta permite que a IA analise e trabalhe diretamente com o conteúdo de vídeos do YouTube.
Recursos
- 🎯 Extraia transcrições de qualquer vídeo público do YouTube
- 🔌 Integração fácil com Cursor e Claude Desktop
- 🚀 Construído com TypeScript para segurança de tipos
- 📦 Configuração e implantação simples
- 🛠️ Baseado no Model Context Protocol
Pré-requisitos
- Node.js (v16 ou superior)
- pnpm (recomendado) ou npm
- Uma URL de vídeo do YouTube para extrair transcrições
Instalação
- Clone o repositório:
git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp
- Instale as dependências:
pnpm install
- Compile o projeto:
pnpm run build
Configuração
Para Cursor
- Abra as Configurações do Cursor
- Navegue até MCP → Adicionar novo servidor MCP
- Configure com estas configurações:
- Nome:
youtube-transcript - Tipo:
command - Comando:
node /absolute/path/to/yt-mcp/build/index.js
- Nome:
Para Claude Desktop
Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:
{
"mcpServers": {
"youtube-transcript": {
"command": "node",
"args": ["/absolute/path/to/yt-mcp/build/index.js"]
}
}
}
Uso
Uma vez configurado, a IA pode extrair transcrições de vídeos do YouTube chamando a ferramenta com uma URL de vídeo. Exemplo:
// The AI will use this format internally
const transcript = await extractTranscript({
input: "https://www.youtube.com/watch?v=VIDEO_ID"
});
Detalhes Técnicos
O servidor é construído usando:
- @modelcontextprotocol/sdk - Para implementação do MCP
- youtube-transcript - Para extração de transcrições
- TypeScript - Para segurança de tipos e melhor experiência de desenvolvimento
Limitações
- Funciona apenas com vídeos públicos do YouTube
- Os vídeos devem ter legendas/legendas ocultas habilitadas
- Alguns vídeos podem ter legendas geradas automaticamente que podem não ser 100% precisas
Solução de Problemas
Problemas comuns e soluções:
-
Erro "Cannot find video ID"
- Certifique-se de que a URL do YouTube está completa e correta
- Verifique se o vídeo está acessível publicamente
-
Erro "No transcript available"
- Verifique se o vídeo tem legendas habilitadas
- Tente um vídeo diferente para confirmar que a ferramenta está funcionando
-
Erros de compilação
- Certifique-se de que todas as dependências estão instaladas
- Verifique a versão do Node.js (deve ser v16 ou superior)
Contribuindo
Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request. Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.
Licença
MIT