Automatización de TikTok vía Rube MCP
Automatiza la creación de contenido y operaciones de perfil en TikTok a través del toolkit de TikTok de Composio vía Rube MCP.
Prerrequisitos
- Rube MCP debe estar conectado (
RUBE_SEARCH_TOOLSdisponible) - Conexión activa de TikTok vía
RUBE_MANAGE_CONNECTIONScon el toolkittiktok - Siempre llama a
RUBE_SEARCH_TOOLSprimero para obtener los esquemas actuales de las herramientas
Configuración
Obtener Rube MCP: Añade https://rube.app/mcp como servidor MCP en la configuración de tu cliente. No se necesitan claves API — solo añade el endpoint y funciona.
- Verifica que Rube MCP esté disponible confirmando que
RUBE_SEARCH_TOOLSresponde - Llama a
RUBE_MANAGE_CONNECTIONScon el toolkittiktok - 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 usarlo: 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 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 foto del video
Parámetros clave para publicar:
publish_id: ID devuelto del paso de subidatitle: Texto del pie de foto del 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 stitchdisable_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 termine antes de publicar
- El video debe cumplir los requisitos de TikTok: formato MP4/WebM, máximo 10 minutos, máximo 4GB
- El pie de foto/título tiene límites de caracteres; consulta las directrices actuales de TikTok
- Los niveles de privacidad distinguen mayúsculas y minúsculas y deben coincidir exactamente
- El procesamiento puede tardar entre 30 y 120 segundos dependiendo del tamaño del video
2. Publicar una Foto
Cuándo usarlo: 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 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 funcionalidad más reciente de TikTok; la disponibilidad puede variar según el tipo de cuenta
- Formatos compatibles: JPEG, PNG, WebP
- Se aplican límites de tamaño y dimensiones de imagen; consulta las directrices actuales de TikTok
3. Listar y Gestionar Videos
Cuándo usarlo: 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 usuario autenticado
- La respuesta incluye metadatos del video: id, título, create_time, share_url, 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 y Estadísticas del Usuario
Cuándo usarlo: El usuario quiere consultar su información de perfil de TikTok o estadísticas de 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 del usuario autenticado)
Errores comunes:
- Los datos del perfil son solo del usuario autenticado; no se pueden ver perfiles de otros usuarios
- Las estadísticas incluyen recuento de seguidores, recuento de seguidos, recuento de videos, likes recibidos
GET_USER_PROFILEdevuelve más detalles queGET_USER_BASIC_INFO- Las estadísticas pueden tener ligeros retrasos; no son en tiempo real
5. Verificar Estado de Publicación
Cuándo usarlo: 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 velocidad
- 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 completar
3. Si el estado es ready, 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 Conocidos
Requisitos de Contenido:
- Videos: MP4/WebM, máximo 4GB, máximo 10 minutos
- Fotos: JPEG/PNG/WebP
- Pies de foto: Los límites de caracteres varían según la región
- El contenido debe cumplir con las directrices 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 caducan; reautentica si las operaciones fallan con 401
Límites de Velocidad:
- La API de TikTok tiene límites de velocidad 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 IDs 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 |