Automação do TikTok via Rube MCP
Automatize a criação de conteúdo e operações de perfil do TikTok através do toolkit TikTok da Composio via Rube MCP.
Pré-requisitos
- O Rube MCP deve estar conectado (
RUBE_SEARCH_TOOLSdisponível) - Conexão ativa com o TikTok via
RUBE_MANAGE_CONNECTIONScom o toolkittiktok - Sempre chame
RUBE_SEARCH_TOOLSprimeiro para obter os esquemas de ferramentas atuais
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.
- Verifique se o Rube MCP está disponível confirmando que
RUBE_SEARCH_TOOLSresponde - Chame
RUBE_MANAGE_CONNECTIONScom o toolkittiktok - Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir o OAuth do TikTok
- 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 deseja fazer upload de um vídeo e publicá-lo no TikTok
Sequência de ferramentas:
TIKTOK_UPLOAD_VIDEOouTIKTOK_UPLOAD_VIDEOS- Fazer upload do(s) arquivo(s) de vídeo [Obrigatório]TIKTOK_FETCH_PUBLISH_STATUS- Verificar o status do upload/processamento [Obrigatório]TIKTOK_PUBLISH_VIDEO- Publicar o vídeo enviado [Obrigatório]
Parâmetros principais para upload:
video: Objeto de arquivo de vídeo coms3key,mimetype,nametitle: Título/legenda do vídeo
Parâmetros principais para publicação:
publish_id: ID retornado da etapa de uploadtitle: Texto da legenda do vídeoprivacy_level: 'PUBLIC_TO_EVERYONE', 'MUTUAL_FOLLOW_FRIENDS', 'FOLLOWER_OF_CREATOR', 'SELF_ONLY'disable_duet: Desativar recurso de duetodisable_stitch: Desativar recurso de stitchdisable_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_STATUSaté que o processamento esteja completo antes de publicar - O vídeo deve atender aos requisitos do TikTok: formato MP4/WebM, no máximo 10 minutos, no máximo 4GB
- 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 deseja postar uma foto no TikTok
Sequência de ferramentas:
TIKTOK_POST_PHOTO- Fazer upload e postar uma foto [Obrigatório]TIKTOK_FETCH_PUBLISH_STATUS- Verificar o status do processamento [Opcional]
Parâmetros principais:
photo: Objeto de arquivo de foto coms3key,mimetype,nametitle: Texto da legenda da fotoprivacy_level: Configuração de privacidade para a postagem
Armadilhas:
- Postagens de fotos são um recurso mais recente do TikTok; a disponibilidade pode variar por tipo de conta
- Formatos suportados: JPEG, PNG, WebP
- Limites de tamanho e dimensão de imagem se aplicam; verifique as diretrizes atuais do TikTok
3. Listar e Gerenciar Vídeos
Quando usar: O usuário deseja visualizar seus vídeos publicados
Sequência de ferramentas:
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áginacursor: 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, create_time, share_url, duração, etc.
- A paginação usa abordagem baseada em cursor; verifique
has_moreecursorna 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 deseja verificar suas informações de perfil ou estatísticas da conta no TikTok
Sequência de ferramentas:
TIKTOK_GET_USER_PROFILE- Obter informações completas do perfil [Obrigatório]TIKTOK_GET_USER_STATS- Obter estatísticas da conta [Opcional]TIKTOK_GET_USER_BASIC_INFO- Obter informações básicas do usuário [Alternativa]
Parâmetros principais: (nenhum parâmetro obrigatório; 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
- Estatísticas incluem contagem de seguidores, contagem de seguindo, contagem de vídeos, curtidas recebidas
GET_USER_PROFILEretorna mais detalhes do queGET_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 deseja verificar o status de uma operação de upload ou publicação de conteúdo
Sequência de ferramentas:
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. Fazer upload do vídeo via TIKTOK_UPLOAD_VIDEO -> obter publish_id
2. Consultar TIKTOK_FETCH_PUBLISH_STATUS com o publish_id até completar
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 o
cursorda resposta anterior para a próxima página - Verifique o booleano
has_morepara determinar se existem mais resultados max_countcontrola o tamanho da página
Armadilhas Conhecidas
Requisitos de Conteúdo:
- Vídeos: MP4/WebM, máximo 4GB, 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 do TikTok
Autenticação:
- Os tokens OAuth têm escopos; certifique-se de que
video.uploadevideo.publishestejam autorizados - Os 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 Respostas:
- Os dados da resposta podem estar aninhados sob
dataoudata.data - Analise defensivamente com padrões de fallback
- IDs de publicação são strings; use exatamente como retornados
Referência Rápida
| Tarefa | Slug da Ferramenta | Parâmetros Principais |
|---|---|---|
| Fazer upload de vídeo | TIKTOK_UPLOAD_VIDEO | video, title |
| Fazer upload de vários vídeos | TIKTOK_UPLOAD_VIDEOS | videos |
| Publicar vídeo | TIKTOK_PUBLISH_VIDEO | publish_id, title, privacy_level |
| Postar foto | TIKTOK_POST_PHOTO | photo, title, privacy_level |
| Listar vídeos | TIKTOK_LIST_VIDEOS | max_count, cursor |
| Obter perfil | TIKTOK_GET_USER_PROFILE | (nenhum) |
| Obter estatísticas do usuário | TIKTOK_GET_USER_STATS | (nenhum) |
| Obter informações básicas | TIKTOK_GET_USER_BASIC_INFO | (nenhum) |
| Verificar status de publicação | TIKTOK_FETCH_PUBLISH_STATUS | publish_id |
Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.
Limitações
- Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
- Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
- Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.