youtube-summarizer
Propósito
Esta skill extrai transcrições de vídeos do YouTube e gera resumos abrangentes e detalhados usando o framework STAR + R-I-S-E. Ela valida a disponibilidade do vídeo, extrai a transcrição usando a biblioteca Python youtube-transcript-api e produz documentação detalhada capturando todos os insights, argumentos e pontos-chave.
A skill é projetada para usuários que precisam de análise completa de conteúdo e documentação de referência a partir de vídeos educacionais, palestras, tutoriais ou conteúdo informativo.
Quando Usar Esta Skill
Esta skill deve ser usada quando:
- O usuário fornece uma URL de vídeo do YouTube e deseja um resumo detalhado
- O usuário precisa documentar o conteúdo do vídeo para referência sem reassisti-lo
- O usuário deseja extrair insights, pontos-chave e argumentos de conteúdo educacional
- O usuário precisa de transcrições de vídeos do YouTube para análise
- O usuário pede para "resumir", "sumarizar" ou "extrair conteúdo" de vídeos do YouTube
- O usuário deseja documentação abrangente priorizando completude sobre brevidade
Etapa 0: Descoberta e Configuração
Antes de processar vídeos, valide o ambiente e as dependências:
# Verificar se youtube-transcript-api está instalado
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api não encontrado"
# Oferecer para instalar
fi
# Verificar disponibilidade do Python
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3 é necessário mas não está instalado"
exit 1
fi
Pergunte ao usuário se a dependência estiver faltando:
youtube-transcript-api é necessário mas não está instalado.
Gostaria de instalá-lo agora?
- [ ] Sim - Instalar com pip (pip install youtube-transcript-api)
- [ ] Não - Instalarei manualmente
Se o usuário selecionar "Sim":
pip install youtube-transcript-api
Verificar instalação:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api instalado com sucesso')"
Fluxo de Trabalho Principal
Diretrizes de Acompanhamento de Progresso
Durante todo o fluxo de trabalho, exiba um indicador visual de progresso antes de cada etapa para manter o usuário informado. O formato do indicador é:
echo "[████░░░░░░░░░░░░░░░░] 20% - Etapa 1/5: Validando URL"
Especificações de formato:
- 20 caracteres de largura (use █ para preenchido, ░ para vazio)
- Incrementos percentuais: Etapa 1=20%, Etapa 2=40%, Etapa 3=60%, Etapa 4=80%, Etapa 5=100%
- Contador de etapas mostrando atual/total (ex.: "Etapa 3/5")
- Breve descrição da fase atual
Exiba a caixa de status inicial antes da Etapa 1:
╔══════════════════════════════════════════════════════════════╗
║ 📹 YOUTUBE SUMMARIZER - Processando Vídeo ║
╠══════════════════════════════════════════════════════════════╣
║ → Etapa 1: Validando URL [EM ANDAMENTO] ║
║ ○ Etapa 2: Verificando Disponibilidade ║
║ ○ Etapa 3: Extraindo Transcrição ║
║ ○ Etapa 4: Gerando Resumo ║
║ ○ Etapa 5: Formatando Saída ║
╠══════════════════════════════════════════════════════════════╣
║ Progresso: ██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
Etapa 1: Validar URL do YouTube
Objetivo: Extrair o ID do vídeo e validar o formato da URL.
Formatos de URL Suportados:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://m.youtube.com/watch?v=VIDEO_ID
Ações:
# Extrair ID do vídeo usando regex ou análise de URL
URL="$USER_PROVIDED_URL"
# Padrão 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Padrão 2: youtu.be/VIDEO_ID
elif echo "$URL" | grep -qE 'youtu\.be/'; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
echo "❌ Formato de URL do YouTube inválido"
exit 1
fi
echo "📹 ID do vídeo extraído: $VIDEO_ID"
Se a URL for inválida:
❌ URL do YouTube inválida
Por favor, forneça uma URL válida do YouTube em um destes formatos:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Exemplo: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Etapa 2: Verificar Disponibilidade do Vídeo e Transcrição
Progresso:
echo "[████████░░░░░░░░░░░░] 40% - Etapa 2/5: Verificando Disponibilidade"
Objetivo: Verificar se o vídeo existe e a transcrição está acessível.
Ações:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# Obter lista de transcrições disponíveis
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ Vídeo acessível: {video_id}")
print("📝 Transcrições disponíveis:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [Gerada automaticamente]")
except TranscriptsDisabled:
print(f"❌ Transcrições estão desabilitadas para o vídeo {video_id}")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ Nenhuma transcrição encontrada para o vídeo {video_id}")
sys.exit(1)
except Exception as e:
print(f"❌ Erro ao acessar o vídeo: {e}")
sys.exit(1)
Tratamento de Erros:
| Erro | Mensagem | Ação |
|---|---|---|
| Vídeo não encontrado | "❌ O vídeo não existe ou é privado" | Perguntar ao usuário para verificar a URL |
| Transcrições desabilitadas | "❌ Transcrições estão desabilitadas para este vídeo" | Não é possível prosseguir |
| Nenhuma transcrição disponível | "❌ Nenhuma transcrição encontrada (não gerada automaticamente ou adicionada manualmente)" | Não é possível prosseguir |
| Vídeo privado/restrito | "❌ O vídeo é privado ou restrito" | Pedir um vídeo público |
Etapa 3: Extrair Transcrição
Progresso:
echo "[████████████░░░░░░░░] 60% - Etapa 3/5: Extraindo Transcrição"
Objetivo: Recuperar a transcrição no idioma preferido.
Ações:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# Tentar obter transcrição no idioma preferido do usuário primeiro
# Voltar para inglês se não estiver disponível
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Preferir português, voltar para inglês
)
# Combinar segmentos da transcrição em texto completo
full_text = " ".join([entry['text'] for entry in transcript])
# Obter metadados do vídeo
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ Transcrição extraída com sucesso")
print(f"📊 Tamanho da transcrição: {len(full_text)} caracteres")
# Salvar em arquivo temporário para processamento
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ Erro ao extrair transcrição: {e}")
exit(1)
Processamento da Transcrição:
- Combinar todos os segmentos da transcrição em texto coerente
- Preservar pontuação e formatação quando disponível
- Remover segmentos duplicados ou sobrepostos (se artefatos de geração automática)
- Armazenar em arquivo temporário para análise
Etapa 4: Gerar Resumo Abrangente
Progresso:
echo "[████████████████░░░░] 80% - Etapa 4/5: Gerando Resumo"
Objetivo: Aplicar o prompt aprimorado STAR + R-I-S-E para criar um resumo detalhado.
Prompt Aplicado:
Usar o prompt aprimorado da Fase 2 (framework STAR + R-I-S-E) com a transcrição extraída como entrada.
Ações:
- Carregar o texto completo da transcrição
- Aplicar o prompt de sumarização abrangente
- Usar modelo de IA (Claude/GPT) para gerar resumo estruturado
- Garantir que a saída siga a estrutura definida:
- Cabeçalho com metadados do vídeo
- Síntese executiva
- Detalhamento seção por seção
- Principais insights e conclusões
- Conceitos e terminologia
- Recursos e referências
Implementação:
# Usar o arquivo de transcrição como entrada para o prompt de IA
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# O agente de IA irá:
# 1. Ler a transcrição
# 2. Aplicar o framework de sumarização STAR + R-I-S-E
# 3. Gerar saída Markdown abrangente
# 4. Estruturar com cabeçalhos, listas e destaques
Ler "$TRANSCRIPT_FILE" # Ler transcrição no contexto
Em seguida, aplicar o prompt completo de sumarização (da versão aprimorada na Fase 2).
Etapa 5: Formatar e Apresentar a Saída
Progresso:
echo "[████████████████████] 100% - Etapa 5/5: Formatando Saída"
Objetivo: Entregar o resumo em Markdown limpo e bem estruturado.
Estrutura da Saída:
# [Título do Vídeo]
**Canal:** [Nome do Canal]
**Duração:** [Duração]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**Data de Publicação:** [Data se disponível]
## 📝 Resumo Detalhado
### [Tópico 1]
[Explicação abrangente com exemplos, dados, citações...]
#### [Subtópico 1.1]
[Detalhamento...]
### [Tópico 2]
[Análise detalhada continua...]
## 📚 Conceitos e Terminologia
- **[Termo 1]:** [Definição e contexto]
- **[Termo 2]:** [Definição e contexto]
## 📌 Conclusão
[Síntese final e conclusões]
Exemplo 2: Dependência Ausente
Entrada do Usuário:
claude> resuma este vídeo do youtube https://youtu.be/abc123
Resposta da Skill:
⚠️ youtube-transcript-api não instalado
Esta skill requer a biblioteca Python 'youtube-transcript-api'.
Gostaria que eu a instalasse agora?
- [ ] Sim - Instalar com pip
- [ ] Não - Instalarei manualmente
Usuário seleciona "Sim":
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ Instalação completa! Prosseguindo com o resumo do vídeo...
Exemplo 4: URL Inválida
Entrada do Usuário:
claude> resuma vídeo do youtube www.youtube.com/some-video
Resposta da Skill:
❌ Formato de URL do YouTube inválido
Exemplos de formato esperado:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
Por favor, forneça uma URL de vídeo do YouTube válida.
📊 Resumo Executivo
Este vídeo fornece uma introdução abrangente aos conceitos fundamentais de Inteligência Artificial (IA), projetado para iniciantes e profissionais que desejam entender os fundamentos técnicos e as aplicações práticas da IA moderna. O instrutor cobre desde definições básicas até algoritmos de aprendizado de máquina, usando exemplos práticos e visualizações para facilitar a compreensão.
[... resumo detalhado continua ...]
**Opções de Salvamento:**
O que gostaria de salvar? → Resumo + transcrição bruta
✅ Arquivo salvo: resumo-exemplo123-2026-02-01.md (inclui transcrição bruta) [████████████████████] 100% - ✓ Processamento concluído!
Bem-vindo a este tutorial abrangente sobre fundamentos de aprendizado de máquina. No vídeo de hoje, exploraremos os conceitos principais que alimentam os sistemas modernos de IA...
Versão: 1.2.0 Última Atualização: 2026-02-02 Mantido por: Eric Andrade
Limitações
- Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
- Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.