Communitygithub.com

TeamWiseFlow/tiktok-post

Faça upload e publique um vídeo (ou carrossel de imagens) no TikTok usando o navegador.

O que é tiktok-post?

O TikTok Post Skill permite que agentes de IA publiquem vídeos ou carrosséis de imagens no TikTok diretamente pelo navegador, automatizando todo o fluxo de upload. Ele suporta a definição de legendas, hashtags, capas personalizadas e até agendamento de postagens. O skill foi projetado para funcionar com ferramentas de navegador headless, como as usadas no OpenClaw, e inclui tratamentos robustos de erros para lidar com timeouts de upload e falhas de autenticação. É especialmente útil para cross-posting de vídeos gerados por outros skills (como video-producer) e segue as melhores práticas de legendas do TikTok para maximizar o alcance. O fluxo principal consiste em navegar para a página de upload do Creator Center, fazer o upload do arquivo (com suporte a MP4, MOV e WebM), esperar o processamento, preencher a legenda, selecionar capa e publicar. O skill também lida com cenários comuns de falha, como sessão expirada ou conteúdo rejeitado, garantindo que o usuário seja informado adequadamente sem retentativas automáticas em caso de violação de políticas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TeamWiseFlow/wiseflow/tree/master/addons/officials/crew/selfmedia-operator/skills/tiktok-post

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Publicação no TikTok (TikTok-Post)

Use esta habilidade quando:

  • O usuário deseja publicar um vídeo no TikTok (versão internacional)
  • Você precisa fazer cross-posting de um vídeo curto gerado pelo video-producer
  • Você precisa definir legenda, hashtags e capa para uma postagem no TikTok

Pré-requisitos: A sessão do navegador deve estar logada em tiktok.com.


Restrições Gerais

  • Antes do upload, o arquivo deve ser copiado para /tmp/openclaw/uploads/ (limitação do sandbox da ferramenta browser)
  • A ferramenta browser upload pode retornar um "erro de timeout", mas isso não significa que o upload falhou! Após o upload, use snapshot para verificar o estado da página (barra de progresso, texto de status do processamento)
  • Não verifique se input.files.length é 0 para determinar se o upload falhou! input.files.length == 0 não indica falha no upload.
  • Ao encontrar o erro browser failed: timed out. Restart the OpenClaw gateway ..., não é necessário reiniciar nem reportar erro! Aguarde 30 segundos e continue operando na mesma página. Se ainda não funcionar, aguarde mais 30 segundos; se persistir, tente fechar e reabrir o navegador. Somente se após fechar e reabrir o erro continuar é que realmente houve uma falha — pare e informe o usuário.
  • Para inserir a legenda, use type + slowly: true; não use fill()

Aquecimento de Cookie

Navegue primeiro para https://www.tiktok.com. Se redirecionar para a página de login, a sessão expirou — informe o usuário.


Fluxo de Trabalho: Upload de Vídeo

1. Navegue para https://www.tiktok.com/creator-center/upload
   (alternativa: https://www.tiktok.com/upload)
2. Aguarde o carregamento da página de upload
3. Clique em "Selecionar vídeo" ou arraste e solte o arquivo de vídeo na área de upload
   - Formatos suportados: MP4, MOV, WebM
   - Recomendado: 9:16 vertical, 1080×1920, abaixo de 500MB
   - Duração: 15s – 10 minutos
4. Aguarde o fim do upload e processamento (barra de progresso atinge 100%)
5. Clique na área de legenda e digite a legenda:
   - Texto simples + hashtags (use formato #tag)
   - Máximo de 2200 caracteres
   - Inclua 3–5 hashtags relevantes para descoberta
6. Defina a imagem de capa:
   - Clique em "Capa" e selecione um frame do vídeo
   - Ou faça upload de uma imagem de capa personalizada
7. Clique no botão "Publicar"
8. Aguarde a confirmação — o TikTok mostra "Seu vídeo foi publicado" ou mensagem similar
9. Copie e relate a URL da postagem

Fluxo de Trabalho: Agendar Postagem (se disponível)

Após o passo 6 acima:
1. Ative "Agendar" em vez de publicar imediatamente
2. Selecione data e hora (fuso horário detectado automaticamente das configurações da conta)
3. Clique em "Agendar"

Melhores Práticas para Legendas

  • Comece com um gancho na primeira linha (exibido no feed antes da truncagem "mais")
  • Adicione hashtags no final, não no meio do texto
  • Use uma mistura de tags amplas (#ia #tecnologia) e tags de nicho (#ferramentasai #wiseflow)
  • Mantenha a mensagem principal com menos de 100 caracteres antes das hashtags

Tratamento de Erros

SituaçãoAção
Página de loginSessão expirada — informe o usuário para refazer o login
Vídeo rejeitado (violação de política)Relate o motivo ao usuário; não tente novamente automaticamente
Upload travado em %Aguarde até 3 minutos; se ainda travado, atualize a página
Legenda muito longaCorte primeiro as hashtags, depois a legenda
Falha na seleção de capaPule a personalização da capa e use a capa gerada automaticamente

Observações

  • A interface de upload do TikTok muda frequentemente — se um botão/elemento não for encontrado, procure por UI equivalente baseada na intenção
  • Sempre confirme a URL da postagem após a conclusão
  • Não publique conteúdo que viole as Diretrizes da Comunidade do TikTok

Habilidades Relacionadas