publora/tiktok-post

TikTok Post

Envie e agende vídeos para o TikTok usando o servidor MCP Publora. Suporta controles de privacidade, configurações de interação (comentários, dueto, stitch) e divulgação de conteúdo comercial.

Pré-requisitos

Planos: Funciona no plano gratuito Starter. Limites e preços atuais: publora.com/pricing.

Começando

1. Crie uma conta em publora.com/register (gratuito)
2. Conecte o TikTok via OAuth no Publora Dashboard
3. Obtenha a chave de API em app.publora.com/dashboard/api
4. Conecte seu agente ao servidor MCP em https://mcp.publora.com, autenticando com Authorization: Bearer sk_SUA_CHAVE_API. No Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_SUA_CHAVE_API"

Claude Desktop, Cursor, Codex, OpenClaw e o conector claude.ai precisam de um arquivo de configuração ou fluxo diferente: veja configuração do cliente para o caminho e trecho exatos.

Fallback da API REST

Se o servidor MCP estiver indisponível ou retornar erros, use a API REST diretamente:

URL Base: https://api.publora.com/api/v1

Autenticação: Use o cabeçalho x-publora-key (NÃO Authorization: Bearer):

# Obtenha suas plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_sua_chave_api"

# Crie uma postagem
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok-99887766"],
    "content": "Legenda do vídeo aqui #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z",
    "platformSettings": {
      "tiktok": {
        "viewerSetting": "PUBLIC_TO_EVERYONE",
        "allowComments": true
      }
    }
  }'

Formato do ID da Plataforma: tiktok-{id} onde {id} vem da resposta de /platform-connections.

Exemplos de IDs: tiktok-99887766, tiktok-123456789

📖 Documentação completa da API: docs.publora.com

Limites da Plataforma (API vs Aplicativo Nativo)

Limites críticos da API que diferem do aplicativo nativo do TikTok:

Requisitos de Vídeo

Especificação	Limite da API	Aplicativo Nativo
Duração máxima	10 minutos	60 minutos
Duração mínima	3 segundos	3 segundos
Tamanho máximo do arquivo	4 GB	4 GB
Taxa de quadros mínima	23 FPS	23 FPS
Formatos	MP4, MOV, WebM	MP4, MOV, WebM

Limites de Legenda

Elemento	Limite da API	Aplicativo Nativo
Tamanho da legenda	2.200 caracteres	4.000 caracteres
Hashtags	Incluídas na contagem da legenda	Incluídas na contagem da legenda

Limites de Taxa

Limite	Valor
Postagens por dia	15-20
Vídeos por minuto	Máx. 2

Ferramentas Disponíveis

create_post

Crie uma nova postagem no TikTok.

Parâmetros:

• platforms: Array com o ID da sua conexão TikTok (ex.: ["tiktok-99887766"])
• content: Legenda do vídeo (até 2.200 caracteres)
• scheduledTime: Data/hora UTC no formato ISO 8601. Opcional: omita e a postagem é criada como rascunho. Envie um horário futuro para agendar. Um horário com cinco ou mais minutos no passado é rejeitado com SCHEDULED_TIME_IN_PAST; para postagem imediata, use o horário atual mais um minuto.
• mediaUrls: até 10 URLs de imagem ou vídeo públicas https. Publora as baixa no servidor e as anexa antes da validação, então mídia e agendamento ocorrem em uma única chamada. Esta é a alternativa única ao fluxo de rascunho seguido de get_upload_url e complete_media. A ingestão é limitada a 60 URLs por hora.

get_upload_url

Obtenha uma URL pré-assinada para upload de vídeo.

Parâmetros:

• postGroupId: ID da postagem para anexar o vídeo
• fileName: Nome do arquivo de vídeo (ex.: "video.mp4")
• contentType: video/mp4, video/quicktime ou video/webm
• type: "video"

complete_media

Finalize um arquivo enviado via get_upload_url, após o PUT pré-assinado ser bem-sucedido. Opcional, porque o agendamento também finaliza mídia pendente, mas chamá-lo cedo expõe erros de formato e sonda antes da publicação. Não é necessário para mídia anexada com mediaUrls.

Parâmetros:

• mediaId: o ID retornado por get_upload_url

list_connections

Liste suas contas conectadas com seus IDs de plataforma. Chame esta função primeiro e copie os IDs exatamente como retornados; eles nunca são adivinháveis.

list_posts / get_post / update_post / delete_post

Gerencie postagens agendadas e rascunhos. update_post também corrige content e platforms em um rascunho ou postagem agendada, então corrigir um erro de digitação ou redirecionar não significa mais deletar e recriar. delete_media e prune_media_reference limpam arquivos enviados.

Configurações da Plataforma (via API REST)

O TikTok tem 7 configurações específicas da plataforma controladas via platformSettings:

