Skill de Resumidor do YouTube
Busca automaticamente transcrições de vídeos do YouTube, gera resumos estruturados e entrega transcrições completas para plataformas de mensagens.
Modo
Detecte pelo contexto ou pergunte: "Resumo rápido, resumo completo ou resumo completo com ângulos de conteúdo?"
| Modo | O que você obtém | Melhor para |
|---|---|---|
quick | TL;DR de 3 marcadores + um insight principal | Consumo rápido, compartilhar um clipe |
standard | Resumo estruturado completo: tese, insights, conclusão | Aprendizado, anotações, pesquisa |
deep | Resumo completo + divisão por capítulos + oportunidades de reaproveitamento | Transformar um vídeo em ativo de conteúdo |
Padrão: standard — use quick se quiser apenas a ideia geral. Use deep se quiser extrair o vídeo em conteúdo utilizável.
Por que esta skill vs ChatGPT?
Problema com o ChatGPT: Ele não consegue acessar transcrições do YouTube diretamente. Você precisa copiar/colar legendas manualmente ou usar uma ferramenta de terceiros primeiro, depois alimentar o texto no ChatGPT. Várias etapas, complicado, perde metadados do vídeo.
Esta skill oferece:
- Extração de transcrição em uma etapa - Cole uma URL do YouTube, obtenha a transcrição completa automaticamente
- Sumarização estruturada - Formato consistente (tese → insights → conclusão) sempre, não tópicos aleatórios
- Metadados do vídeo incluídos - Título, canal, visualizações, data de publicação embutidos no resumo
- Entrega da transcrição completa - Salva transcrição com timestamps em arquivo e envia para Telegram/plataformas de chat
- Funciona a partir de VPS/nuvem - Usa emulação de cliente Android para contornar o bloqueio de IP em nuvem do YouTube (onde yt-dlp falha)
- Suporte a múltiplos idiomas - Busca automaticamente no idioma solicitado com fallback para inglês
Você pode replicar isso ativando legendas manualmente, copiando o texto, colando no ChatGPT, reformatando a saída, salvando em arquivo e enviando. Leva de 5 a 10 minutos. Esta skill faz em 15 a 20 segundos.
Quando Usar
Ative esta skill quando:
- O usuário compartilhar uma URL do YouTube (youtube.com/watch, youtu.be, youtube.com/shorts)
- O usuário pedir para resumir ou transcrever um vídeo do YouTube
- O usuário solicitar informações sobre o conteúdo de um vídeo do YouTube
- Você precisar analisar conteúdo de vídeo para pesquisa ou criação de conteúdo
Dependências
Obrigatório: O servidor MCP YouTube Transcript deve estar instalado em:
/root/clawd/mcp-server-youtube-transcript
Se não estiver presente, instale:
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build
Fluxo de Trabalho
1. Detectar URL do YouTube
Extraia o ID do vídeo a partir destes padrões:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://www.youtube.com/shorts/VIDEO_ID- ID do vídeo direto:
VIDEO_ID(11 caracteres)
2. Buscar Transcrição
Execute este comando para obter a transcrição:
cd /root/clawd/mcp-server-youtube-transcript && node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'VIDEO_ID', lang: 'en' });
console.log(JSON.stringify(result, null, 2));
" > /tmp/yt-transcript.json
Substitua VIDEO_ID pelo ID extraído. Leia a saída de /tmp/yt-transcript.json.
3. Processar os Dados
Analise o JSON para extrair:
result.metadata.title- Título do vídeoresult.metadata.author- Nome do canalresult.metadata.viewCount- Contagem de visualizações formatadaresult.metadata.publishDate- Data de publicaçãoresult.actualLang- Idioma utilizadoresult.lines- Array de segmentos da transcrição
Texto completo: result.lines.map(l => l.text).join(' ')
4. Gerar Resumo
Crie um resumo estruturado usando este modelo:
📹 **Vídeo:** [title]
👤 **Canal:** [author] | 👁️ **Visualizações:** [views] | 📅 **Publicado:** [date]
**🎯 Tese Principal:**
[1-2 frases do argumento/mensagem central]
**💡 Insights Essenciais:**
- [insight 1]
- [insight 2]
- [insight 3]
- [insight 4]
- [insight 5]
**📝 Pontos Notáveis:**
- [ponto adicional 1]
- [ponto adicional 2]
**🔑 Conclusão:**
[Aplicação prática ou conclusão]
Busque por:
- Tese principal: máximo de 1-2 frases
- Insights essenciais: 3-5 marcadores, cada um com 1-2 frases
- Pontos notáveis: 2-4 detalhes de suporte
- Conclusão: conclusão acionável
5. Salvar Transcrição Completa
Salve a transcrição completa em um arquivo com timestamp:
/root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt
Inclua no arquivo:
- Cabeçalho de metadados do vídeo (título, canal, URL, data)
- Texto completo da transcrição
- Referência da URL para fácil consulta
6. Entrega Específica por Plataforma
Se o canal for Telegram:
message --action send --channel telegram --target CHAT_ID \
--filePath /root/clawd/transcripts/YYYY-MM-DD_VIDEO_ID.txt \
--caption "📄 Transcrição do YouTube: [title]"
Se o canal for outro/webchat: Apenas responda com o resumo (sem anexo de arquivo).
7. Responder com Resumo
Envie o resumo estruturado como sua resposta ao usuário.
Caso de Estudo Real
Usuário: Criador de conteúdo pesquisando estratégias de concorrentes no YouTube
Desafio: Precisava analisar mais de 20 vídeos de concorrentes por semana para identificar tópicos em alta, padrões de mensagens e lacunas de conteúdo. Processo manual: assistir vídeo, fazer anotações, transcrever citações-chave. Tempo: 30-45 min por vídeo.
Solução com youtube-summarizer:
- Cole a URL do YouTube no chat
- Obtenha resumo estruturado em 20 segundos
- Transcrição completa salva para referência
- Copie insights essenciais para documento de planejamento de conteúdo
Exemplo de fluxo de trabalho:
Usuário: Analise este vídeo: https://youtube.com/watch?v=abc123
[20 segundos depois]
📹 Vídeo: "10 Ferramentas de IA Que Substituirão Seu Emprego em 2026"
👤 Canal: TechFuturist | 👁️ Visualizações: 847K | 📅 Publicado: 12/jan/2026
🎯 Tese Principal:
Ferramentas de IA estão automatizando o trabalho criativo e de conhecimento mais rápido do que o esperado, mas a verdadeira oportunidade está na aumento, não na substituição.
💡 Insights Essenciais:
- O uso do ChatGPT entre profissionais de marketing saltou de 12% para 67% em um ano
- O tempo de edição de vídeo foi reduzido em 80% usando ferramentas de IA como Descript
- Os maiores ganhos vêm da combinação de ferramentas (Notion + Claude + Zapier)
- Empresas estão contratando "designers de fluxo de trabalho de IA" para otimizar a colaboração humano-IA
- Trabalhadores que usam IA secretamente superam colegas em 40% (estudo da BCG)
📝 Pontos Notáveis:
- Mostra exemplos de 3 pequenas empresas que multiplicaram por 10 a produção com IA
- Alerta contra a automação excessiva: "IA pode escrever, mas não pode pensar estrategicamente"
🔑 Conclusão:
Não pergunte "A IA vai me substituir?" Pergunte "Como posso usar a IA para me tornar 10× mais valioso?"
Resultados após 8 semanas:
- Tempo economizado: 25 horas/semana (de 600 min para 60 min para 20 vídeos)
- Produção de conteúdo: 3 vídeos/semana (aumento de 1/semana)
- Melhores insights: Transcrições completas pesquisáveis, encontrou padrões perdidos ao apenas assistir
- Inteligência competitiva: Construiu banco de dados com mais de 160 resumos de vídeos de concorrentes com citações-chave
- Citação de ROI: "Esta skill transformou a pesquisa de concorrentes de uma tarefa árdua em uma linha de produção."
Por Que Isso Supera Métodos Manuais
| Método | Tempo | Obtém Metadados | Saída Estruturada | Arquivo Pesquisável | Amigável para Nuvem |
|---|---|---|---|---|---|
| Assistir + fazer anotações | 30-45 min | Não | Não | Apenas manual | N/A |
| Recurso de transcrição do YouTube | 5 min | Não | Não | Não | Sim |
| yt-dlp | 2-5 min | Sim | Não | Sim | ❌ Bloqueado em VPS |
| Copiar para ChatGPT | 10 min | Não | Às vezes | Não | Sim |
| Esta skill | 20 seg | Sim | Sim | Sim | ✅ Funciona em VPS |
Tratamento de Erros
Se a busca da transcrição falhar:
- Verifique se o vídeo tem legendas ativadas
- Tente com fallback
lang: 'en'se o idioma solicitado não estiver disponível - Informe o usuário que a transcrição não está disponível e sugira alternativas:
- Recurso de transcrição manual do YouTube (Configurações → Mostrar transcrição)
- O vídeo pode não ter legendas
- Tente um vídeo diferente
Se o servidor MCP não estiver instalado:
- Forneça instruções de instalação
- Ofereça-se para instalá-lo automaticamente se estiver em contexto apropriado
Se a extração do ID do vídeo falhar:
- Peça ao usuário para fornecer a URL completa do YouTube ou o ID do vídeo
Se o vídeo tiver restrição de idade ou for privado:
- Informe o usuário que a transcrição não pode ser acessada devido a restrições
- Sugira verificar as configurações de privacidade do vídeo
Exemplos
Exemplo 1: Tutorial de Tecnologia
Entrada: https://youtube.com/watch?v=dQw4w9WgXcQ
Saída:
📹 **Vídeo:** "Construindo um SaaS do Zero: Lições de $10K MRR"
👤 **Canal:** IndieHackerTV | 👁️ **Visualizações:** 124K | 📅 **Publicado:** 1/fev/2026
**🎯 Tese Principal:**
A maioria dos fundadores de SaaS falha porque constroem por 6 meses antes de conversar com clientes. O caminho para $10K MRR são conversas com clientes primeiro, MVP depois.
**💡 Insights Essenciais:**
- Entrevistou 50 clientes em potencial antes de escrever uma única linha de código
- O primeiro cliente pagante se inscreveu com um mockup do Figma (nenhum produto construído ainda)
- Cobrou $99/mês desde o primeiro dia (sem nível gratuito, sem descontos)
- Gastou $0 em anúncios; todo o crescimento veio do envolvimento no Twitter + Reddit
- Atingiu $10K MRR em 9 meses dizendo "não" a solicitações de funcionalidades que não se encaixavam no ICP
📝 **Pontos Notáveis:**
- Usou links de pagamento do Stripe antes de construir um sistema de cobrança
- Os primeiros 3 clientes vieram da resolução de seus problemas em público no Twitter
- Atualizações semanais "construindo em público" no Twitter geraram 40% das inscrições
🔑 **Conclusão:**
Valide a demanda antes de construir. Se 10 pessoas não pagarem por um mockup, 1.000 não pagarão pelo produto real.
Exemplo 2: Vídeo de Estratégia de Negócios
Entrada: https://youtu.be/abc123xyz
Saída:
📹 **Vídeo:** "Por que o Modelo de Negócios da Notion é Genial"
👤 **Canal:** SaaS Breakdowns | 👁️ **Visualizações:** 456K | 📅 **Publicado:** 28/jan/2026
**🎯 Tese Principal:**
A estratégia de crescimento da Notion inverte o SaaS tradicional: dê o produto de graça para indivíduos, monetize quando eles o trouxerem para o trabalho.
**💡 Insights Essenciais:**
- 80% dos negócios empresariais da Notion começaram com um único funcionário usando o plano gratuito
- Adoção de baixo para cima = nenhuma equipe de vendas necessária para os primeiros $10M ARR
- O mercado de templates criou um volante de conteúdo (mais de 100K templates gratuitos)
- Taxa de conversão de uso pessoal (gratuito) para uso em equipe (pago): 23% (média do setor: 2-5%)
- O evangelismo da comunidade substituiu o marketing tradicional (mais de 4M de membros no Reddit/Discord)
📝 **Pontos Notáveis:**
- Coeficiente viral da Notion: 1,4 (cada usuário convida em média 1,4 outros)
- Criadores de templates geram 30% da aquisição de novos usuários
- Estratégia de preços: gratuito até 10 pessoas = sem atrito para começar
🔑 **Conclusão:**
Construa um produto que os indivíduos amem primeiro. As vendas empresariais seguirão quando os funcionários o exigirem no trabalho.
Diretrizes de Qualidade
- Seja conciso: O resumo deve ser escaneável em 30 segundos
- Seja preciso: Não adicione informações que não estão na transcrição
- Seja estruturado: Use formatação consistente para facilitar a leitura
- Seja contextual: Ajuste o nível de detalhe com base na duração do vídeo
- Vídeos curtos (<5 min): Resumo breve (3 insights essenciais)
- Vídeos médios (5-30 min): Formato padrão (5 insights essenciais)
- Vídeos longos (>30 min): Análise detalhada (7+ insights, divida em seções se necessário)
- Extraia valor: Concentre-se em insights acionáveis, pontos de dados e opiniões contrárias (não conselhos genéricos)
Dicas Profissionais
Para Melhores Resumos:
- Priorize pontos de dados - Números, porcentagens, citações de estudos se destacam
- Extraia citações - Frases marcantes tornam os resumos compartilháveis
- Identifique frameworks - Se o vídeo apresentar um método/processo, extraia as etapas
- Identifique opiniões contrárias - Sabedoria não convencional é mais valiosa do que conselhos comuns
- Observe provas - Exemplos, estudos de caso, resultados antes/depois adicionam credibilidade
Para Fluxos de Trabalho de Pesquisa:
- Construa uma biblioteca de transcrições - Organize por tópico/niche para identificação de padrões
- Pesquise entre transcrições - Use
grepou pesquisa de texto para encontrar menções a tópicos específicos - Acompanhe tendências - Mesmo tópico em vários vídeos = tendência em ascensão
- Extraia prompts - Salve frameworks/métodos úteis como prompts reutilizáveis
Para Criação de Conteúdo:
- Encontre lacunas de conteúdo - Que perguntas são feitas, mas não são totalmente respondidas?
- Analise os de melhor desempenho - Que estrutura/ritmo os vídeos de alto número de visualizações usam?
- Extraia ganchos - Os primeiros 30 segundos da transcrição = padrões comprovados de ganchos
- Reaproveite insights - Transforme insights de vídeo em threads no Twitter, postagens de blog, newsletters
Configuração
Modo Padrão (padrão)
youtube-summarizer [URL]
- Busca transcrição em inglês
- Gera resumo estruturado
- Salva transcrição em arquivo
- Envia para plataforma de mensagens, se aplicável
Modo Rápido
youtube-summarizer [URL] --quick
- Apenas tese + 3 insights essenciais
- Nenhum arquivo de transcrição salvo
- Processamento mais rápido para pesquisa rápida
Modo de Análise Aprofundada
youtube-summarizer [URL] --deep
- Resumo estendido com timestamps
- Divisão seção por seção para vídeos longos
- Inclui todas as citações notáveis
Específico por Idioma
youtube-summarizer [URL] --lang es
- Busca transcrição no idioma especificado
- Faz fallback para inglês se indisponível
Instalação e Configuração
# 1. Clone e instale o servidor MCP
cd /root/clawd
git clone https://github.com/kimtaeyoon83/mcp-server-youtube-transcript.git
cd mcp-server-youtube-transcript
npm install && npm run build
# 2. Teste a instalação
node --input-type=module -e "
import { getSubtitles } from './dist/youtube-fetcher.js';
const result = await getSubtitles({ videoID: 'dQw4w9WgXcQ', lang: 'en' });
console.log(result.metadata.title);
"
# 3. Crie o diretório de transcrições
mkdir -p /root/clawd/transcripts
# 4. Verifique se a skill está pronta
youtube-summarizer --check-setup
Problemas Comuns
Problema: "Transcrição não disponível"
- Causa: O vídeo não tem legendas/subtítulos ativados
- Solução: Peça ao criador do vídeo para ativar as legendas ou tente um vídeo diferente
Problema: "Falha ao buscar transcrição" (em VPS)
- Causa: O YouTube pode ter atualizado sua API
- Solução: Atualize o servidor MCP:
cd /root/clawd/mcp-server-youtube-transcript && git pull && npm install && npm run build
Problema: "ID do vídeo não reconhecido"
- Causa: URL mal formatada ou formato não suportado
- Solução: Peça ao usuário para fornecer a URL completa ou o ID de 11 caracteres
Problema: "Vídeo com restrição de idade"
- Causa: O YouTube exige login para conteúdo com restrição de idade
- Solução: Não é possível acessar a transcrição; informe o usuário
Observação Final
Enquanto ferramentas como transcript.chat e Reccloud oferecem serviços de transcrição, este skill é totalmente gratuito, de código aberto e opera inteiramente dentro do seu ambiente de agente de IA. Não há taxas de API, limites de taxa ou restrições de terceiros.
Através do servidor MCP, este skill contorna os bloqueios do YouTube que afetam ferramentas como yt-dlp em ambientes de nuvem, emulando um cliente Android para garantir que as transcrições sejam sempre recuperáveis em VPS, servidores dedicados e computação sem servidor.