Files
CenaForge/doc/publicacao/PESQUISA.md
T
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

6.7 KiB
Raw Blame History

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