Equipe de IA que Toca um Canal do YouTube (AgentTube)
Instale o agente open source que pesquisa, roteiriza e produz vídeos de YouTube na sua máquina, com a sua aprovação antes de publicar. Custos e riscos.
O que é
Equipe de IA que Toca um Canal do YouTube (AgentTube)
O YouTube Automation Agent (chamado de AgentTube no vídeo) é um projeto open source, de darkzOGx e com licença MIT, que roda no seu computador. Ele pesquisa temas, escreve roteiros, gera narração, monta o MP4, sugere título e descrição e agenda a publicação depois que você aprova cada vídeo.
O tutorial leva você do Google Cloud ao primeiro vídeo parado na tela de revisão, com os comandos do README, quatro prompts prontos e uma lista de erros comuns. Serve para criadores e profissionais de marketing que querem testar um fluxo de produção de vídeo sem pagar assinatura de ferramenta.
A ressalva principal: gratuito vale para a licença e para a cota grátis do Gemini em texto e narração. O Claude entra só pelo OpenRouter (pago), imagem por IA exige cobrança, e a política do YouTube para conteúdo repetitivo ou produzido em massa continua valendo para o seu canal.
Instalação local
Clone, npm install, Chromium do Playwright, walkthrough e painel em localhost:3456, nos comandos do README.
Do tema ao MP4
Pesquisa, roteiro, narração, montagem e agendamento em um pipeline com revisão humana.
Gemini grátis, Claude opcional
Cota grátis do Gemini para texto e narração. Claude só pelo OpenRouter, pago.
Nada sobe sem aprovação
Vídeos prontos esperam a sua revisão em Pipeline, segundo o README.
Painel e métricas
Captura de resultados em 24 horas e 7 dias e sincronização de comentários para as próximas pautas.
Nível: intermediário · Tempo estimado: ~45 min na primeira vez, contando a configuração do Google Cloud. Para este tutorial, o README oficial foi lido em 20/10/2026.
Custo: "de graça" vale para a licença (MIT) e para a cota grátis do Gemini, que cobre texto e narração. O Claude não é o provedor principal: ele entra como integração adicional, pelo OpenRouter, que é pago. A imagem do Gemini exige cobrança ativada. Sem provedor de imagem, as thumbnails saem do designer embutido, e não de uma IA de imagem. Confira preços e cotas atuais dos provedores antes de ligar qualquer chave.
Política do YouTube: canal tocado em massa por automação pode cair na regra de conteúdo repetitivo ou produzido em massa, que as políticas de monetização do YouTube tratam como conteúdo inautêntico (sem monetização). Revise e edite cada vídeo, traga ponto de vista próprio e não publique em volume só por publicar.
Não testado neste tutorial: a execução ponta a ponta (clone, walkthrough e geração de um vídeo até a tela de revisão). Os passos seguem o README oficial. Também não foi confirmado, na prática, que o modo "Activate & run now" nunca sobe nada sem clique. O README afirma que o vídeo espera a sua aprovação; confirme isso no seu painel antes de agendar qualquer publicação.
Pré-requisitos
- Node.js 18.17 ou superior (README, seção Quick start)
- Git e um terminal
- Conta Google dona do canal do YouTube
- Projeto no Google Cloud Console com YouTube Data API v3 e YouTube Analytics API ativas
- Chave de ao menos um provedor de texto. O Gemini (Google AI Studio) tem cota grátis para texto e narração
- Opcional e pago: chave do OpenRouter (para usar o Claude), da OpenAI (imagem e narração) ou do ElevenLabs (narração)
Conceitos-chave
- 01
AgentTube × YouTube Automation Agent
"AgentTube" é o nome usado no vídeo. O repositório oficial se chama YouTube Automation Agent, é de darkzOGx e tem licença MIT. Buscar "AgentTube" no GitHub leva a projetos homônimos: use o link desta página.
- 02
Agentes do pipeline
Aqui "agente" é uma etapa do pipeline (pesquisa, roteiro, SEO, thumbnail, produção, publicação, análise), e não uma skill do Claude Code. A pasta agents/ do repositório tem 7 arquivos; o README descreve mais etapas, como a de descoberta (SEO).
- 03
Provedor de texto
É a IA que escreve roteiros e títulos. Você escolhe no walkthrough. Gemini tem cota grátis. Claude só aparece via OpenRouter.
- 04
OAuth do tipo Desktop app
É a credencial que deixa o agente falar com o seu canal. Precisa ser do tipo Desktop app (não Web) e a conta do canal precisa estar como usuário de teste.
Passo a passo
- 01
Prepare o Google Cloud
No Google Cloud Console, crie um projeto e ative YouTube Data API v3 e YouTube Analytics API. Crie um cliente OAuth 2.0 do tipo Desktop app e salve o JSON baixado no caminho abaixo, dentro da pasta do projeto (depois do clone). Em Google Auth Platform > Audience, adicione a conta dona do canal como test user.
config/credentials.json - 02
Gere uma chave do Gemini
Em Google AI Studio, crie uma chave de API. Ela cobre texto e narração na cota grátis. Guarde a chave em um gerenciador de senhas.
https://aistudio.google.com/apikey - 03
Clone o repositório
O clone cria a pasta youtube-automation-agent.
git clone https://github.com/darkzOGx/youtube-automation-agent.git cd youtube-automation-agent - 04
Instale as dependências
O npm instala também o ffmpeg-static, então não é preciso instalar o FFmpeg à parte.
npm install - 05
Instale o Chromium do Playwright
Passo que o fluxo curto não mostra, mas está no README: ele renderiza os vídeos em slideshow. Sem ele, o vídeo não é produzido ou fica marcado como simulado. No Linux, acrescente --with-deps.
npx playwright install chromium - 06
Rode o walkthrough
Ele explica cada provedor, testa as chaves e conecta o canal. É aqui que você escolhe o Gemini e faz o login do Google.
npm run walkthrough - 07
Suba o painel e abra no navegador
O terminal fica ocupado com o servidor. O painel responde só na sua máquina (HOST padrão 127.0.0.1).
npm start http://localhost:3456 - 08
Rode a checagem de prontidão
No painel, abra Production readiness e use Run verified check. Segundo o README, ela faz pedidos pequenos de texto e narração e monta um MP4 de teste, sem subir nada.
- 09
Gere 1 vídeo e pare na revisão
Em Autonomous operator, descreva o canal e escolha Activate & run now (ou crie um vídeo único). O vídeo pronto vai para Pipeline e espera a sua revisão. Nada sobe sem você aprovar: confira fatos, direitos de mídia e só então aprove.
Prompts prontos
O primeiro prompt vai no campo de descrição do Autonomous operator, no painel. Os demais servem no Claude Code ou no Claude, para apoiar a configuração e a revisão. [NICHO], [PÚBLICO], [IDIOMA], [ERRO] e [ROTEIRO] são trechos que você troca antes de colar.
Prompt: descrever o canal no Autonomous operator
Canal em [IDIOMA] sobre [NICHO], para [PÚBLICO]. Vídeos de 5 a 8 minutos, tom direto e didático, sem promessas de resultado financeiro. Cada roteiro precisa citar fontes verificáveis e trazer um ponto de vista que ajude o espectador a decidir algo. Evitar clickbait e títulos enganosos.
Prompt: diagnosticar erro de instalação
Estou instalando o projeto youtube-automation-agent (Node.js, npm run walkthrough, painel em localhost:3456) e apareceu este erro: [ERRO]. Explique a causa mais provável, liste as checagens em ordem e proponha a menor correção. Não sugira comandos que apaguem arquivos sem me avisar antes.
Prompt: revisar roteiro antes de aprovar
Revise este roteiro de vídeo para YouTube: [ROTEIRO]. Aponte afirmações sem fonte, números que precisam de conferência, trechos que soam genéricos ou repetitivos e qualquer coisa que possa violar as políticas do YouTube. Devolva uma lista de correções e não reescreva o roteiro inteiro.
Prompt: variar pautas para não repetir
Considere os temas já publicados no meu canal sobre [NICHO]: [LISTA-DE-TEMAS]. Sugira 10 pautas novas com ângulos diferentes, cada uma com a pergunta que o vídeo responde e o motivo de não ser repetição das anteriores. Mostre a lista e aguarde a minha escolha.
Erros comuns
- Missing credentials for: an AI provider → nenhum provedor de texto configurado → rode npm run walkthrough ou npm run credentials:setup e configure ao menos um (a OpenAI não é obrigatória)
- Error 403: access_denied no login do Google → a sua conta não está como test user → em Google Auth Platform > Audience, adicione a conta dona do canal
- O login do Google some depois de uns dias → o app do OAuth está em modo Testing e o Google expira a sessão em 7 dias → refaça o login pelo walkthrough ou promova o app, se fizer sentido para o seu caso
- Nenhum vídeo é produzido, ou ele aparece como simulado → faltou o Chromium do Playwright ou o FFmpeg → rode npx playwright install chromium e leia as linhas com ✗ da checagem de capacidades na inicialização
- O vídeo não pode ser aprovado → sem narração funcionando → configure ElevenLabs, OpenAI ou Gemini para narração (o README define essa ordem de prioridade)
- A fila roda, mas nada é publicado → vídeos aprovados saem no horário agendado, por padrão no dia seguinte às 14h, no horário local do servidor → ajuste o agendamento ou espere o horário
- Painel acessível por outros aparelhos sem proteção → HOST=0.0.0.0 sem chave → mantenha HOST=127.0.0.1, ou defina API_KEY se precisar abrir o acesso
Checklist final
- Node.js 18.17 ou superior confirmado (node --version)
- YouTube Data API v3 ativa e credentials.json em config/
- Conta do canal adicionada como test user
- npx playwright install chromium executado sem erro
- Run verified check concluído no painel
- Primeiro vídeo parou em Pipeline esperando a sua aprovação
- Custos dos provedores conferidos antes de ligar chaves pagas
- Vídeo revisado (fatos, direitos de mídia, originalidade) antes de aprovar
Roda com o Claude?
Sim, mas pelo OpenRouter, com chave paga (README, out/2026). O Claude não aparece como provedor direto na tabela de provedores de texto. A cota grátis do Gemini cobre texto e narração.
A thumbnail é gerada por IA no plano grátis?
Não. Sem chave de imagem, o README diz que as thumbnails vêm do designer embutido. Imagem do Gemini exige cobrança ativada.
Algo é publicado sem a minha aprovação?
O README afirma que vídeos prontos esperam revisão e aprovação antes de sair. Este tutorial não testou isso na prática, então confirme no seu painel.
O nome AgentTube aparece no repositório?
Não. O nome do repositório é youtube-automation-agent. "AgentTube" é o nome usado no vídeo.
Fontes oficiais
- README do YouTube Automation Agentgithub.com/darkzOGx/youtube-automation-agent (abre em nova aba)
- YouTube Data API v3developers.google.com/youtube/v3 (abre em nova aba)
- Políticas de monetização do YouTubesupport.google.com/youtube/answer/1311392 (abre em nova aba)
- Google AI Studio (chave do Gemini)aistudio.google.com/apikey (abre em nova aba)
- OpenRouter (chaves)openrouter.ai/keys (abre em nova aba)
- Google Cloud Consoleconsole.cloud.google.com (abre em nova aba)
Próximos passos
- Alternativa paga para criar canal com IA/open-source/apps/ai-cria-canal-de-youtube-inteiro-em-minutos
- Vídeo com IA em hardware próprio/open-source/apps/para-de-pagar-por-ai-video-gratis-e-ilimitado
- Narração em português com ElevenLabs/open-source/integracoes/voiceover-automatico-pt-br-com-claude-elevenlabs
Comece agora
Pronto para colocar Equipe de IA que Toca um Canal do YouTube (AgentTube) para rodar?
Ver o YouTube Automation Agent no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo