Communitygithub.com

Automação TikTok via Rube MCP

Automatize tarefas do TikTok via Rube MCP (Composio): fazer upload/publicar vídeos, postar fotos, gerenciar conteúdo e visualizar perfis/estatísticas. Sempre pesquise ferramentas primeiro para obter os esquemas atuais.

O que é Automação TikTok via Rube MCP?

Esta skill capacita agentes de IA a automatizar a gestão de conteúdo do TikTok usando o Rube MCP, que atua como uma camada de integração sobre o kit de ferramentas TikTok do Composio. Ela suporta fluxos de trabalho completos, incluindo upload de vídeos, publicação, postagem de fotos, listagem de vídeos publicados, visualização de perfil e estatísticas, e verificação de status de publicação. O principal caso de uso é permitir que os agentes executem operações do TikTok de forma programática, sem intervenção manual, após uma configuração única de autenticação OAuth. A skill é compatível com qualquer cliente que suporte o protocolo MCP, como Claude Code, Cursor e Codex. Ela funciona primeiro pesquisando as ferramentas disponíveis via `RUBE_SEARCH_TOOLS` para obter os esquemas atuais, depois gerenciando a conexão com o TikTok via `RUBE_MANAGE_CONNECTIONS` e, finalmente, chamando ferramentas específicas do TikTok (por exemplo, `TIKTOK_UPLOAD_VIDEO`, `TIKTOK_PUBLISH_VIDEO`) em sequências definidas. Uma distinção crítica é que o upload e a publicação de vídeos são etapas separadas, exigindo sondagem de status entre elas. A skill documenta parâmetros, armadilhas (limites de taxa, requisitos de conteúdo, escopos de token) e padrões de paginação para garantir uma automação robusta.

Funciona com~Claude Code~Codex CLI✓Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/tiktok-automation

Perguntar na sua IA favorita

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

Documentação

O que Automação TikTok via Rube MCP faz?

Automatize a criação de conteúdo e operações de perfil no TikTok através do kit de ferramentas TikTok do Composio via Rube MCP.

Pré-requisitos

  • Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
  • Conexão TikTok ativa via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas tiktok
  • Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e ele funciona.

  1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
  2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas tiktok
  3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir o OAuth do TikTok
  4. Confirme que o status da conexão mostra ATIVO antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Fazer Upload e Publicar um Vídeo

Quando usar: O usuário quer fazer upload de um vídeo e publicá-lo no TikTok

Sequência de ferramentas:

  1. TIKTOK_UPLOAD_VIDEO ou TIKTOK_UPLOAD_VIDEOS - Fazer upload de arquivo(s) de vídeo [Obrigatório]
  2. TIKTOK_FETCH_PUBLISH_STATUS - Verificar status do upload/processamento [Obrigatório]
  3. TIKTOK_PUBLISH_VIDEO - Publicar o vídeo enviado [Obrigatório]

Parâmetros principais para upload:

  • video: Objeto de arquivo de vídeo com s3key, mimetype, name
  • title: Título/legenda do vídeo

Parâmetros principais para publicação:

  • publish_id: ID retornado da etapa de upload
  • title: Texto da legenda do vídeo
  • privacy_level: 'PUBLIC_TO_EVERYONE', 'MUTUAL_FOLLOW_FRIENDS', 'FOLLOWER_OF_CREATOR', 'SELF_ONLY'
  • disable_duet: Desativar recurso de dueto
  • disable_stitch: Desativar recurso de costura
  • disable_comment: Desativar comentários

Armadilhas:

  • Upload e publicação de vídeo são DUAS etapas separadas; primeiro faça o upload, depois publique
  • Após o upload, consulte FETCH_PUBLISH_STATUS até que o processamento seja concluído antes de publicar
  • O vídeo deve atender aos requisitos do TikTok: formato MP4/WebM, máximo 10 minutos, máximo 4 GB
  • A legenda/título tem limites de caracteres; verifique as diretrizes atuais do TikTok
  • As strings de nível de privacidade diferenciam maiúsculas de minúsculas e devem corresponder exatamente
  • O processamento pode levar de 30 a 120 segundos, dependendo do tamanho do vídeo

2. Postar uma Foto

Quando usar: O usuário quer postar uma foto no TikTok

Sequência de ferramentas:

  1. TIKTOK_POST_PHOTO - Fazer upload e postar uma foto [Obrigatório]
  2. TIKTOK_FETCH_PUBLISH_STATUS - Verificar status do processamento [Opcional]

Parâmetros principais:

  • photo: Objeto de arquivo de foto com s3key, mimetype, name
  • title: Texto da legenda da foto
  • privacy_level: Configuração de privacidade para a postagem

Armadilhas:

  • Postagens de fotos são um recurso mais novo do TikTok; a disponibilidade pode variar por tipo de conta
  • Formatos suportados: JPEG, PNG, WebP
  • Limites de tamanho e dimensão da imagem se aplicam; verifique as diretrizes atuais do TikTok