{
  "platformSettings": {
    "tiktok": {
      "viewerSetting": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "allowDuet": false,
      "allowStitch": false,
      "commercialContent": false,
      "brandOrganic": false,
      "brandedContent": false
    }
  }
}

Configurações de Visualização (Obrigatório)

Valor	Descrição
PUBLIC_TO_EVERYONE	Qualquer um pode ver (padrão)
MUTUAL_FOLLOW_FRIENDS	Apenas seguidores mútuos
FOLLOWER_OF_CREATOR	Apenas seus seguidores
SELF_ONLY	Apenas você (como rascunho)

Configurações de Interação

Configuração	Padrão	Descrição
allowComments	true	Se os visualizadores podem comentar
allowDuet	false	Se os visualizadores podem criar Duetos
allowStitch	false	Se os visualizadores podem usar Stitch

Configurações de Conteúdo Comercial

Configuração	Padrão	Descrição
commercialContent	false	Este é conteúdo comercial?
brandOrganic	false	Promoção orgânica de marca
brandedContent	false	Parceria paga/patrocinado

Nota: Se commercialContent for true, pelo menos um de brandOrganic ou brandedContent também deve ser true.

Nota: platformSettings é aceito pelas ferramentas MCP create_post e update_post, bem como pela API REST. O esquema é estrito: uma plataforma ou chave digitada incorretamente é rejeitada com um erro de validação, em vez de ser ignorada silenciosamente.

Restrições Críticas

1. Aplicativos Não Auditados = Apenas PRIVADO

CRÍTICO: Se seu aplicativo TikTok não passou pelo processo de revisão do TikTok, você só pode postar vídeos PRIVADOS (SELF_ONLY). Todos os outros valores de viewerSetting serão substituídos por SELF_ONLY.

Para postar vídeos públicos, seu aplicativo deve ser auditado pelo TikTok.

2. Mídia Obrigatória, Vídeo ou Carrossel de Imagens

O TikTok NÃO suporta postagens apenas com texto: toda postagem precisa de mídia.

Ele aceita carrosséis de imagens: até 35 imagens, JPEG, PNG ou WebP, 20 MB cada. Uma postagem é um carrossel ou um único vídeo, nunca ambos.

3. Mínimo de 23 FPS

Vídeos abaixo de 23 quadros por segundo serão rejeitados pelo TikTok.

Exemplos

Postagem Básica de Vídeo

Publique este vídeo no TikTok:
"Como construímos nossa startup em 60 segundos #startup #tech #coding"

Rascunho Privado (Teste)

Envie este vídeo como rascunho privado para o TikTok (só eu posso ver):
"Testando novo formato de conteúdo"

Use viewerSetting: "SELF_ONLY" para testar antes de tornar público.

Conteúdo Marcado

Publique este vídeo patrocinado no TikTok com divulgação adequada:
"Estou amando este novo produto da @marca! #publi #patrocinado"

Defina commercialContent: true e brandedContent: true para parcerias pagas.

Postagem Agendada

Agende este vídeo do TikTok para amanhã às 18h:
"Vibes de fim de semana chegando! #fimdesemana #diversao"

Formatos de Vídeo Suportados

Formato	Recomendado	Notas
MP4	Sim	Mais confiável
MOV	Sim	Formato Apple
WebM	Sim	Formato web
AVI	Aceito pelo Publora	Pode ser rejeitado pelo TikTok
MKV	Aceito pelo Publora	Pode ser rejeitado pelo TikTok

Recomendação: Use MP4 para melhor compatibilidade.

Melhores Práticas

Conteúdo

1. Gancho nos primeiros 3 segundos: Prenda a atenção imediatamente
2. Duração ideal: 15-60 segundos para melhor engajamento
3. Sons em alta: Use áudio em tendência quando possível
4. Estratégia de hashtags: 3-5 hashtags relevantes

Técnico

1. Vídeo vertical: Proporção 9:16 tem melhor desempenho
2. Alta qualidade: Pelo menos 720p de resolução
3. 23+ FPS: Garanta reprodução suave
4. Formato MP4: Formato mais confiável

Horários

• Melhores horários: 7-9h, 12-15h, 19-23h no fuso horário alvo
• Frequência: 1-3 postagens por dia para crescimento
• Consistência: Cronograma regular de postagens ajuda o algoritmo

Solução de Problemas

Erro	Causa	Solução
unaudited_client_can_only_post_to_private_accounts	Aplicativo não aprovado	Envie o aplicativo para revisão do TikTok ou use SELF_ONLY
spam_risk_too_many_posts	Limite diário atingido	Aguarde 24 horas
duration_check_failed	Vídeo muito longo/curto	Garanta entre 3 segundos e 10 minutos
file_format_check_failed	Formato de vídeo incorreto	Use MP4, MOV ou WebM
"23 FPS required"	Taxa de quadros baixa	Recodifique o vídeo com 23+ FPS
"TikTok requires selecting who can view"	Faltando viewerSetting	Sempre inclua viewerSetting em platformSettings