Communitygithub.com

ever-just/agentskills

Busca automaticamente transcrições de vídeos do YouTube, gera resumos estruturados e envia transcrições completas para plataformas de mensagens. Detecta URLs do YouTube e fornece metadados, insights essenciais e transcrições para download.

O que é agentskills?

Esta skill especializada para agentes de IA (como Claude Code, Cursor ou Codex) automatiza completamente a extração e sumarização de transcrições de vídeos do YouTube. Ao receber uma URL do YouTube, a skill detecta o ID do vídeo, utiliza o servidor MCP `mcp-server-youtube-transcript` para buscar a transcrição com timestamps e metadados (título, canal, visualizações, data), e gera um resumo estruturado em três modos: rápido (TL;DR de 3 marcadores), padrão (resumo completo com tese, insights e conclusão) ou profundo (com análise por capítulos e oportunidades de reaproveitamento). Além disso, salva a transcrição completa em um arquivo com timestamp e, se configurada, a envia para plataformas como Telegram. A skill contorna bloqueios de IP em servidores VPS usando emulação de cliente Android, suporta múltiplos idiomas com fallback para inglês, e é ideal para pesquisadores, criadores de conteúdo e profissionais que precisam analisar dezenas de vídeos por semana, reduzindo o tempo de análise de 30-45 minutos para apenas 20 segundos por vídeo.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ever-just/agentskills/tree/HEAD/skills/white-paper-writing/ai-marketing-skills/youtube-summarizer

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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?"

ModoO que você obtémMelhor para
quickTL;DR de 3 marcadores + um insight principalConsumo rápido, compartilhar um clipe
standardResumo estruturado completo: tese, insights, conclusãoAprendizado, anotações, pesquisa
deepResumo completo + divisão por capítulos + oportunidades de reaproveitamentoTransformar 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:

  1. Extração de transcrição em uma etapa - Cole uma URL do YouTube, obtenha a transcrição completa automaticamente
  2. Sumarização estruturada - Formato consistente (tese → insights → conclusão) sempre, não tópicos aleatórios
  3. Metadados do vídeo incluídos - Título, canal, visualizações, data de publicação embutidos no resumo
  4. Entrega da transcrição completa - Salva transcrição com timestamps em arquivo e envia para Telegram/plataformas de chat
  5. 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)
  6. 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_ID
  • https://youtu.be/VIDEO_ID
  • https://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ídeo
  • result.metadata.author - Nome do canal
  • result.metadata.viewCount - Contagem de visualizações formatada
  • result.metadata.publishDate - Data de publicação
  • result.actualLang - Idioma utilizado
  • result.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:

  1. Cole a URL do YouTube no chat
  2. Obtenha resumo estruturado em 20 segundos
  3. Transcrição completa salva para referência
  4. 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étodoTempoObtém MetadadosSaída EstruturadaArquivo PesquisávelAmigável para Nuvem
Assistir + fazer anotações30-45 minNãoNãoApenas manualN/A
Recurso de transcrição do YouTube5 minNãoNãoNãoSim
yt-dlp2-5 minSimNãoSim❌ Bloqueado em VPS
Copiar para ChatGPT10 minNãoÀs vezesNãoSim
Esta skill20 segSimSimSim✅ 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:

  1. Priorize pontos de dados - Números, porcentagens, citações de estudos se destacam
  2. Extraia citações - Frases marcantes tornam os resumos compartilháveis
  3. Identifique frameworks - Se o vídeo apresentar um método/processo, extraia as etapas
  4. Identifique opiniões contrárias - Sabedoria não convencional é mais valiosa do que conselhos comuns
  5. Observe provas - Exemplos, estudos de caso, resultados antes/depois adicionam credibilidade

Para Fluxos de Trabalho de Pesquisa:

  1. Construa uma biblioteca de transcrições - Organize por tópico/niche para identificação de padrões
  2. Pesquise entre transcrições - Use grep ou pesquisa de texto para encontrar menções a tópicos específicos
  3. Acompanhe tendências - Mesmo tópico em vários vídeos = tendência em ascensão
  4. Extraia prompts - Salve frameworks/métodos úteis como prompts reutilizáveis

Para Criação de Conteúdo:

  1. Encontre lacunas de conteúdo - Que perguntas são feitas, mas não são totalmente respondidas?
  2. Analise os de melhor desempenho - Que estrutura/ritmo os vídeos de alto número de visualizações usam?
  3. Extraia ganchos - Os primeiros 30 segundos da transcrição = padrões comprovados de ganchos
  4. 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.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ever-just/agentskills

> Declarative animations for React. Springs, gestures, layout animations, and page transitions. GPU-accelerated, production-ready.

ever-just/agentskills

> Create animated logos, icons, and micro-interactions as lightweight Lottie JSON files. No After Effects needed — build animations entirely in code.

ever-just/agentskills

> A TypeScript library using generators to program animations with a real-time editor. Ideal for explainer videos, code walkthroughs, and educational content.

ever-just/agentskills

> Add animated subtitles and captions to Remotion videos from .SRT files. TikTok-style word-by-word highlights, karaoke effects, and more.

ever-just/agentskills

> Create videos programmatically using React components. The most mature framework for code-driven video production.

ever-just/agentskills

> Copy-paste video components for Remotion. Intros, text effects, transitions, and full scene templates. Like shadcn/ui but for video.

ever-just/agentskills

Extract actionable intelligence from video content across YouTube, Vimeo, and company websites. Video reveals what text sources cannot: facility scale, team composition, product demonstrations, signage, event attendance, and operational reality.

ever-just/agentskills

Optimize and embed an existing video as a fast, crisp, autoplaying hero/background/loop on a website. Use when adding or replacing a video on a marketing site and it is too heavy, will not autoplay (especially on mobile/Safari), shows a codec error, or looks soft — to transcode it to web-safe H.264 with the right pixel format, faststart, retina-aware sizing, and a poster frame, then embed and verify it actually plays. This is optimization + embedding of footage you already have, not creating/animating a video (for that use remotion/moviepy/motion-canvas). Use when the user says "add this video to the site", "the hero video is too big / won't play / isn't crisp", "replace the homepage video", or "make this loop on the landing page".

ever-just/agentskills

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

Habilidades Relacionadas