Como montar uma automação de radar de concorrência no YouTube

Manual pra você criar, no Cowork, uma automação que toda semana puxa dados dos seus concorrentes no YouTube, cruza com a sua estratégia e te entrega uma lista de temas prontos pra gravar. Copie o modelo, troque os campos entre colchetes e ajuste pro seu canal.

Uma diferença importante em relação à automação do X: essa aqui não publica nada. Ela pesquisa e te entrega um relatório. É uma automação de análise, não de postagem. O risco é zero, ela nunca vai postar em nome de ninguém.

1. A ideia em uma frase

Você escreve a receita uma vez. Toda semana o Cowork roda um script que coleta os vídeos recentes dos seus concorrentes, e em cima disso gera temas com o seu ângulo. Você acorda no domingo com a pauta da semana pronta.

A automação junta quatro coisas:

1. Um gatilho de tempo que dispara a tarefa (ex: domingo às 18h).
2. Um script que puxa os dados do YouTube e salva numa planilha.
3. Um arquivo de prompt que diz em que formato transformar os dados em temas.
4. Um relatório salvo em Markdown, mais um resumo curto no fim.

O ponto: o roteiro é fixo, os dados são sempre novos.

2. Antes de começar: o que você precisa conectar

Diferente da automação do X (que usa o Postiz pra publicar), essa aqui roda um script no seu próprio computador. O que ela precisa:

Sim, aqui tem uma "API" a criar, parecido com a dúvida do X. Pra puxar dados do YouTube de forma confiável, o caminho padrão é a YouTube Data API v3:

1. Entre no Google Cloud Console e crie um projeto.
2. Ative a "YouTube Data API v3".
3. Gere uma chave de API (API key).
4. Cole essa chave no seu script (ou numa variável de ambiente, mais seguro).

A API é gratuita dentro de uma cota diária. Pra um radar semanal de alguns canais, a cota sobra.

Regra de ouro, igual à do X: crie a chave e teste o script antes de agendar. Na hora que a tarefa roda sozinha, ela não faz esse cadastro por você.

2.1 Como ativar a YouTube Data API (passo a passo)

Leva uns 5 minutos.

1. Entre no Google Cloud Console (console.cloud.google.com) com a sua conta Google.
2. No topo, crie um projeto novo (menu de projetos, "Novo projeto"). Dê um nome tipo radar-youtube e confirme.
3. Com o projeto selecionado, abra o menu lateral em "APIs e serviços" e depois "Biblioteca".
4. Busque por "YouTube Data API v3", clique nela e aperte "Ativar".
5. Vá em "APIs e serviços" > "Credenciais". Clique em "Criar credenciais" e escolha "Chave de API".
6. O Google gera a chave na hora. Copie ela. Clique em "Restringir chave" e limite à YouTube Data API v3, pra não deixar a chave exposta.

Um detalhe honesto: a interface do Google Cloud muda de tempos em tempos, então os nomes dos botões podem variar um pouco. A sequência é sempre a mesma: criar projeto, ativar a API, criar a chave.

2.2 Guarde a chave num arquivo .env (não cole no código)

Essa parte é importante. Nunca cole a chave direto no script. Se você fizer isso e compartilhar o arquivo com a turma, ou subir no GitHub, sua chave vai junto e qualquer um pode usar (e estourar a sua cota).

O jeito certo é um arquivo .env. Ele fica na mesma pasta do script e guarda seus segredos separados do código.

Passo 1 — crie um arquivo chamado .env na pasta do radar, com uma linha:

YOUTUBE_API_KEY=cole-a-sua-chave-aqui

Passo 2 — no script Python, leia a chave do .env em vez de escrever ela no código:

import os
from dotenv import load_dotenv

load_dotenv()  # lê o arquivo .env
API_KEY = os.environ["YOUTUBE_API_KEY"]

Se faltar a biblioteca, instale uma vez: pip install python-dotenv.

Passo 3 — crie um arquivo .gitignore na pasta com uma linha só:

.env

Isso garante que, se você usar Git, o .env nunca é enviado junto.

Como compartilhar com a turma sem vazar a chave: mande o script e um arquivo de exemplo chamado .env.example, com a linha YOUTUBE_API_KEY= vazia. Cada aluno preenche com a chave dele. O código é o mesmo pra todo mundo; o segredo é individual.

Resumo da regra: código você compartilha, .env você nunca compartilha.

3. As três partes da automação

A automação vive em uma pasta com três arquivos. É o que você vai montar:

