Communitygithub.com

ingest-youtube — Conector YouTube-para-vault

Converte transcrições de vídeos do YouTube em arquivos markdown pesquisáveis, prontos para uso por outras habilidades de IA.

O que é ingest-youtube — Conector YouTube-para-vault?

Esta habilidade do agente extrai transcrições de vídeos do YouTube e as organiza em um vault markdown estruturado, facilitando a consulta e o uso por outras habilidades de IA, como extração de grafos de conhecimento, treinamento de impressão vocal, reaproveitamento de conteúdo e extração de itens de ação. Ela funciona utilizando `yt-dlp` para descobrir legendas, limpar os marcadores VTT, e gerar arquivos markdown com frontmatter rico (metadados) e o corpo da transcrição limpo. O processo suporta técnicas de priorização de legendas (manuais sobre automáticas), desduplicação de linhas, e preservação de rótulos de falantes. A habilidade também gera 'stubs' de captura para palavras-chave identificadas na transcrição, integrando-se perfeitamente ao ecossistema de vault do agente. Ideal para transformar vídeos do YouTube em conteúdo acionável e pesquisável dentro de um sistema de memória persistente, como o `adelaidasofia/ai-brain-starter`.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlperTuncOrtak/crypto-data-pipeline/tree/HEAD/skills/ingest-youtube

Perguntar na sua IA favorita

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

Documentação

O que ingest-youtube — Conector YouTube-para-vault faz?

Converte transcrições do YouTube em entradas de memória tipadas e consultáveis no vault que outras habilidades (extração de grafo de conhecimento, treinamento de impressão vocal, reaproveitamento de conteúdo, extração de itens de ação) podem utilizar.

Este é o mesmo padrão de ingest-slack, ingest-whatsapp, ingest-notion, ingest-linear, ingest-github, ingest-gmail. Adicionar YouTube significa um novo normalizador, não uma nova arquitetura.

Quando usar

  • O usuário cola uma URL do YouTube e pede uma transcrição ou resumo
  • O usuário digita /ingest-youtube <url> para um único vídeo
  • O usuário pede para capturar, sincronizar, ingerir, transcrever ou obter uma palestra/podcast/keynote para o vault

NÃO use para:

  • Baixar o arquivo de vídeo real (use yt-dlp diretamente com -f best)
  • Ingestão de todo um canal ou janelas de --days; este script ingere uma URL de vídeo por vez
  • Transmissões ao vivo (transcrições não são estáveis)
  • Fontes que não sejam YouTube (Vimeo, Twitch, Twitter Spaces têm seus próprios conectores)
  • Leituras únicas de transcrição onde o usuário não quer um arquivo no vault (use yt-dlp --write-auto-sub diretamente e redirecione para stdout)

Como funciona

  1. Interpreta a entrada como uma URL de vídeo do YouTube.
  2. Verifica se yt-dlp está instalado. Se não estiver, o script exibe instruções de instalação: brew install yt-dlp (macOS) ou pip3 install --user yt-dlp.
  3. Valida a URL como um único vídeo http(s) do YouTube e chama yt-dlp --ignore-config --list-subs -- <url> para listar as legendas disponíveis.
  4. Prioridade de legendas: legendas manuais > legendas automáticas. Legendas manuais preservam pontuação e rótulos de falantes fornecidos pelo criador; legendas automáticas são em maiúsculas e sem pontuação.
  5. Baixa a legenda de maior prioridade como VTT via yt-dlp --write-sub --sub-lang <lang> --skip-download. Preferência de idioma padrão: en,es (Inglês primeiro, Espanhol segundo).
  6. Remove os marcadores de tempo VTT e mescla em parágrafos de prosa limpa. Remove linhas duplicadas (VTTs gerados automaticamente têm linhas duplicadas). Preserva rótulos de falantes se a fonte os tiver.
  7. Obtém metadados do vídeo (título, canal, data de upload, duração, video_id, URL) via yt-dlp --print-json --skip-download.
  8. Cria um slug do nome do canal e do título do vídeo. Escreve em External Inputs/YouTube/<slug-do-canal>/<AAAA-MM-DD>-<slug-do-video>.md.
  9. Examina a transcrição em busca de palavras-chave de gatilho (decisão, framework, modelo, princípio, "a lição é", playbook, anti-padrão, estudo de caso). Para cada correspondência, cria um stub de escrita em Meta/Captures/<AAAA-MM-DD>-youtube-<slug-do-canal>-<video-id>.md, fazendo com que o stub apareça no agregador de capturas.
  10. Exibe um resumo: caminho do arquivo, contagem de palavras da transcrição, idioma, stubs detectados.

Invocação

python3 ingest.py <youtube-url> [--vault <caminho>] [--lang <código>]

