youtube-summarizer
Propósito
Esta skill extrai transcrições de vídeos do YouTube e gera resumos abrangentes e detalhados utilizando 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 foi projetada para usuários que precisam de análise aprofundada 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", "sintetizar" ou "extrair conteúdo" de vídeos do YouTube
- O usuário deseja documentação abrangente priorizando completude em vez de brevidade
Etapa 0: Descoberta e Configuração
Antes de processar vídeos, valide o ambiente e as dependências:
# Verificar se o 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
Verifique a instalação:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api instalado com sucesso')"
Fluxo de Trabalho Principal
Diretrizes de Acompanhamento de Progresso
Ao longo do 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 o 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 da Transcrição
Progresso:
echo "[████████░░░░░░░░░░░░] 40% - Etapa 2/5: Verificando Disponibilidade"
Objetivo: Verificar se o vídeo existe e se 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"❌ As transcrições estão desativadas 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" | Pedir ao usuário para verificar a URL |
| Transcrições desativadas | "❌ As transcrições estão desativadas 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" | Solicitar 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 a transcrição no idioma preferido do usuário primeiro
# Recorrer ao inglês se não estiver disponível
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Preferir português, fallback 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 um 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:
Use 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 abrangente de sumarização
- Usar o modelo de IA (Claude/GPT) para gerar o 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 abrangente em Markdown
# 4. Estruturar com cabeçalhos, listas e destaques
Read "$TRANSCRIPT_FILE" # Ler transcrição no contexto
Em seguida, aplique 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 continuada...]
## 📚 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 de instalá-la 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 concluída! 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 aborda 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 continuado ...]
**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 de especialistas.
- Pare e peça esclarecimentos se as entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.