a) O script (radar_concorrentes.py). Recebe a lista de canais que você quer vigiar, chama a YouTube Data API e salva os vídeos recentes numa planilha com a data no nome (ex: concorrentes_youtube_DDMMYYYY.xlsx). Colunas úteis: título, canal, data, views, e um link.

b) O arquivo de prompt (prompt_radar_semanal.md). Diz como transformar a planilha em pauta. No caso do @moniki.ai, o formato é:

TEMA + MEU ANGULO + POR QUE FUNCIONARIA

Ou seja, pra cada oportunidade: qual o tema, qual o seu ângulo próprio (não copiar o concorrente), e por que isso funcionaria pro seu público.

c) O relatório de saída (radar_DDMMYYYY.md). Onde os temas da semana ficam salvos, prontos pra você escolher.

4. O roteiro pronto pra copiar

Cole isso no seu SKILL.md e troque os campos entre colchetes.

Radar semanal de concorrência no YouTube para [SEU CANAL].

Toda [DIA E HORA, ex: domingo de tarde]:

PASSO 1 - Vá até a pasta [CAMINHO DA SUA PASTA DE RADAR].
Rode no terminal: python radar_concorrentes.py
Isso gera a planilha da semana com a data no nome
(concorrentes_youtube_DDMMYYYY.xlsx).

PASSO 2 - Abra essa planilha e, seguindo o prompt_radar_semanal.md
que está na mesma pasta, gere os temas no formato:
TEMA + MEU ANGULO + POR QUE FUNCIONARIA.

Foque em [SEU NICHO] e no meu público de [QUEM É]. Ignore vídeos que
não têm nada a ver com o canal.

PASSO 3 - Salve os temas em radar_DDMMYYYY.md nessa pasta.

PASSO 4 - No fim, me mande um resumo curto dos temas e avise se algum
canal veio parar aqui por engano (concorrente errado).

Execute sozinho, sem fazer perguntas. Se o script falhar, NÃO fique
tentando em loop: reporte o erro exato e pare.

5. O que a automação faz a cada disparo

Passo 1 — Coletar os dados. Roda o script, que chama a YouTube Data API e monta a planilha da semana com os vídeos recentes dos concorrentes.

Passo 2 — Gerar os temas. Lê a planilha e o arquivo de prompt e transforma os dados em pauta, no formato TEMA + ÂNGULO + POR QUE FUNCIONARIA. O ângulo é seu, não é cópia do concorrente.

Passo 3 — Salvar o relatório. Guarda os temas num .md com a data no nome.

Passo 4 — Reportar. Manda um resumo curto e avisa se algum canal errado entrou na lista, pra você ajustar a lista de concorrentes.

6. Regras de segurança

Como a tarefa roda sem você olhando:

• Age sozinha, não faz perguntas.
• Não publica nada. É análise pura. O output é um relatório.
• Se o script falhar, reporta o erro e para. Não fica em loop.
• Você fica no controle da pauta. A automação sugere; você escolhe o que gravar.

7. Como adaptar pra você

• Concorrentes: troque a lista de canais dentro do script pelos seus.
• Nicho e público: ajuste os campos entre colchetes no roteiro.
• Formato da pauta: o TEMA + ÂNGULO + POR QUE FUNCIONARIA é o do @moniki.ai. Troque pelo formato que você usa.
• Frequência: semanal é o padrão de radar de concorrência. Dá pra fazer quinzenal.
• Fonte: o mesmo molde serve pra Instagram, TikTok ou blogs, trocando o script e a API que puxa os dados.

8. Checklist pra sua primeira automação de radar

• Criei a chave da YouTube Data API no Google Cloud e ativei a API v3.
• Guardei a chave num arquivo .env e coloquei .env no .gitignore.
• Instalei o Python e o python-dotenv, e testei o script rodando na mão.
• Coloquei a lista dos meus concorrentes dentro do script.
• Escrevi o arquivo de prompt com o meu formato de pauta.
• Copiei o roteiro e troquei os campos entre colchetes.
• Defini o dia e a hora do agendamento.
• Rodei a tarefa uma vez manual pra ver se a planilha e o relatório saem certos.

Dica final: teste o script sozinho primeiro. Se a planilha sai preenchida e os temas fazem sentido, aí sim deixe no automático.

Diferença entre as duas automações (X e YouTube)

Guarde essa comparação, ela ensina os dois tipos de automação que existem:

Automação de publicação age no mundo, então exige mais cuidado e um fallback de rascunho. Automação de análise só te entrega informação, então é o melhor lugar pra começar a testar.