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

  1. Clone o repositório:
git clone https://github.com/yourusername/yt-mcp.git
cd yt-mcp
  1. Instale as dependências:
pnpm install
  1. Compile o projeto:
pnpm run build

Configuração

Para Cursor

  1. Abra as Configurações do Cursor
  2. Navegue até MCP → Adicionar novo servidor MCP
  3. Configure com estas configurações:
    • Nome: youtube-transcript
    • Tipo: command
    • Comando: node /absolute/path/to/yt-mcp/build/index.js

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:

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:

  1. 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
  2. Erro "No transcript available"

    • Verifique se o vídeo tem legendas habilitadas
    • Tente um vídeo diferente para confirmar que a ferramenta está funcionando
  3. 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