Automatización de TikTok a través de Rube MCP
Automatiza la creación de contenido en TikTok y las operaciones de perfil mediante el kit de herramientas de TikTok de Composio a través de Rube MCP.
Prerrequisitos
- Rube MCP debe estar conectado (RUBE_SEARCH_TOOLS disponible)
- Conexión activa de TikTok a través de
RUBE_MANAGE_CONNECTIONScon el kit de herramientastiktok - Siempre llama a
RUBE_SEARCH_TOOLSprimero para obtener los esquemas actuales de las herramientas
Configuración
Obtén Rube MCP: Agrega https://rube.app/mcp como un servidor MCP en la configuración de tu cliente. No se necesitan claves API — solo agrega el endpoint y funciona.
- Verifica que Rube MCP esté disponible confirmando que
RUBE_SEARCH_TOOLSresponda - Llama a
RUBE_MANAGE_CONNECTIONScon el kit de herramientastiktok - Si la conexión no está ACTIVA, sigue el enlace de autenticación devuelto para completar el OAuth de TikTok
- Confirma que el estado de la conexión muestre ACTIVO antes de ejecutar cualquier flujo de trabajo
Flujos de trabajo principales
1. Subir y publicar un video
Cuándo usar: El usuario quiere subir un video y publicarlo en TikTok
Secuencia de herramientas:
TIKTOK_UPLOAD_VIDEOoTIKTOK_UPLOAD_VIDEOS- Subir archivo(s) de video [Requerido]TIKTOK_FETCH_PUBLISH_STATUS- Verificar el estado de subida/procesamiento [Requerido]TIKTOK_PUBLISH_VIDEO- Publicar el video subido [Requerido]
Parámetros clave para subir:
video: Objeto de archivo de video cons3key,mimetype,nametitle: Título/pie de video
Parámetros clave para publicar:
publish_id: ID devuelto desde el paso de subidatitle: Texto del pie de videoprivacy_level: 'PUBLIC_TO_EVERYONE', 'MUTUAL_FOLLOW_FRIENDS', 'FOLLOWER_OF_CREATOR', 'SELF_ONLY'disable_duet: Deshabilitar función de duetodisable_stitch: Deshabilitar función de fusióndisable_comment: Deshabilitar comentarios
Errores comunes:
- La subida y publicación del video son DOS pasos separados; primero sube, luego publica
- Después de subir, consulta FETCH_PUBLISH_STATUS hasta que el procesamiento esté completo antes de publicar
- El video debe cumplir con los requisitos de TikTok: formato MP4/WebM, máximo 10 minutos, máximo 4GB
- El pie/título tiene límites de caracteres; consulta las pautas actuales de TikTok
- Las cadenas de nivel de privacidad distinguen mayúsculas y minúsculas y deben coincidir exactamente
- El procesamiento puede tomar de 30 a 120 segundos dependiendo del tamaño del video
2. Publicar una foto
Cuándo usar: El usuario quiere publicar una foto en TikTok
Secuencia de herramientas:
TIKTOK_POST_PHOTO- Subir y publicar una foto [Requerido]TIKTOK_FETCH_PUBLISH_STATUS- Verificar el estado de procesamiento [Opcional]
Parámetros clave:
photo: Objeto de archivo de foto cons3key,mimetype,nametitle: Texto del pie de fotoprivacy_level: Configuración de privacidad para la publicación
Errores comunes:
- Las publicaciones de fotos son una característica más reciente de TikTok; la disponibilidad puede variar según el tipo de cuenta
- Formatos soportados: JPEG, PNG, WebP
- Se aplican límites de tamaño y dimensiones de imagen; consulta las pautas actuales de TikTok
3. Listar y gestionar videos
Cuándo usar: El usuario quiere ver sus videos publicados
Secuencia de herramientas:
TIKTOK_LIST_VIDEOS- Listar los videos publicados del usuario [Requerido]
Parámetros clave:
max_count: Número de videos a devolver por páginacursor: Cursor de paginación para la siguiente página
Errores comunes:
- Solo devuelve los videos del propio usuario autenticado
- La respuesta incluye metadatos del video: id, título, tiempo de creación, URL de compartir, duración, etc.
- La paginación usa un enfoque basado en cursor; verifica
has_moreycursoren la respuesta - Los videos publicados recientemente pueden no aparecer inmediatamente en la lista
4. Ver perfil de usuario y estadísticas
Cuándo usar: El usuario quiere consultar la información de su perfil de TikTok o estadísticas de la cuenta
Secuencia de herramientas:
TIKTOK_GET_USER_PROFILE- Obtener información completa del perfil [Requerido]TIKTOK_GET_USER_STATS- Obtener estadísticas de la cuenta [Opcional]TIKTOK_GET_USER_BASIC_INFO- Obtener información básica del usuario [Alternativa]
Parámetros clave: (sin parámetros requeridos; devuelve datos para el usuario autenticado)
Errores comunes:
- Los datos del perfil son solo para el usuario autenticado; no se pueden ver perfiles de otros usuarios
- Las estadísticas incluyen conteo de seguidores, conteo de seguidos, conteo de videos, me gusta recibidos
- GET_USER_PROFILE devuelve más detalles que GET_USER_BASIC_INFO
- Las estadísticas pueden tener ligeros retrasos; no son en tiempo real
5. Verificar estado de publicación
Cuándo usar: El usuario quiere verificar el estado de una operación de subida o publicación de contenido
Secuencia de herramientas:
TIKTOK_FETCH_PUBLISH_STATUS- Consultar actualizaciones de estado [Requerido]
Parámetros clave:
publish_id: El ID de publicación de una operación anterior de subida/publicación
Errores comunes:
- Los valores de estado incluyen estados de procesamiento, éxito y fallo
- Consulta a intervalos razonables (5-10 segundos) para evitar límites de tasa
- Las publicaciones fallidas incluyen detalles del error en la respuesta
- La moderación de contenido puede causar retrasos o rechazos después del procesamiento
Patrones comunes
Flujo de publicación de video
1. Subir video mediante TIKTOK_UPLOAD_VIDEO -> obtener publish_id
2. Consultar TIKTOK_FETCH_PUBLISH_STATUS con publish_id hasta que esté completo
3. Si el estado es listo, llamar a TIKTOK_PUBLISH_VIDEO con la configuración final
4. Opcionalmente consultar el estado nuevamente para confirmar la publicación
Paginación
- Usa
cursorde la respuesta anterior para la siguiente página - Verifica el booleano
has_morepara determinar si existen más resultados max_countcontrola el tamaño de la página
Errores comunes conocidos
Requisitos de contenido:
- Videos: MP4/WebM, máximo 4GB, máximo 10 minutos
- Fotos: JPEG/PNG/WebP
- Pies de foto: Límites de caracteres varían según la región
- El contenido debe cumplir con las pautas de la comunidad de TikTok
Autenticación:
- Los tokens OAuth tienen alcances; asegúrate de que video.upload y video.publish estén autorizados
- Los tokens expiran; vuelve a autenticarte si las operaciones fallan con 401
Límites de tasa:
- La API de TikTok tiene límites de tasa estrictos por aplicación
- Implementa retroceso exponencial en respuestas 429
- Las operaciones de subida tienen límites diarios
Análisis de respuestas:
- Los datos de respuesta pueden estar anidados bajo
dataodata.data - Analiza de forma defensiva con patrones de respaldo
- Los ID de publicación son cadenas; úsalos exactamente como se devuelven
Referencia rápida
| Tarea | Slug de herramienta | Parámetros clave |
|---|---|---|
| Subir video | TIKTOK_UPLOAD_VIDEO | video, title |
| Subir múltiples videos | TIKTOK_UPLOAD_VIDEOS | videos |
| Publicar video | TIKTOK_PUBLISH_VIDEO | publish_id, title, privacy_level |
| Publicar foto | TIKTOK_POST_PHOTO | photo, title, privacy_level |
| Listar videos | TIKTOK_LIST_VIDEOS | max_count, cursor |
| Obtener perfil | TIKTOK_GET_USER_PROFILE | (ninguno) |
| Obtener estadísticas de usuario | TIKTOK_GET_USER_STATS | (ninguno) |
| Obtener información básica | TIKTOK_GET_USER_BASIC_INFO | (ninguno) |
| Verificar estado de publicación | TIKTOK_FETCH_PUBLISH_STATUS | publish_id |
Cuándo usar
Esta habilidad es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la visión general.