Nabil-MEDIOUNI/ytextract

O que ytextract faz?

🎬 Extraia transcrições do YouTube (vídeo único ou playlist) por meio de uma CLI baseada em Playwright e uma habilidade de agente de IA que aciona o painel 'Mostrar transcrição' do YouTube.

Visão Geral

O ytextract é uma ferramenta de script e habilidade de agente de IA que automatiza a extração de transcrições do YouTube usando o Playwright para interagir com a interface do usuário do YouTube. Ele navega até a página de um vídeo, clica no botão 'Mostrar transcrição' e extrai o texto completo junto com os timestamps.

Funcionalidades

• Extrair transcrição de um único vídeo do YouTube (por ID ou URL)
• Extrair transcrições de uma playlist completa
• Geração limpa de saída Markdown com timestamps
• Suporte para vídeos com legendas geradas automaticamente ou enviadas manualmente
• Pode ser usado como CLI autônoma ou como habilidade para agentes de IA

Requisitos

• Node.js (versão 16+)
• NPX (incluso com Node.js)
• Playwright (gerenciado automaticamente pelo npx)

Uso como CLI

npx ytextract <youtube-url-or-id>

Exemplos

Extrair transcrição de um único vídeo:

npx ytextract https://www.youtube.com/watch?v=dQw4w9WgXcQ

Extrair transcrições de uma playlist:

npx ytextract https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf

Salvar a saída em um arquivo:

npx ytextract dQw4w9WgXcQ > transcript.md

Uso como Habilidade de Agente de IA

Em ambientes como Claude Code, Cursor ou Codex, invoque a habilidade descrevendo a tarefa:

"Extraia a transcrição do vídeo do YouTube https://www.youtube.com/watch?v=dQw4w9WgXcQ e salve como transcript.md"

O agente irá:

1. Executar npx ytextract com a URL ou ID fornecida
2. Processar a saída Markdown
3. Fornecer a transcrição para análise adicional, busca ou transformação

Formato de Saída

A transcrição é gerada como Markdown com timestamps:

# Título do Vídeo

- **0:00** Introdução ao tópico
- **0:15** Primeiro ponto apresentado
- **1:30** Discussão aprofundada
...

Para playlists:

Saída separada para cada vídeo, com o título do vídeo como cabeçalho.

Boas Práticas

• Sempre solicite ao agente para salvar a transcrição em um arquivo para referência futura
• Para playlists grandes, especifique limites (ex.: 'apenas os primeiros 5 vídeos')
• Combine transcrições no final da tarefa para resumos abrangentes

Solução de Problemas

• Erro: 'Nenhuma transcrição disponível' - O vídeo pode não ter legendas ou ter legendas desativadas
• Erro: Playwright não encontrado - Execute npx playwright install chromium ou use npx ytextract (que instala automaticamente)
• Erro: Timeout - O YouTube pode estar lento; tente novamente com uma conexão de internet mais estável

Licença

MIT