3. Listar e Gerenciar Vídeos

Quando usar: O usuário quer visualizar seus vídeos publicados

Sequência de ferramentas:

  1. TIKTOK_LIST_VIDEOS - Listar os vídeos publicados do usuário [Obrigatório]

Parâmetros principais:

  • max_count: Número de vídeos a retornar por página
  • cursor: Cursor de paginação para a próxima página

Armadilhas:

  • Retorna apenas os vídeos do próprio usuário autenticado
  • A resposta inclui metadados do vídeo: id, título, hora de criação, share_url, duração, etc.
  • A paginação usa abordagem baseada em cursor; verifique has_more e cursor na resposta
  • Vídeos publicados recentemente podem não aparecer imediatamente na lista

4. Visualizar Perfil e Estatísticas do Usuário

Quando usar: O usuário quer verificar informações do perfil TikTok ou estatísticas da conta

Sequência de ferramentas:

  1. TIKTOK_GET_USER_PROFILE - Obter informações completas do perfil [Obrigatório]
  2. TIKTOK_GET_USER_STATS - Obter estatísticas da conta [Opcional]
  3. TIKTOK_GET_USER_BASIC_INFO - Obter informações básicas do usuário [Alternativa]

Parâmetros principais: (sem parâmetros obrigatórios; retorna dados do usuário autenticado)

Armadilhas:

  • Os dados do perfil são apenas para o usuário autenticado; não é possível visualizar perfis de outros usuários
  • As estatísticas incluem contagem de seguidores, contagem de seguindo, contagem de vídeos, curtidas recebidas
  • GET_USER_PROFILE retorna mais detalhes que GET_USER_BASIC_INFO
  • As estatísticas podem ter pequenos atrasos; não são em tempo real

5. Verificar Status de Publicação

Quando usar: O usuário quer verificar o status de uma operação de upload ou publicação de conteúdo

Sequência de ferramentas:

  1. TIKTOK_FETCH_PUBLISH_STATUS - Consultar atualizações de status [Obrigatório]

Parâmetros principais:

  • publish_id: O ID de publicação de uma operação anterior de upload/publicação

Armadilhas:

  • Os valores de status incluem estados de processamento, sucesso e falha
  • Consulte em intervalos razoáveis (5 a 10 segundos) para evitar limites de taxa
  • Publicações com falha incluem detalhes do erro na resposta
  • A moderação de conteúdo pode causar atrasos ou rejeições após o processamento

Padrões Comuns

Fluxo de Publicação de Vídeo

1. Upload de vídeo via TIKTOK_UPLOAD_VIDEO -> obter publish_id
2. Consultar TIKTOK_FETCH_PUBLISH_STATUS com publish_id até concluir
3. Se o status estiver pronto, chamar TIKTOK_PUBLISH_VIDEO com as configurações finais
4. Opcionalmente, consultar o status novamente para confirmar a publicação

Paginação

  • Use cursor da resposta anterior para a próxima página
  • Verifique o booleano has_more para determinar se existem mais resultados
  • max_count controla o tamanho da página

Armadilhas Conhecidas

Requisitos de Conteúdo:

  • Vídeos: MP4/WebM, máximo 4 GB, máximo 10 minutos
  • Fotos: JPEG/PNG/WebP
  • Legendas: Limites de caracteres variam por região
  • O conteúdo deve estar em conformidade com as diretrizes da comunidade TikTok

Autenticação:

  • Tokens OAuth têm escopos; certifique-se de que video.upload e video.publish estão autorizados
  • Tokens expiram; reautentique se as operações falharem com 401

Limites de Taxa:

  • A API do TikTok possui limites de taxa rigorosos por aplicativo
  • Implemente backoff exponencial em respostas 429
  • Operações de upload têm limites diários

Análise de Resposta:

  • Os dados de resposta podem estar aninhados em data ou data.data
  • Analise defensivamente com padrões de fallback
  • IDs de publicação são strings; use exatamente como retornados

Referência Rápida

TarefaSlug da FerramentaParâmetros Principais
Upload de vídeoTIKTOK_UPLOAD_VIDEOvideo, title
Upload de múltiplos vídeosTIKTOK_UPLOAD_VIDEOSvideos
Publicar vídeoTIKTOK_PUBLISH_VIDEOpublish_id, title, privacy_level
Postar fotoTIKTOK_POST_PHOTOphoto, title, privacy_level
Listar vídeosTIKTOK_LIST_VIDEOSmax_count, cursor
Obter perfilTIKTOK_GET_USER_PROFILE(nenhum)
Obter estatísticas do usuárioTIKTOK_GET_USER_STATS(nenhum)
Obter informações básicasTIKTOK_GET_USER_BASIC_INFO(nenhum)
Verificar status de publicaçãoTIKTOK_FETCH_PUBLISH_STATUSpublish_id

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas