YouTube Transcript Downloader
Skill para extrair e processar legendas de vídeos do YouTube.
Ordem de Prioridade
1. Verificar instalação do yt-dlp
2. Listar legendas disponíveis
3. Tentar legendas manuais primeiro
4. Fallback para legendas automáticas
5. Último recurso: conversão com Whisper
Requisitos
# macOS
brew install yt-dlp
# Linux
sudo apt install yt-dlp
# Universal
pip install yt-dlp
Fluxo de Trabalho
Passo 1: Verificar lista de legendas
yt-dlp --list-subs "URL_DO_VIDEO"
Passo 2: Baixar legendas manuais (recomendado)
# Legendas em português
yt-dlp --write-sub --sub-lang pt --skip-download "URL_DO_VIDEO"
# Legendas em inglês
yt-dlp --write-sub --sub-lang en --skip-download "URL_DO_VIDEO"
Passo 3: Legendas automáticas (fallback)
yt-dlp --write-auto-sub --sub-lang pt --skip-download "URL_DO_VIDEO"
Passo 4: Converter VTT para texto
# Remover timestamps do arquivo VTT
sed '/^[0-9]/d; /^$/d; /-->/d' legenda.pt.vtt > transcricao.txt
Processamento da Saída
Remoção de duplicatas
Legendas automáticas costumam ter muitas duplicatas devido a legendas progressivas:
# Remover linhas duplicadas
visto = set()
linhas_unicas = []
for linha in linhas:
if linha not in visto:
visto.add(linha)
linhas_unicas.append(linha)
Geração de resumo
Com as legendas extraídas:
- Resumo do conteúdo principal
- Criação de capítulos por timestamp
- Extração de palavras-chave
Exemplos
Exemplo 1: Resumo de vídeo de aula
Usuário: Resuma esta aula do YouTube - https://youtube.com/watch?v=xxx
Claude:
1. Baixar legendas com yt-dlp
2. Converter VTT → texto
3. Gerar resumo do conteúdo principal
4. Fornecer índice por timestamps
Exemplo 2: Extração de legendas em múltiplos idiomas
Usuário: Extraia as legendas em inglês e português deste vídeo
Claude:
1. Verificar idiomas disponíveis com --list-subs
2. Baixar legendas de cada idioma
3. Fornecer arquivos de texto organizados
Tratamento de Erros
| Erro | Causa | Solução |
|---|---|---|
yt-dlp not found | Não instalado | Instalar via brew/apt/pip |
No subtitles available | Sem legendas | Sugerir uso do Whisper |
Invalid URL | URL inválida | Verificar formato da URL |
Video unavailable | Vídeo privado/excluído | Informar o usuário |
Fallback com Whisper
Quando não há legendas disponíveis (necessita confirmação do usuário):
# Verificar tamanho do arquivo
yt-dlp --print filesize "URL_DO_VIDEO"
# Baixar áudio após aprovação do usuário
yt-dlp -x --audio-format mp3 "URL_DO_VIDEO"
# Converter com Whisper
whisper audio.mp3 --language pt --model base
Atenção: Requer largura de banda/tempo de processamento – é necessária confirmação do usuário.