YouTube Pipeline

Plugin para Claude Code que transforma uma ideia, um tema ou uma transcrição em um pacote completo de publicação para o YouTube. Em vez de gerar peças soltas, ele entrega tudo o que você precisa para gravar e publicar um vídeo bem posicionado: roteiro estruturado, título otimizado, descrição com capítulos cronometrados, conjunto de tags e ideias de thumbnail.

O que faz

O YouTube Pipeline foi pensado para criadores que produzem em escala e não querem perder tempo montando metadados manualmente a cada vídeo. A partir de uma única entrada, ele constrói o ciclo de produção inteiro:

• Roteiro: gancho de abertura nos primeiros 15 segundos, desenvolvimento em blocos, chamadas para engajamento e fechamento com call-to-action claro.
• Título otimizado: variações com foco em CTR, respeitando o limite prático de 60 caracteres e evitando clickbait vazio.
• Descrição com capítulos: texto de descrição com resumo, links, e a lista de capítulos no formato 00:00 Nome do capítulo que o YouTube reconhece automaticamente.
• Tags: conjunto enxuto e relevante de palavras-chave, priorizando termos de cauda longa.
• Ideias de thumbnail: 3 a 5 conceitos visuais descritos para você ou um designer executar.

Quando as credenciais OAuth estão configuradas, o plugin também consegue consultar e sugerir atualizações de metadados de vídeos já publicados via YouTube Data API v3.

Instalação

1. Copie a pasta youtube-pipeline/ para o diretório de plugins do seu projeto ou para ~/.claude/plugins/.
2. Garanta que o arquivo .claude-plugin/plugin.json esteja presente.
3. Reinicie o Claude Code (ou recarregue os plugins). Os comandos /youtube-pipeline ficarão disponíveis.
4. Defina as variáveis de ambiente descritas em Configuração caso queira usar os recursos que acessam a API.

Comandos disponíveis

• /pipeline — Gera o pacote completo de publicação a partir de um tema ou de uma transcrição: roteiro, título, descrição com capítulos, tags e ideias de thumbnail.
• /otimizar-video — Analisa e reescreve os metadados (título, descrição, capítulos e tags) de um vídeo já existente, recebendo a URL ou o ID do vídeo.

Configuração

O plugin funciona em modo offline para geração de conteúdo. Para recursos que leem ou atualizam dados reais do YouTube, defina as seguintes variáveis de ambiente (apenas os NOMES — preencha com seus próprios valores):

• YOUTUBE_API_KEY — chave da YouTube Data API v3, usada para leitura de dados públicos (metadados, estatísticas, busca).
• YOUTUBE_OAUTH_CLIENT_ID — Client ID do app OAuth para operações autenticadas.
• YOUTUBE_OAUTH_CLIENT_SECRET — Client Secret correspondente.
• YOUTUBE_OAUTH_REFRESH_TOKEN — Refresh token para obter access tokens e fazer upload/atualização de vídeos do seu canal.

Nunca cole valores de credenciais diretamente nos comandos ou no histórico de chat. Use sempre variáveis de ambiente ou um gerenciador de segredos.

Exemplo de uso

Gerar um pacote completo a partir de um tema:

/pipeline Como começar a investir em renda fixa com pouco dinheiro em 2026

Gerar a partir de uma transcrição já existente (cole o texto após o comando):

/pipeline transcrição: Olá pessoal, hoje vamos falar sobre os três erros mais comuns...

Otimizar os metadados de um vídeo já publicado:

/otimizar-video https://www.youtube.com/watch?v=dQw4w9WgXcQ palavra-chave: renda fixa para iniciantes

O resultado vem organizado em seções claras, pronto para copiar e colar no YouTube Studio. Os capítulos já saem no formato cronometrado correto, começando obrigatoriamente em 00:00.

Segurança e limites

• Segredos: o plugin nunca imprime nem armazena suas chaves. Mantenha YOUTUBE_API_KEY e os tokens OAuth fora do repositório (use .env no .gitignore).
• Cotas da API: a YouTube Data API v3 tem cota diária. Operações de busca consomem muito mais cota que leituras simples; o plugin prioriza chamadas econômicas e avisa quando uma ação for cara.
• Uploads e atualizações: alterar metadados de um vídeo é uma ação destrutiva sobre o conteúdo público. O plugin sempre mostra o antes e o depois e pede confirmação antes de sugerir qualquer escrita.
• Diretrizes do YouTube: o conteúdo gerado evita clickbait enganoso, tags irrelevantes (tag stuffing) e qualquer prática que viole as políticas da plataforma, que podem resultar em desmonetização.
• Revisão humana: trate todo material gerado como rascunho de alta qualidade, não como verdade absoluta. Revise dados, números e afirmações antes de publicar.