Padrões:

  • --vault: variável de ambiente $VAULT_ROOT ou diretório atual
  • --lang: en,es (Inglês primeiro, Espanhol segundo; corresponde a um padrão bilíngue comum)
  • --whisper: aceito como um sinalizador de fallback futuro, mas esta versão escreve um stub quando nenhuma legenda está disponível

Contrato de saída

O arquivo do vault em External Inputs/YouTube/<slug-do-canal>/<AAAA-MM-DD>-<slug-do-video>.md tem frontmatter:

---
type: external-input
source: youtube
video_id: <ID de 11 caracteres>
url: https://www.youtube.com/watch?v=<id>
channel: <nome-do-canal>
channel_url: https://www.youtube.com/<handle>
title: <título-do-vídeo>
upload_date: <AAAA-MM-DD>
duration_seconds: <int>
language: <código ISO>
subtitle_source: manual | auto | whisper
word_count: <int>
ingested_at: <timestamp ISO 8601>
---

O corpo é a transcrição limpa em prosa em parágrafos. Se a fonte tinha rótulos de falantes, formate como **<falante>:** <texto> por turno.

Idempotência

Reingerir a mesma URL de vídeo sobrescreve o mesmo arquivo do vault. Os nomes de arquivo dos stubs fazem hash do video_id, então o mesmo vídeo fonte produz o mesmo nome de arquivo de stub em execuções repetidas. Reexecuções atualizam, nunca duplicam.

Legendas ausentes

Se yt-dlp --list-subs não retornar legendas manuais ou automáticas, o script escreve uma nota stub no vault com os metadados do vídeo e a URL fonte em vez de falhar silenciosamente. O sinalizador --whisper está reservado para uma futura transcrição local de fallback e atualmente informa que o fallback não está implementado.

Para um fallback manual hoje, baixe o áudio com yt-dlp, transcreva com seu fluxo de trabalho Whisper local e adicione legendas ou texto da transcrição antes de reexecutar a ingestão.

Limitações

  • Ingere uma URL de vídeo do YouTube por execução; handles de canais, playlists e janelas --days estão fora do escopo.
  • Depende das legendas retornadas por yt-dlp; vídeos sem legendas produzem um stub de metadados, não uma transcrição.
  • Não baixa arquivos de vídeo nem executa transcrição Whisper embutida nesta versão.
  • Disponibilidade de rede, acesso a legendas do YouTube e comportamento local do yt-dlp determinam se a ingestão é bem-sucedida.

Teste de aceitação

Execute contra o primeiro vídeo já enviado ao YouTube:

python3 ingest.py "https://www.youtube.com/watch?v=jNQXAC9IVRw" --vault /tmp/test

Saída esperada:

Wrote 39 words to /tmp/test/External Inputs/YouTube/jawed/2005-04-24-me-at-the-zoo.md. Language: en. Subtitle source: manual.

O arquivo de saída contém frontmatter válido e um corpo de prosa limpo.

Dependências

  • yt-dlp (obrigatório): instale via brew install yt-dlp ou pip3 install --user yt-dlp
  • whisper-cpp (opcional para um fallback manual fora deste script)

Fonte

Empacotado em adelaidasofia/ai-brain-starter, uma estrutura de verificação em torno de um agente de IA para que a memória se acumule em vez de se corromper. A habilidade faz parte da família de conectores de vault ingest-*.

Individual skills in this repo

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

AlperTuncOrtak/crypto-data-pipeline

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

AlperTuncOrtak/crypto-data-pipeline

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

AlperTuncOrtak/crypto-data-pipeline

One sentence - what this skill does and when to invoke it

AlperTuncOrtak/crypto-data-pipeline

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlperTuncOrtak/crypto-data-pipeline

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

AlperTuncOrtak/crypto-data-pipeline

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

AlperTuncOrtak/crypto-data-pipeline

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

AlperTuncOrtak/crypto-data-pipeline

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

AlperTuncOrtak/crypto-data-pipeline

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

AlperTuncOrtak/crypto-data-pipeline

Best practices for Remotion - Video creation in React

AlperTuncOrtak/crypto-data-pipeline

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

AlperTuncOrtak/crypto-data-pipeline

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

AlperTuncOrtak/crypto-data-pipeline

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

AlperTuncOrtak/crypto-data-pipeline

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

AlperTuncOrtak/crypto-data-pipeline

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

AlperTuncOrtak/crypto-data-pipeline

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

AlperTuncOrtak/crypto-data-pipeline

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

AlperTuncOrtak/crypto-data-pipeline

One sentence - what this skill does and when to invoke it

AlperTuncOrtak/crypto-data-pipeline

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

AlperTuncOrtak/crypto-data-pipeline

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Habilidades Relacionadas