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
+71
View File
@@ -0,0 +1,71 @@
# Publicação nas redes — pesquisa de 17/11/2026
[C] = confirmado em página oficial · [S] = fonte secundária / a testar. Reverificar a cada 3 meses.
## YouTube (Data API v3)
- **Projeto não verificado já publica público** desde 02/11/2026 (revision history) [C]. Sem `privacyStatus` ⇒ `public`.
- Cota: desde 01/06/2026 `videos.insert` tem balde próprio de **100/dia** (custo 1); demais chamadas 10.000 unidades; zera meia-noite PT [C].
- OAuth: cliente **"Desktop app"**, redirect loopback `http://127.0.0.1:<porta>` (qualquer porta), **PKCE sempre** [C]. Escopo mínimo `youtube.upload`.
- Upload resumable (`uploadType=resumable`), `video/*` [C].
- Metadados: `snippet.title/description/tags`; `status.privacyStatus`, `publishAt` (exige `private` e nunca publicado), `selfDeclaredMadeForKids`, **`containsSyntheticMedia`** [C].
- `thumbnails.set` aceita capa personalizada em Shorts desde 03/11/2026, depois do processamento [C].
- Vira Short: ≤ 3 min e vertical/quadrado; não existe campo "isShort" [C].
- Tokens: app em **"Testing" expira autorização em 7 dias** (inclui refresh). Colocar o app em **"In production"** (mesmo sem verificação) resolve; aparece tela "app não verificado"; teto 100 usuários — irrelevante [C].
- Libs: `google-api-python-client` 2.202.0, `google-auth-oauthlib` 1.5.0 (PyPI); `googleapis` 190.0.0 (npm) [C].
## TikTok (Content Posting API)
- OAuth desktop: host `localhost`/`127.0.0.1` com porta (curinga `*` aceito); **PKCE obrigatório, S256 com desafio em hex** do SHA-256 [C].
- Access token 2 h; refresh 180 d **rotativo** — gravar sempre o novo [C].
- Direct Post (`video.publish`): chamar antes `POST /v2/post/publish/creator_info/query/`. Campos: `title` (≤2200), `privacy_level` (obrigatório, vindo do creator_info), `disable_comment/duet/stitch`, `video_cover_timestamp_ms`, `brand_content_toggle`, `brand_organic_toggle`, **`is_aigc`** [C].
- Rascunho (`video.upload`): `/v2/post/publish/inbox/video/init/`; vai para a caixa de entrada do app; máx. **5 pendentes/24 h** [C]. Funciona sem auditoria [S].
- FILE_UPLOAD: PUT em blocos 5–64 MB (último até 128 MB), ≤ 4 GB, ≤ 10 min, 23–60 fps, `upload_url` vale 1 h. PULL_FROM_URL exige domínio verificado ⇒ **usar FILE_UPLOAD** [C].
- 6 req/min por token; erro `spam_risk_too_many_posts` [C].
- **Sem auditoria: só `SELF_ONLY`, a conta precisa estar privada, máx. 5 usuários/24 h** [C].
- UI exigida pelo TikTok: mostrar apelido do criador; privacidade escolhida à mão **sem padrão**; interações desmarcadas; divulgação comercial; prévia; declaração de uso de música; sem marca d'água [C].
- **Auditoria provavelmente negada**: a TikTok lista como inaceitável "utility tool to help upload contents to the account(s) you or your team manages" e apps de uso interno/privado [C].
## Instagram (Reels)
- Conta **Profissional** (Business/Creator) [C].
- **Instagram API with Instagram Login**: sem Página do Facebook; host `graph.instagram.com`; escopos `instagram_business_basic`, `instagram_business_content_publish` [C].
- Facebook Login for Business: exige Página; `graph.facebook.com` + `rupload.facebook.com` [C].
- Upload resumable com **arquivo local** (rupload) é documentado "só para Facebook Login for Business"; com Instagram Login precisaria de `video_url` pública. Blogs mostram rupload funcionando com `graph.instagram.com` [C/S — **testar**].
- Fluxo: container `media_type=REELS` → (rupload) → consultar `status_code` 1×/min até 5 min → `media_publish`; container expira em 24 h [C].
- Campos: `caption`, `cover_url`, `thumb_offset`, `share_to_feed`, `audio_name`, `collaborators` (≤3), `trial_params`, **`is_ai_generated`** [C].
- Vídeo: MP4/MOV com moov no início, H.264/HEVC, 23–60 fps, 3 s–15 min, ≤ 300 MB, 9:16 recomendado [C].
- Limite: 100 posts/24 h (a página também cita 50); consultar `/content_publishing_limit` [C].
- Conta própria ("I own or manage"): Standard Access, **sem App Review** [C].
- Token longo 60 d, renovável por `refresh_access_token` (> 24 h de idade) [C].
- Redirect precisa bater exatamente; a Meta **não aceita localhost** e pede HTTPS [S] ⇒ usar token gerado no painel de desenvolvedor.
## Modo sessão logada (sem API)
- **Viola os termos das três redes** (YouTube: "qualquer meio automatizado"; TikTok: "automated scripts"; Instagram: automação sem permissão) — risco de bloqueio/checkpoint é do usuário.
- Bibliotecas: `tiktok-uploader` v1.2.0 (fev/2026, parada); `instagrapi` 3.2.15 (API privada do app móvel — **maior risco, não usar**); `youtube_uploader_selenium` (abandonada); `social-auto-upload` (depende de burla de detecção — **descartar**).
- Abordagem honesta: Playwright com perfil **próprio e vazio** (automatizar o perfil padrão do Chrome não é suportado), navegador visível, **usuário loga à mão**, nunca automatizar senha/captcha.
- O Google costuma bloquear login em navegador controlado por automação ("This browser or app may not be secure") [S] ⇒ abrir Chrome/Edge **normal** com `--user-data-dir` dedicado, o usuário loga, e só depois conectar via `connectOverCDP`.
- Sessão expirada: redirecionamento para login, botão "Entrar/Log in" por role, ou ausência do campo de arquivo/botão "Criar".
- Seletores: `getByRole`/`getByLabel`/`getByText` em PT e EN; screenshot e trace na falha; teste de fumaça que só abre a tela de upload. As telas mudam com frequência [S].
## Comparativo
| | Publica | Limitações | Risco |
|---|---|---|---|
| YouTube API | público, privado, agendado, Short automático | 100/dia; tela "não verificado" | baixo |
| YouTube sessão | o mesmo pelo Studio | login Google pode ser bloqueado; UI muda | alto (termos) |
| TikTok API | rascunho no app; Direct Post só SELF_ONLY sem auditoria | 5 rascunhos/24 h | baixo |
| TikTok sessão | post público | captcha; UI instável | alto (termos) |
| Instagram API | Reel público, capa, rótulo IA | token 60 d; rupload a testar | baixo |
| Instagram sessão | Reel pelo site | checkpoints frequentes | alto (termos) |
## Fontes
developers.google.com/youtube/v3/revision_history · /docs/videos/insert · /docs/videos · /determine_quota_cost ·
developers.google.com/identity/protocols/oauth2/native-app · support.google.com/cloud/answer/15549945 ·
support.google.com/youtube/answer/15424877 · developers.tiktok.com/doc/content-posting-api-reference-direct-post ·
/content-posting-api-reference-upload-video · /content-posting-api-media-transfer-guide · /content-sharing-guidelines ·
/login-kit-desktop · /oauth-user-access-token-management · developers.facebook.com/docs/instagram-platform/content-publishing ·
/content-publishing/resumable-uploads · /instagram-api-with-instagram-login · /app-review ·
playwright.dev/docs/api/class-browsertype#browser-type-launch-persistent-context