Files
MateuusandClaude Opus 5.5 84f30bbc2d 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>
2026-11-17 16:35:09 -03:00

72 lines
6.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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