youtube-summarizer

Propósito

Esta habilidade extrai transcrições de vídeos do YouTube e gera resumos abrangentes e detalhados usando a estrutura STAR + R-I-S-E. Ela valida a disponibilidade do vídeo, extrai transcrições usando a biblioteca Python youtube-transcript-api e produz documentação detalhada capturando todos os insights, argumentos e pontos-chave.

A habilidade é projetada para usuários que precisam de análise de conteúdo completa e documentação de referência de vídeos educacionais, palestras, tutoriais ou conteúdo informativo.

Quando Usar Esta Habilidade

Esta habilidade deve ser usada quando:

• O usuário fornece um 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 assistir novamente
• 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", "fazer um resumo" ou "extrair conteúdo" de vídeos do YouTube
• O usuário deseja documentação abrangente priorizando a completude em vez da brevidade

Passo 0: Descoberta e Configuração

Antes de processar vídeos, valide o ambiente e as dependências:

# Check if youtube-transcript-api is installed
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  youtube-transcript-api not found"
    # Offer to install
fi

# Check Python availability
if ! command -v python3 &>/dev/null; then
    echo "❌ Python 3 is required but not installed"
    exit 1
fi

Pergunte ao usuário se a dependência está faltando:

youtube-transcript-api is required but not installed.

Would you like to install it now?
- [ ] Yes - Install with pip (pip install youtube-transcript-api)
- [ ] No - I'll install it manually

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 installed successfully')"

Fluxo de Trabalho Principal

Diretrizes de Rastreamento de Progresso

Ao longo do fluxo de trabalho, exiba um medidor de progresso visual antes de cada etapa para manter o usuário informado. O formato do medidor é:

echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: Validating URL"

Especificações do formato:

• 20 caracteres de largura (use █ para preenchido, ░ para vazio)
• Incrementos de porcentagem: Etapa 1=20%, Etapa 2=40%, Etapa 3=60%, Etapa 4=80%, Etapa 5=100%
• Contador de etapas mostrando atual/total (por exemplo, "Etapa 3/5")
• Breve descrição da fase atual

Exiba a caixa de status inicial antes da Etapa 1:

╔══════════════════════════════════════════════════════════════╗
║     📹  YOUTUBE SUMMARIZER - Processing Video                ║
╠══════════════════════════════════════════════════════════════╣
║ → Step 1: Validating URL                 [IN PROGRESS]       ║
║ ○ Step 2: Checking Availability                              ║
║ ○ Step 3: Extracting Transcript                              ║
║ ○ Step 4: Generating Summary                                 ║
║ ○ Step 5: Formatting Output                                  ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%               ║
╚══════════════════════════════════════════════════════════════╝

Etapa 1: Validar URL do YouTube

Objetivo: Extrair o ID do vídeo e validar o formato do URL.

Formatos de URL Suportados:

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://m.youtube.com/watch?v=VIDEO_ID

Ações:

# Extract video ID using regex or URL parsing
URL="$USER_PROVIDED_URL"

# Pattern 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/')
# Pattern 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 "❌ Invalid YouTube URL format"
    exit 1
fi

echo "📹 Video ID extracted: $VIDEO_ID"

Se o URL for inválido:

❌ Invalid YouTube URL

Please provide a valid YouTube URL in one of these formats:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

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

Etapa 2: Verificar Disponibilidade do Vídeo e Transcrição

Progresso:

echo "[████████░░░░░░░░░░░░] 40% - Step 2/5: Checking Availability"

Objetivo: Verificar se o vídeo existe e se a transcrição está acessível.

Ações:

…