Ferramenta de Conteúdo do YouTube
Quando usar
Use quando o usuário compartilhar uma URL do YouTube ou link de vídeo, pedir para resumir um vídeo, solicitar uma transcrição ou quiser extrair e reformatar o conteúdo de qualquer vídeo do YouTube. Transforma transcrições em conteúdo estruturado (capítulos, resumos, threads, posts de blog).
Extrai transcrições de vídeos do YouTube e as converte em formatos úteis.
Configuração
Use uv para instalar a dependência no mesmo ambiente gerenciado pelo Hermes que executa o script auxiliar:
uv pip install youtube-transcript-api
Script Auxiliar
SKILL_DIR é o diretório que contém este arquivo SKILL.md. O script aceita qualquer formato de URL padrão do YouTube, links curtos (youtu.be), shorts, embeds, links ao vivo ou um ID de vídeo bruto de 11 caracteres.
# Saída JSON com metadados
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"
# Texto simples (ideal para canalizar para processamento adicional)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only
# Com timestamps
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps
# Idioma específico com cadeia de fallback
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en
Formatos de Saída
Após buscar a transcrição, formate-a conforme solicitado pelo usuário:
- Capítulos: Agrupar por mudanças de tópico, gerar lista de capítulos com timestamps
- Resumo: Visão geral concisa de 5 a 10 frases de todo o vídeo
- Resumos de capítulos: Capítulos com um breve parágrafo de resumo para cada um
- Thread: Formato de thread do Twitter/X — posts numerados, cada um com menos de 280 caracteres
- Post de blog: Artigo completo com título, seções e principais conclusões
- Citações: Citações notáveis com timestamps
Exemplo — Saída de Capítulos
00:00 Introdução — o apresentador abre com a declaração do problema
03:45 Contexto — trabalhos anteriores e por que as soluções existentes são insuficientes
12:20 Método principal — explicação passo a passo da abordagem proposta
24:10 Resultados — comparações de benchmark e principais conclusões
31:55 Perguntas e respostas — perguntas da audiência sobre escalabilidade e próximos passos
Fluxo de Trabalho
- Buscar a transcrição usando o script auxiliar com
--text-only --timestampsviauv run python3. - Validar: confirmar que a saída não está vazia e está no idioma esperado. Se estiver vazia, tentar novamente sem
--languagepara obter qualquer transcrição disponível. Se ainda estiver vazia, informar ao usuário que o vídeo provavelmente tem transcrições desativadas. - Dividir se necessário: se a transcrição exceder ~50 mil caracteres, dividir em partes sobrepostas (~40 mil com sobreposição de 2 mil) e resumir cada parte antes de fundir.
- Transformar no formato de saída solicitado. Se o usuário não especificou um formato, o padrão é um resumo.
- Verificar: reler a saída transformada para verificar coerência, timestamps corretos e completude antes de apresentar.
Tratamento de Erros
- Transcrição desativada: informar o usuário; sugerir que ele verifique se as legendas estão disponíveis na página do vídeo.
- Vídeo privado/indisponível: relatar o erro e pedir ao usuário que verifique a URL.
- Nenhum idioma correspondente: tentar novamente sem
--languagepara buscar qualquer transcrição disponível e, em seguida, informar o idioma real ao usuário. - Dependência ausente: executar
uv pip install youtube-transcript-apie tentar novamente.