AgentTube: passo a passo do agente open source que opera um canal do YouTube

O youtube-automation-agent (também chamado de AgentTube/Lumen no projeto) é um agente open source que pesquisa temas, escreve roteiros, gera narração e visuais, monta o vídeo, cuida do SEO, agenda e publica no YouTube, e depois aprende com analytics e comentários.

Fonte: README, página do repo e API do GitHub, lidos em 01/10/2026.

Importante desde já: não é plugin de Claude Code, Codex ou Cursor. É um app Node standalone, com dashboard próprio no navegador.

• Node.js 18+.
• Projeto no Google Cloud com a YouTube Data API v3 ativada e um cliente OAuth do tipo Desktop app.
• Pelo menos 1 chave de provedor de texto: OpenAI, OpenRouter, Gemini, Kimi, MiMo ou GLM (o README também lista integração com Anthropic Claude e Ollama local).
• FFmpeg: vem automaticamente via ffmpeg-static no npm install.

1. Clonar e instalar

git clone https://github.com/darkzOGx/youtube-automation-agent.git
cd youtube-automation-agent
npm install

2. Configurar o Google Cloud

1. Crie (ou escolha) um projeto no Google Cloud Console.
2. Ative a YouTube Data API v3 nesse projeto.
3. Crie uma credencial OAuth client ID do tipo Desktop app.
4. Baixe o JSON e salve como config/credentials.json dentro da pasta do repo.

3. Chaves no .env

Copie o modelo e preencha com as suas chaves (veja o .env.example do repo para a lista completa e os nomes exatos):

cp .env.example .env

No .env.example as linhas dos provedores vêm comentadas com # (os valores de exemplo devem continuar comentados). Descomente só a do provedor que você vai usar e preencha com a sua chave. Formato (só os nomes; sem valores reais):

OPENAI_API_KEY=
GEMINI_API_KEY=
OPENROUTER_API_KEY=
FFMPEG_PATH=

Nunca publique o .env nem o config/credentials.json no Git.

4. Assistente de configuração e start

npm run walkthrough
npm start

Alternativa curta para a configuração: npm run setup.

Depois abra http://localhost:3456 no navegador.

1. Rode o npm run walkthrough e siga as perguntas.
2. Abra o dashboard em http://localhost:3456.
3. Vá em Production readiness → Run verified check. Ele testa texto, narração, acesso ao canal e monta um MP4 temporário. Não sobe nada ao YouTube.
4. Só depois disso configure o Autonomous operator: objetivo do canal, público, pilares de conteúdo e cadência.

• Approval-first: por padrão nada é agendado sem passar por revisão de fatos (Evidence desk), confirmação de direitos de mídia e aprovação humana.
• Vídeo "simulated" (placeholder) não pode ser publicado; narração ausente ou com falha bloqueia a aprovação.
• Comentários: as respostas sugeridas vão para uma fila para você editar/aprovar. Spam ou golpe vai para "needs attention"; o agente nunca apaga.
• Shorts Repurposing Studio: gera 3 rascunhos de Shorts 9:16 a partir do vídeo aprovado, sem gastar créditos novos de imagem, vídeo ou TTS.
• Scene Repair Studio: para corrigir cenas específicas.
• Há controle para declarar mídia sintética/alterada no YouTube.

O custo depende dos provedores que você ligar. O que o README informa:

1. Não é plugin de Claude Code/Codex/Cursor. É um app Node standalone com dashboard.
2. Endereço "pump" no título do README. O título carrega um endereço longo terminado em "pump" (parece contrato de token de cripto) sem explicação. Olhe com cuidado e não confunda com o projeto.
3. Não é "sem esforço". O README promete operação autônoma, mas exige OAuth do Google Cloud, chaves de API e revisão humana.
4. Regras do YouTube. Conteúdo em massa gerado por IA pode violar as políticas da plataforma. O README manda cumprir os Termos e oferece controle para declarar mídia sintética/alterada. A responsabilidade é sua.
5. Sem resultado real demonstrado. O trecho de demonstração em vídeo do README ainda não foi publicado; nenhum resultado de canal é mostrado.
6. Custo e manutenção. O custo depende dos provedores que você ligar, e o projeto tem um autor solo.

Não existe integração oficial: o projeto não é plugin, skill nem servidor MCP. O que dá para fazer é abrir a pasta do repo clonado nessas ferramentas para ler o código, entender o pipeline e adaptar o que quiser (prompts, cadência, provedores). O agente em si roda pelo npm start e pelo dashboard.

• Repositório e README: https://github.com/darkzOGx/youtube-automation-agent (lido em 01/10/2026)
• API do GitHub: https://api.github.com/repos/darkzOGx/youtube-automation-agent (consultada em 01/10/2026)
• YouTube Data API v3: https://developers.google.com/youtube/v3