CenaForge: primeira versão pública

Gerador de vídeos narrativos (Godot + FFmpeg), painel Next.js, serviço de voz,
Clipador de lives e Publicador para YouTube, TikTok e Instagram.

Inclui a leitura das visualizações dos posts para o Dashboard e o botão
"Publicar no <rede>" nos cartões das publicações.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-17 16:35:09 -03:00
co-authored by Claude Opus 5.5
commit 84f30bbc2d
484 changed files with 74826 additions and 0 deletions
@@ -0,0 +1,38 @@
# 1 — Pauta
**Objetivo:** decidir O QUE produzir e POR QUE alguém vai parar de rolar o feed por isso.
**Saída:** item de pauta aprovado (modelo em [../templates/pauta.md](../templates/pauta.md)).
## Trilho HISTÓRIA
- Onde: `stories/<id>/pauta.md` (lista de ideias e arco da série) + `stories/<id>/biblia.md` (mundo, personagens).
- Uma série é um **arco de 3–5 episódios** com escalada: cada parte acrescenta risco ou informação nova; a
penúltima vira o jogo; a última paga. Cada episódio precisa funcionar **sozinho** para quem chegou agora.
- Formato do painel (`STORY_FORMATS`): `interactive` (2–4 opções votadas nos comentários) ou `linear`.
- Na interativa, a pauta já prevê as **duas escolhas** com custo e graça (nenhuma "certa" óbvia).
## Trilho CORTE DE LIVE
- A pauta é **quais canais** e **que tipo de momento**: canais no Clipador (monitorar, autorizado), nota mínima
do juiz, nicho de cada conta (página Contas: conta ↔ canais).
- Prefira canais com **permissão** (marca `authorized`). Sem permissão: risco de strike e, no Instagram/YouTube,
de perder alcance/monetização por conteúdo reutilizado — ver [platforms.md](platforms.md).
- Defina o **ângulo de transformação** da conta (ex.: "momentos de susto com contexto", "top reações da semana",
"explicando o que aconteceu"). Conta só de repost puro deixa de ser recomendada no Instagram.
## Critérios de uma boa pauta (os dois trilhos)
1. Gancho em uma frase: "o que acontece nos 2 primeiros segundos?".
2. Pagamento: o que o espectador ganha no fim (risada, susto, resposta, cliffhanger).
3. Motivo de compartilhar: para quem a pessoa mandaria isso?
4. Público e conta de destino definidos.
5. Viável com o que o CenaForge faz hoje (senão, liste em "Necessidades de produção").
## Pronto quando
- [ ] gancho, pagamento e motivo de compartilhar escritos em uma linha cada;
- [ ] conta(s) de destino definida(s);
- [ ] (história) arco com nº de partes e escolha(s) do episódio; (corte) canal, permissão e ângulo definidos;
- [ ] necessidades de produção listadas ou "nenhuma".
**Quem faz:** texto → `cenaforge-story-writer`; canais/juiz → página Clipador.
@@ -0,0 +1,46 @@
# 2 — Roteiro
**Objetivo:** transformar a pauta numa sequência de segundos em que nada sobra.
**Saída:** história → `stories/<id>/<file_key>.md` (regras e formatos em `doc/roteiro/`: `comum.md` +
`ficcao.md` ou `documental.md`, os mesmos para o Codex e para o `cenaforge-story-writer`); corte → trecho
[início, fim] + título/legenda (campos do corte no Clipador).
## Estrutura de vídeo curto (os dois trilhos)
| Bloco | Tempo | Função |
|---|---|---|
| Gancho | 0–2 s | imagem forte + texto na tela; afirmação, pergunta ou ação já em andamento |
| Contexto | até ~20% do vídeo | o mínimo para entender o que está em jogo |
| Escalada | meio | cada beat aumenta a tensão/graça; troca visual a cada 2–4 s |
| Pagamento | fim | a risada/susto/resposta — ou o cliffhanger/escolha (história interativa) |
| Laço | último segundo | final que conversa com o começo ajuda a reassistir |
Fórmulas de gancho (escolha uma): curiosidade ("ele não sabia que…"), afirmação forte, começar no meio da ação,
consequência antes da causa ("isso terminou com a moto no rio"), pergunta direta ao espectador.
**Proibido:** prometer no gancho o que não acontece (gera "não tenho interesse" e derruba a distribuição).
## Trilho HISTÓRIA
- Siga o formato de `ep<NN>.md` de `doc/roteiro/ficcao.md` (cena a cena com `t (s)`, chamada final, campos de
overlay, consequências, necessidades de produção). Limites: `overlay.title` ≤ 80 (ideal ≤ 30),
`choiceA/B` ≤ 48 (ideal ≤ 24).
- Episódio de série: abre com **recapitulação em 1 frase** (serve a quem chegou agora) e fecha em decisão ou
gancho para a próxima parte.
- Duração atual das cenas: ~12 s (render). Narração cabe em ~2,5 palavras/s.
## Trilho CORTE DE LIVE
- O roteiro é a **edição do trecho**: começar o mais perto possível do acontecimento (contexto mínimo), terminar
logo depois da reação. O Clipador já propõe [início, fim] (chat + transcrição + juiz); revise na fila.
- Escreva o **gancho em texto** para a tela/legenda do post (o juiz sugere o título). Isso é parte da
transformação exigida em [platforms.md](platforms.md).
- Duração: 15–59 s (padrão do Clipador). Shorts aceita até 3 min, mas mantenha cortes de terceiros ≤ 60 s.
## Pronto quando
- [ ] gancho cabe em 2 s e tem texto de tela;
- [ ] cada beat tem motivo de existir (se tirar, a peça piora?);
- [ ] fim paga o gancho (ou deixa escolha/cliffhanger claro);
- [ ] (história) campos de overlay dentro dos limites e contados; (corte) início/fim revisados, título ≤ 70 chars.
**Quem faz:** `cenaforge-story-writer` (texto); ajuste de trecho → fila do Clipador.
@@ -0,0 +1,36 @@
# 3 — Narração
**Objetivo:** voz que carrega a história no ritmo do vídeo e casa com a legenda.
**Saída:** história → WAV salvo no repositório e apontado em `audio.file` (`audio.enabled: true`) da cena;
corte → normalmente nenhuma (a voz é a do streamer).
## Regras de ritmo (heurística — testar)
- Conversacional: **130–160 palavras/min** (~2,2–2,7 palavras/s). Acima de ~180/min cansa e a legenda não
acompanha (leitura no celular ≈ 200–250 palavras/min). O roteiro do CenaForge usa ~2,5 palavras/s.
- **Uma pausa estratégica** antes do ponto mais importante; corte silêncios mortos no resto.
- Primeira palavra no **primeiro segundo** — narração que começa tarde perde o gancho.
## Trilho HISTÓRIA
- Serviço de voz (skill `cenaforge`, seção "Voz e legenda"): `POST /v1/synthesize` com `params.format: "wav"`;
voz padrão `pt-br-antonio` (Edge); offline: Piper (`pt-br-faber`, `pt-br-cadu`). Página **Vozes** do painel
para ouvir/testar (velocidade 0,5–2).
- Personagem: voz de personagem (RVC) por personagem, registrada na bíblia. **Voz que imita pessoa real → rótulo
de IA** na publicação (ver [platforms.md](platforms.md)).
- Gere a legenda junto: `POST /v1/transcribe` com `X-Detail: words` sobre o WAV final (tempos por palavra).
## Trilho CORTE DE LIVE
- Voz original. Narração própria (TTS) só se for a **camada de transformação** (contexto de 1 frase no início:
"o chat inteiro achou que ele ia morrer aqui…") — conta como comentário original para o YouTube.
- Se usar, mixe a narração por cima com o áudio da live abaixado (ducking) — hoje isso é manual (FFmpeg).
## Pronto quando
- [ ] duração da fala ≤ duração da cena; ritmo dentro da faixa;
- [ ] primeira palavra até 1 s; sem silêncio morto;
- [ ] WAV final apontado na cena (história) e legenda com tempos gerada;
- [ ] rótulo de IA decidido (sim/não) e anotado na ficha.
**Lacuna:** o render ainda não chama o serviço de voz sozinho.
@@ -0,0 +1,29 @@
# 4 — Cenas
**Objetivo:** imagem que mostra o roteiro, com algo mudando na tela a cada poucos segundos.
**Saída:** história → `config/<id>-<file_key>.json` renderizado em prévia aprovada; corte → enquadramento decidido.
## Trilho HISTÓRIA
- Como fazer: skill `cenaforge` ("Receita: fazer ou ajustar um vídeo"): copiar a cena base, editar o JSON
(textos, tempos, câmera, luz, seed), `pnpm render -- --config … --profile preview`, ler `report.json` e
**olhar** `inspect/` (e a tira de 1 quadro/s se mexeu em câmera/movimento). Só depois `--profile final`.
- Regras de linguagem visual para vídeo curto:
- **0–2 s**: o quadro mais forte do episódio (ação já em andamento, personagem perto da câmera);
- troca de plano/câmera/ação a cada **2–4 s** (o feed pune quadro parado);
- assunto principal no **terço central** da tela vertical; nada importante nos ~15% de baixo nem na faixa direita;
- texto/overlay legível no celular (contraste, ≤ 2 linhas).
- Só pedir o que a cena atual faz (rua, entregador de moto); o resto vai para "Necessidades de produção".
## Trilho CORTE DE LIVE
- Não há cena a construir. Decisão: layout vertical. Hoje o Clipador usa **vídeo inteiro no meio + fundo
desfocado**. Quando a webcam for o centro da reação, o ideal é webcam em cima + jogo embaixo (ainda não existe —
lacuna do Clipador).
## Pronto quando
- [ ] (história) prévia com `status: success` e todas as `checks` ok; inspeção visual feita e descrita;
- [ ] primeiro segundo é o quadro mais forte; não há trecho > 4 s sem mudança visual;
- [ ] nada importante fora da zona segura;
- [ ] (corte) layout escolhido.
@@ -0,0 +1,39 @@
# 5 — Montagem
**Objetivo:** juntar imagem, voz, legenda e marcas num MP4 final 1080×1920 que segura até o fim.
**Saída:** MP4 final + legenda (`.srt` ou queimada) + registro na ficha.
## Regras (os dois trilhos)
- **Legenda queimada**, palavra a palavra ou em blocos de 1–3 palavras, grande, com contorno, palavra atual
destacada (formato que mais rende em vídeo curto; a maioria assiste sem som). Nunca na zona dos botões.
- **Cortes secos**: tirar respiração, "é…", silêncio morto. Ritmo > tamanho.
- Áudio: fala sempre inteligível; música/efeito abaixo da voz.
- Final: 1 s de pagamento + (história interativa) a tela de escolha com A/B legível.
- Sem marca d'água de outra rede (Instagram rebaixa).
## Trilho HISTÓRIA
- Render final pela skill `cenaforge` (`--profile final`, ~2 min 40 s) com `audio.file` da etapa 3.
- **Lacuna:** a Godot ainda não queima legenda. Até existir, opções: (a) só os textos de overlay da cena; (b)
queimar a legenda do WAV com FFmpeg + ASS no MP4 final (mesma técnica de `clipper/app/subtitles.py` e
`media.py`, com `-ss` antes do `-i` se houver corte).
- Verificar: `pnpm verify -- --file <mp4>` vale para o MP4 **saído do render** (lê o `scene.json` da mesma
pasta). Depois de queimar legenda à parte, grave o resultado com outro nome e confira com `ffprobe`
(1080×1920, H.264, AAC, duração) — o `verify` não se aplica a esse arquivo (não testado).
## Trilho CORTE DE LIVE
- O Clipador já monta: vertical, legenda ASS palavra a palavra (amarelo na palavra falada), **crédito do canal
no topo**, NVENC/libx264. Ajuste fino de início/fim na fila reenfileira o render.
- **Transformação mínima obrigatória** (ver [platforms.md](platforms.md)): gancho em texto (título), crédito,
legenda, corte justo. Para monetizar no YouTube, acrescente camada própria (contexto narrado/escrito, edição que
conta uma história, compilação temática com comentário).
## Pronto quando
- [ ] MP4 1080×1920, H.264, áudio AAC, duração dentro da faixa da etapa 6;
- [ ] legenda sincronizada (conferir quadros em 3 pontos) e dentro da zona segura;
- [ ] primeiro segundo tem imagem + texto; último segundo paga o gancho;
- [ ] (corte) crédito visível; (história) A/B legível no fim;
- [ ] visto por inteiro com som pelo menos uma vez (diga se não foi).
@@ -0,0 +1,34 @@
# 6 — Shorts (empacotamento por rede)
**Objetivo:** a mesma peça vira uma versão certa para cada rede: duração, título, descrição, hashtags, rótulos.
**Saída:** por rede de destino: título, descrição/legenda, hashtags, rótulo de IA (sim/não), crédito (corte).
## Formato
| | YouTube Shorts | TikTok | Instagram Reels |
|---|---|---|---|
| Vídeo | 9:16, 1080×1920, até 3 min | 9:16, até 10 min | 9:16 |
| Duração do CenaForge | história: duração da cena; corte: 15–59 s (≤ 60 s para terceiros) | idem | idem |
| Título | ≤ 70 chars, gancho + palavra de busca | texto curto no post | 1ª linha da legenda é o gancho |
| Hashtags | 3–5 relevantes (#shorts opcional) | 3–5 de nicho | 3–5 de nicho |
| Rótulo de IA | "alterado ou sintético" se realista | botão de rótulo IA se realista | "Informações de IA" |
## Regras
- **Título ≠ descrição do vídeo**: título é gancho ("Ele não viu o caminhão"), não resumo.
- **Legenda do post**: 1ª linha = gancho; depois contexto curto; CTA de compartilhar/comentar.
- História interativa: **CTA de voto** ("Comenta A ou B — o mais votado vira o próximo episódio").
- Corte: **crédito** obrigatório ("🎥 Créditos: <link do canal>") — o Clipador já acrescenta.
- Hashtags só do que está no vídeo (jogo do título da live, canal, assunto) — nunca inventar.
- **Mesma peça em várias redes:** suba o arquivo original em cada uma (nunca baixe de uma rede para postar em
outra — marca d'água rebaixa no Instagram).
- Série: título com "Parte N" ou "Ep. N" e a mesma identidade visual entre partes.
## Pronto quando
- [ ] para cada rede de destino: título, legenda, hashtags e rótulo de IA definidos;
- [ ] (história) CTA de voto com as opções exatas do overlay; (corte) crédito presente;
- [ ] nenhum texto promete o que o vídeo não mostra.
**Quem faz:** `cenaforge-story-writer` (títulos e legendas, inclusive A/B de título); corte: o juiz do Clipador
sugere título e legenda — revise na fila.
@@ -0,0 +1,38 @@
# 7 — Thumbnail (capa)
**Objetivo:** a capa que faz clicar no perfil/grade/busca — e que não mente.
**Saída:** imagem da capa (e o quadro escolhido) por rede; registrada na ficha.
## Onde a capa importa
- **YouTube Shorts:** capa personalizada existe desde 25/07/2026 (primeiro para canais do YPP; também dá para
escolher entre 3 quadros sugeridos). Aparece **cortada em ~3:2** → o assunto tem que estar no **centro**.
Shorts **não tem teste A/B** de capa. Vídeo longo tem "Testar e comparar" (até 3 capas).
- **TikTok/Reels:** capa = quadro escolhido ou imagem enviada; aparece na grade do perfil (recorte vertical).
- No feed, quem decide é o 1º segundo do vídeo, não a capa — a capa pesa em perfil, busca e sugestões.
## Regras (heurística consistente nas fontes)
1. **Rosto com expressão forte** (susto, riso) costuma ganhar de capa só com texto — teste no seu nicho.
2. **Texto ≤ 3–5 palavras**, grande, que complementa (não repete) o título.
3. Um assunto só, alto contraste, legível em miniatura (teste reduzindo para ~10% do tamanho).
4. Assunto no centro (sobrevive aos recortes 3:2 e da grade).
5. Série: mesma identidade (posição do texto, cor, "Ep. N").
6. Honesta: a cena da capa está no vídeo.
## Como fazer hoje no CenaForge
- **Lacuna:** não há gerador de capa. Caminho atual:
1. escolher o quadro (corte: o pico — o Clipador já salva `clip-<id>.jpg`; história: um quadro de
`inspect/` ou extraído do MP4);
2. extrair em alta: `ffmpeg -ss <t> -i <mp4> -frames:v 1 -q:v 2 capa.jpg` (`-ss` antes do `-i`);
3. texto por cima: FFmpeg `drawtext`/ASS ou editor externo.
- Teste: em vídeo longo use "Testar e comparar"; em Shorts compare capas **entre episódios** (uma variável por vez)
e leia o resultado em 2–3 semanas.
## Pronto quando
- [ ] quadro escolhido com o assunto no centro e expressão/ação forte;
- [ ] texto ≤ 5 palavras, legível em miniatura;
- [ ] capa corresponde a algo que acontece no vídeo;
- [ ] arquivo salvo e caminho na ficha.
@@ -0,0 +1,48 @@
# 8 — Agenda (aprovação → agendamento → publicação → métricas)
**Objetivo:** nada sai sem aprovação; o que é aprovado sai no melhor horário da conta certa; o resultado volta
para a pauta.
**Saída:** peça aprovada, com data/hora e conta(s) por rede, publicada e acompanhada.
## Fluxo
1. **Aprovação humana (obrigatória, decisão do usuário).**
- Corte: fila do Clipador (`ready` → `approved`/`rejected`). Aprovar cria as publicações nas redes dos canais
ligados à fonte; com **aprovação automática** ligada no canal, cortes novos são aprovados sozinhos. O painel marca
`published` no Clipador quando todas as redes confirmarem.
- História: o episódio é aprovado pelo usuário depois do render final (prévia + final conferidos).
2. **Destino:** conta(s) pela página **Contas** (conta ↔ histórias, conta ↔ canais do Clipador).
3. **Janela:** horários sugeridos para o Brasil em [platforms.md](platforms.md) até haver dados próprios; depois,
o horário em que o público da conta está online (analytics da rede).
4. **Frequência (ponto de partida):** Shorts 3–5/semana com constância; Reels 1 bom/dia > 3 medianos; espalhar
cortes do mesmo canal ao longo do dia/semana em vez de despejar tudo junto; misturar conteúdo próprio
(histórias) com cortes.
5. **Publicação:** automática pelo painel (desde 17/11/2026). O canal de publicação define a **aprovação**
(manual ou automática para cortes; episódio sempre pelo botão "Aprovar para publicar") e **quando sai** (na hora
ou no próximo horário bom, com limite por dia por rede). Cada rede conecta por **API oficial** ou **sessão logada**,
à escolha do usuário. Acompanhe em **Publicações** (`/publishing`); só conta como publicado com link/ID da rede.
O painel precisa estar aberto e o Publicador rodando (`pnpm dev`). Limites por rede em [platforms.md](platforms.md);
plano técnico em `doc/publicacao/PLANO.md`.
6. **Interativa:** ao publicar, registrar a votação; ao fechar (`closeDecision` no painel) a vencedora vira
principal e o próximo nível é preparado — a agenda do próximo episódio nasce aqui.
7. **Métricas (24 h, 72 h, 7 dias):** retenção aos 3 s, % que assistiu até o fim, compartilhamentos/salvamentos
por alcance, comentários (votos), seguidores ganhos; série: % da parte 1 que viu a parte 2. O dashboard do
painel ainda usa **métricas simuladas** — não trate como reais.
8. **Volta para a pauta:** o que funcionou vira regra da conta; o que falhou vira hipótese para testar (uma
variável por vez: gancho, duração, capa, horário).
## Calendário
Use a tabela da ficha ([../templates/ficha.md](../templates/ficha.md)) ou, para uma semana, uma linha por peça:
`data | hora | rede | conta | peça | status (aprovado/agendado/publicado) | link`.
## Pronto quando
- [ ] aprovado pelo usuário (registro de quem/quando);
- [ ] conta e rede de destino; data/hora definidas;
- [ ] título, legenda, capa e rótulo de IA da etapa 6–7 anexados;
- [ ] (após publicar) link registrado e lembrete de leitura de métricas em 24 h / 7 dias.
**Lacunas:** sem métricas reais (o dashboard ainda usa simuladas); envio real ainda não validado com conta de
verdade em todas as redes. Não diga que algo foi "agendado" ou "publicado" se só foi aprovado — confira o estado em
**Publicações**.
@@ -0,0 +1,112 @@
# Regras e sinais das plataformas (pesquisa de 16/11/2026)
**Como ler:** "confirmado" = anúncio da própria plataforma ou imprensa citando a plataforma. "Heurística" = blog
de ferramenta/agência, sem dado primário — use como ponto de partida e troque pelos seus números.
Reverifique a cada 3 meses. Nunca apresente heurística como regra oficial.
## Sinais de distribuição
| O quê | Status | Resumo |
|---|---|---|
| Tempo assistido e taxa de conclusão pesam mais que curtidas (TikTok, Reels, Shorts) | consenso de mercado; TikTok não publica pesos | gancho + vídeo que se assiste até o fim / reassiste |
| Compartilhamentos/envios e salvamentos > curtidas | heurística consistente | escreva para ser enviado ("manda pro amigo que…") |
| Sinais negativos ("Não tenho interesse", pular cedo) derrubam | consenso | não prometa no gancho o que o vídeo não entrega |
| Retenção aos 3 s ≈ 70–80% como alvo; queda > 50% nos 3 s = vídeo morto | heurística (números variam) | a referência real é o gráfico de retenção do YouTube Studio |
| Série: medir quantos que terminaram a parte 1 viram a parte 2 | heurística | métrica-chave das histórias por episódio |
## Originalidade e conteúdo reutilizado (crítico para o Clipador)
- **Instagram (abr–mai/2026, Mosseri):** conta cujo conteúdo é majoritariamente de outras pessoas deixa de ser
recomendável; ao detectar conteúdo idêntico, o Instagram recomenda o original no lugar do repost e rotula o repost
com link para o original. Marca d'água de outra rede, corte mínimo ou repost simples não contam como original.
— confirmado pela imprensa citando Mosseri (detalhes de limiar não confirmados).
- **YouTube (política de conteúdo reutilizado):** compilação/reação/corte só monetiza com **comentário original
significativo, modificação ou valor educativo/de entretenimento**; vale para o canal inteiro; **permissão do
criador não resolve** (resolve copyright/Content ID, não a "originalidade"). — fontes secundárias; conferir a
página oficial antes de pedir monetização.
- **Permissão de clipar:** crédito não é permissão. Permissão boa diz: quais clipes, quais redes, se pode editar,
se pode monetizar, por quanto tempo. Música do jogo/fundo é direito separado (Content ID).
- **Consequência para o trilho Corte:** sempre transformar (gancho escrito, contexto em texto ou narração própria,
edição/zoom, legenda, crédito no vídeo e na descrição) e misturar com conteúdo próprio (as histórias) nas contas.
## Formato
| Rede | Fato | Status |
|---|---|---|
| YouTube Shorts | vertical/quadrado até **3 min** (desde out/2024) | confirmado |
| YouTube Shorts | **capa personalizada** desde 24–25/07/2026 (Neal Mohan), primeiro para canais do YPP; aparece cortada em ~3:2; **sem teste A/B** em Shorts | confirmado (recorte e YPP via imprensa) |
| YouTube Shorts | uma fonte diz que regra de copyright para Shorts > 60 s muda em 24/09/2026 | **não confirmado** — manter cortes de terceiros ≤ 60 s por precaução |
| YouTube (vídeo longo) | "Testar e comparar": até 3 capas por vídeo | confirmado; critério do vencedor varia nas fontes |
| TikTok | vídeos longos permitidos (até 10 min no app) | confirmado |
| Todas | 1080×1920, 9:16, legenda queimada (a maioria assiste sem som) | prática consolidada |
Zona segura (heurística): texto importante fora dos ~15% de baixo (legenda/@ da rede) e da faixa direita
(botões do TikTok/Reels). No Clipador a legenda fica centrada em y≈1420 de 1920 — dentro da zona segura.
## Rótulo de conteúdo feito com IA
| Rede | Regra (fontes secundárias, conferir) |
|---|---|
| YouTube | pergunta "alterado ou sintético" no upload para conteúdo **realista**; detecção automática e rótulo para conteúdo fotorrealista gerado por IA; edição menor não precisa |
| TikTok | rótulo obrigatório para conteúdo realista gerado por IA (botão no post); pode rotular sozinho via metadados C2PA; rótulo não reduz distribuição |
| Instagram/Meta | rótulo "Informações de IA", aplicado também por sinais C2PA |
| UE (AI Act, art. 50) | regras de transparência a partir de ago/2026 |
**Regra do CenaForge:** episódio animado (3D estilizado + TTS genérico) não é "realista" — rótulo opcional.
**Marque IA** quando houver voz que imita pessoa real (RVC de personagem baseado em alguém) ou imagem realista.
## Horários e frequência (Brasil — heurística, testar)
| Rede | Janelas sugeridas (horário de Brasília) | Frequência sugerida |
|---|---|---|
| TikTok | 7–9h e 18–22h; fim de semana mais amplo (sáb 10–18h, dom 11–19h) | sem número confiável para BR |
| Reels | 11–13h e 19–21h (seg–qui); domingo à tarde forte | 1 Reel bom/dia > 3 medianos |
| Shorts | uma fonte aponta 14–16h | constância: 3–5/semana |
As fontes discordam entre si: depois de 2–4 semanas, use os horários do seu próprio público (analytics).
## Publicação por API (limites que afetam a etapa 8) — atualizado em 17/11/2026
Detalhe completo e fontes: [doc/publicacao/PESQUISA.md](../../../../doc/publicacao/PESQUISA.md).
- YouTube Data API: desde 02/11/2026 app **não verificado já publica público**; cota de `videos.insert` = **100/dia**.
Deixe o app do Google "In production" (em "Testing" a autorização vence em 7 dias).
- TikTok Content Posting API: sem auditoria, só **SELF_ONLY** (privado) ou **rascunho** na caixa de entrada do app;
a auditoria provavelmente é negada para ferramenta de uso próprio. Público só pelo modo **sessão logada**.
- Instagram: conta **Profissional**; "Instagram API with Instagram Login" dispensa Página do Facebook e, para conta
própria, dispensa App Review. Token longo de 60 dias.
- Modo **sessão logada** (sem API) existe nas três redes, mas **viola os termos** delas (risco de bloqueio da conta).
## Fontes
- Ganchos e retenção: [vidIQ — views em Shorts](https://vidiq.com/blog/post/get-more-views-youtube-shorts/),
[Opus — fórmulas de gancho](https://www.opus.pro/blog/youtube-shorts-hook-formulas),
[dev.to — Hook Engineering 2026](https://dev.to/bulkdl/hook-engineering-the-science-of-the-first-3-seconds-in-short-form-video-2026-2jp9)
- TikTok: [Hootsuite — algoritmo](https://blog.hootsuite.com/tiktok-algorithm/),
[Darkroom — guia 2026](https://www.darkroomagency.com/observatory/tiktok-algorithm-guide-2026-everything-we-know-about-how-videos-are-ranked)
- Instagram originalidade: [PetaPixel 30/04/2026](https://petapixel.com/2026/04/30/new-instagram-policies-target-reposted-content/),
[Tecnoblog](https://tecnoblog.net/noticias/instagram-reforca-combate-a-reposts-do-tiktok-e-de-outros-videos-no-reels/),
[Engadget](https://www.engadget.com/instagrams-algorithm-overhaul-will-reward-original-content-and-penalize-aggregators-130018977.html),
[SocialPilot — Reels 2026](https://www.socialpilot.co/?p=563048)
- YouTube reutilizado: [vidIQ — política](https://vidiq.com/blog/post/youtube-reused-content-policy-guide/),
[Search Engine Journal](https://www.searchenginejournal.com/youtube-clarifies-monetization-update-targeting-spam-not-reaction-channels/550123/),
[AIR — linha do tempo 2026](https://air.io/en/monetization/youtube-monetization-policy-changes-2026-a-complete-dated-timeline)
- Shorts formato/capa: [Tubefilter 24/07/2026](https://www.tubefilter.com/2026/07/24/youtube-shorts-custom-thumbnails-neal-mohan-feature-update/),
[Relevant Audience — sem A/B](https://www.relevantaudience.com/social-media-marketing/youtube-shorts-custom-thumbnails-no-ab-testing/),
[Descript — duração](https://www.descript.com/blog/article/how-long-can-youtube-shorts-be)
- Thumbnail: [vidIQ — dicas 2026](https://vidiq.com/blog/post/youtube-thumbnail-tips/),
[ThumbnailTest](https://thumbnailtest.com/guides/best-practices-youtube-thumbnail/),
[PostIgniter — testes](https://postigniter.com/blog/youtube-thumbnails-as-performance-assets-design-testing-and-iteration-strategies-for-2026)
- Rótulo de IA: [The Next Web — YouTube auto-rótulo](https://thenextweb.com/news/youtube-will-now-automatically-label-ai-generated-videos-whether-creators-disclose-them-or-not),
[Billo — rótulos 2026](https://billo.app/blog/ai-labeling/),
[Fanpage Karma — AI Act](https://www.fanpagekarma.com/insights/?p=16910)
- Horários BR: [Cut.pro — Reels Brasil 2026](https://cut.pro/pt-BR/blog/best-time-to-post-reels-brazil),
[TimeToPost — TikTok Brasil](https://timetopost.co/best-time-to-post/tiktok/brazil/),
[Hopper HQ — TikTok 2026](https://hopperhq.com/blog/best-time-to-post-on-tiktok/)
- Séries curtas: [Influencers-Time — séries com cliffhanger](https://www.influencers-time.com/how-to-build-a-tiktok-series-with-cliffhangers-that-retain-v/),
[NoGood — micro-dramas](https://nogood.io/blog/micro-drama/)
- Narração e legenda: [Syllaby — ritmo de locução](https://syllaby.io/blog/voiceover-pacing-silence-trimming-retention-editing/),
[Opus — legendas TikTok 2026](https://www.opus.pro/blog/tiktok-caption-subtitle-best-practices)
- Clipes de terceiros: [ClipSpeed — copyright](https://clipspeed.ai/blog/can-you-clip-someone-elses-stream.html),
[Twitch Creator Camp — copyright](https://twitch.tv/creatorcamp/paths/getting-started-on-twitch/copyrights-and-your-channel),
[ABA — DMCA para streamers (set/2026)](https://www.americanbar.org/groups/business_law/resources/business-law-today/2026-september/dmca-lessons-for-live-streamers-their-counsel/)