geoffrey-svg/trial-reels-starter

Configuração do Trial Reels Starter

Configuração única. Siga as etapas em ordem, pulando o que já estiver pronto. Em cada etapa: uma breve explicação em linguagem simples, depois a ação ou pergunta. Mantenha os detalhes técnicos para você.

Etapa 1: Ferramentas

1. Execute ./install.sh nesta pasta. Ele prepara o ffmpeg (criação de vídeos) e dois componentes Python (Pillow e fontTools), pulando o que já estiver instalado.
2. Se o Homebrew não estiver instalado, ajude o usuário a instalá-lo a partir de brew.sh: ele precisará digitar a senha do Mac no Terminal. Explique o que ele verá (a senha não aparece enquanto digita) e execute ./install.sh novamente.
3. Diga apenas: "As ferramentas estão prontas."

Etapa 2: Seu Estilo

1. Se o usuário colou um prompt da AI Suite com um bloco de configurações (JSON com texto): salve esse bloco usando python3 engine/scripts/instellingen.py --escreva - e não faça perguntas.
2. Caso contrário: diga que é mais fácil escolher o estilo na AI Suite (bloco Trial Reels, com exemplo) e depois colar o prompt. Se ele não quiser, pergunte em uma única mensagem: qual fonte (a lista com nomes comuns e nomes de arquivos está em python3 engine/scripts/instellingen.py --fontes), texto em bloco ou letras soltas com borda, quais cores, e posição: superior, central ou inferior no vídeo.
3. Mostre o resultado: python3 engine/scripts/exemplo.py (ou com --video <caminho> em um vídeo próprio). Veja a imagem você mesmo e mostre ao usuário. Pergunte se está correto.

Etapa 3: Como Você Quer Publicar?

Se minhas-reels-teste/accounts.json já existe mas conexao.json não, esta é uma instalação anterior a esta escolha (versão 1.0, via Zernio). Não pergunte nada e não crie nova chave: python3 engine/scripts/chave.py --guardado zernio, e vá para a etapa 5.

Explique em poucas frases que os reels serão publicados no Instagram via uma conexão no momento combinado, e que ele escolhe qual. Apresente as três opções e pergunte qual ele deseja:

1. Metricool, se ele já usa. Os reels vão para o planejador Metricool dele, como outros posts, e as métricas vêm do Metricool. Necessário: plano Advanced ou superior (com API; a partir de €43/mês anuais, segundo metricool.com/pricing em 19 de outubro de 2026) e conta do Instagram como marca no Metricool.
2. Zernio, se ele não tem Metricool ou quer manter separado. Grátis para até 2 contas do Instagram, sem cartão de crédito. Agendamento e métricas via Zernio.
3. Publicar manualmente com outro programa (ex.: Later, Buffer ou app do Instagram). O sistema só cria os reels; ele mesmo os publica como reel de teste, e as métricas ele vê lá. Não é necessária conexão: python3 engine/scripts/chave.py --manual, e vá para a etapa 5.

Etapa 4: Configurar a Conexão

Metricool

1. ./install.sh --metricool: prepara o cloudflared. Metricool só aceita vídeos via endereço público; para isso, o sistema abre a pasta de reels publicamente por um instante, apenas durante o agendamento.
2. Peça ao usuário para buscar os dados da API no Metricool (conforme descrito no centro de ajuda do Metricool, help.metricool.com, "Como encontrar seu ID de usuário Metricool", acessado em 19 de outubro de 2026):
   1. O token: em Metricool em Configurações da Conta, seção API. Disponível apenas nos planos Advanced e Custom.
   2. O número de usuário (userId): abra o Metricool no navegador e abra uma marca. Na barra de endereços aparecerá algo como ...?blogId=12345&userId=1234567; o número após userId= é o número de usuário (o número após blogId= é a marca, não é necessário).
3. Ele cola o token e o número de usuário no chat. Salve-os com printf '%s' '<token>' | python3 engine/scripts/chave.py --metricool --user <numero_do_usuario>. Nunca repita o token em sua resposta. O script testa primeiro no Metricool; se não funcionar, peça ao usuário para verificar (e se o plano dele tem a API).
4. python3 engine/scripts/conectar.py mostra as marcas com uma conta do Instagram. Ative a correta com python3 engine/scripts/conectar.py --usar <nome_instagram>. Se essa conta do Instagram estiver vinculada a duas marcas, o script pede o número da marca: pergunte ao usuário qual marca e use --usar <numero>.

Zernio

1. Peça ao usuário para fazer login ou criar uma conta em zernio.com. Lá, ele abre API keys e clica em Create API key. Copie a chave imediatamente: Zernio a mostra apenas uma vez. A chave começa com sk_.
2. Ele cola a chave no chat. Salve-a com printf '%s' '<chave>' | python3 engine/scripts/chave.py. Nunca repita a chave em sua resposta. Se não funcionar, peça ao usuário para criar uma nova.
3. python3 engine/scripts/conectar.py --link fornece um link para conectar o Instagram. Antes de abri-lo: no Instagram, mude primeiro para a conta que ele deseja conectar, pois o Instagram conecta a conta com a qual ele está logado.
4. Depois, python3 engine/scripts/conectar.py e python3 engine/scripts/conectar.py --usar <nome>.

Em ambos: O Instagram exige uma conta profissional (criador ou empresa) que seja pública, e reels de teste só podem ser criados a partir de 200 seguidores; abaixo disso, o sistema publica reels normais, que também são vistos pelos seguidores. Diga isso. Mais contas podem ser adicionadas com conectar.py --adicionar <nome> (não --usar, que substitui a lista).

Etapa 5: Suas Regras de Postagem e Quando algo é um Vencedor

Pergunte tudo em uma única mensagem, com os padrões para que ele possa apenas dizer "ok":

1. Quantos reels por dia por conta? Padrão: 5. Recomendação: comece em uma conta nova com 2 a 5 por dia. O Instagram geralmente não permite mais de cerca de 5 reels de teste por conta por dia via conexão (medido em conta própria; acima disso, o Instagram os recusou), e contas de teste que receberam dezenas por dia imediatamente perderam alcance.
2. Quantos minutos no mínimo entre eles? Padrão: 45 (mínimo 30).
3. Entre quais horários? Padrão: entre 9:00 e 21:00, no fuso horário do computador dele (pergunte se não estiver correto).
4. Repassar para seus seguidores: ele repassa manualmente no app do Instagram um reel de teste que está indo bem, ou deixa o Instagram fazer isso automaticamente?
5. Quando um reel é vencedor? Padrão: quando atinge pelo menos 3 vezes as visualizações normais da conta e pelo menos 500 visualizações. Necessário apenas com conexão (Metricool ou Zernio).

Salve a resposta com python3 engine/scripts/instellingen.py --escreva -, incluindo apenas os blocos postar e vencedores (exemplo: {"postar": {"por_dia": 3, "minutos_entre": 45, "de": 9, "ate": 21, "fuso": "America/Sao_Paulo", "repassar": "manual"}, "vencedores": {"fator": 3, "min_visualizacoes": 500}}). Se o script recusar algo, explique o motivo e pergunte novamente. Depois, diga em uma frase o que está configurado (python3 engine/scripts/instellingen.py); se couberem menos reels por dia na janela do que o escolhido, isso será informado.

Pronto

Diga em duas ou três frases o que agora é possível: fornecer vídeos e textos, visualizar os reels, aprovar a proposta (ou, no caso de postagem manual, baixar os reels) e, após alguns dias, consultar as métricas. Ofereça-se para criar imediatamente uma primeira rodada pequena (por exemplo, 5 reels).