通过 Rube MCP 实现 TikTok 自动化
通过 Composio 的 TikTok 工具包(经由 Rube MCP)自动执行 TikTok 内容创建和资料操作。
前提条件
- 必须连接 Rube MCP(
RUBE_SEARCH_TOOLS可用) - 通过
RUBE_MANAGE_CONNECTIONS激活 TikTok 连接,并指定工具包tiktok - 务必先调用
RUBE_SEARCH_TOOLS获取最新的工具架构
设置
获取 Rube MCP:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。
- 通过确认
RUBE_SEARCH_TOOLS有响应来验证 Rube MCP 是否可用 - 使用工具包
tiktok调用RUBE_MANAGE_CONNECTIONS - 如果连接状态不是 ACTIVE,按照返回的认证链接完成 TikTok OAuth
- 运行任何工作流前,确认连接状态显示为 ACTIVE
核心工作流
1. 上传并发布视频
何时使用:用户想要上传视频并发布到 TikTok
工具顺序:
TIKTOK_UPLOAD_VIDEO或TIKTOK_UPLOAD_VIDEOS- 上传视频文件 [必需]TIKTOK_FETCH_PUBLISH_STATUS- 检查上传/处理状态 [必需]TIKTOK_PUBLISH_VIDEO- 发布已上传的视频 [必需]
上传的关键参数:
video:视频文件对象,包含s3key、mimetype、nametitle:视频标题/说明
发布的关键参数:
publish_id:上传步骤返回的 IDtitle:视频说明文字privacy_level:'PUBLIC_TO_EVERYONE'、'MUTUAL_FOLLOW_FRIENDS'、'FOLLOWER_OF_CREATOR'、'SELF_ONLY'disable_duet:禁用合拍功能disable_stitch:禁用剪接功能disable_comment:禁用评论功能
常见陷阱:
- 视频上传和发布是两个独立的步骤;先上传,再发布
- 上传后,轮询
FETCH_PUBLISH_STATUS直到处理完成,然后再发布 - 视频必须符合 TikTok 要求:MP4/WebM 格式,最长 10 分钟,最大 4GB
- 说明/标题有字符限制;请查看当前的 TikTok 指南
- 隐私级别字符串区分大小写,必须完全匹配
- 根据视频大小,处理可能需要 30-120 秒
2. 发布照片
何时使用:用户想要向 TikTok 发布照片
工具顺序:
TIKTOK_POST_PHOTO- 上传并发布照片 [必需]TIKTOK_FETCH_PUBLISH_STATUS- 检查处理状态 [可选]
关键参数:
photo:照片文件对象,包含s3key、mimetype、nametitle:照片说明文字privacy_level:帖子的隐私设置
常见陷阱:
- 照片发布是较新的 TikTok 功能;可用性可能因账户类型而异
- 支持的格式:JPEG、PNG、WebP
- 存在图片大小和尺寸限制;请查看当前的 TikTok 指南
3. 列出并管理视频
何时使用:用户想要查看已发布的视频
工具顺序:
TIKTOK_LIST_VIDEOS- 列出用户已发布的视频 [必需]
关键参数:
max_count:每页返回的视频数量cursor:用于下一页的游标
常见陷阱:
- 仅返回已认证用户自己的视频
- 响应包含视频元数据:
id、title、create_time、share_url、duration等 - 分页采用游标方式;检查响应中的
has_more和cursor - 刚发布的视频可能不会立即出现在列表中
4. 查看用户资料和统计信息
何时使用:用户想要检查自己的 TikTok 资料信息或账户统计
工具顺序:
TIKTOK_GET_USER_PROFILE- 获取完整资料信息 [必需]TIKTOK_GET_USER_STATS- 获取账户统计信息 [可选]TIKTOK_GET_USER_BASIC_INFO- 获取基本用户信息 [备选]
关键参数:(无必需参数;返回已认证用户的数据)
常见陷阱:
- 资料数据仅针对已认证用户;无法查看其他用户的资料
- 统计信息包括粉丝数、关注数、视频数、收到的点赞数
GET_USER_PROFILE返回的信息比GET_USER_BASIC_INFO更详细- 统计数据可能有轻微延迟;并非实时
5. 检查发布状态
何时使用:用户想要检查内容上传或发布操作的状态
工具顺序:
TIKTOK_FETCH_PUBLISH_STATUS- 轮询状态更新 [必需]
关键参数:
publish_id:来自先前上传/发布操作的发布 ID
常见陷阱:
- 状态值包括处理中、成功和失败状态
- 以合理间隔(5-10 秒)轮询,避免触发速率限制
- 失败的发布会在响应中包含错误详情
- 内容审核可能导致处理后的延迟或拒绝
常见模式
视频发布流程
1. 通过 TIKTOK_UPLOAD_VIDEO 上传视频 -> 获取 publish_id
2. 使用 publish_id 轮询 TIKTOK_FETCH_PUBLISH_STATUS 直到完成
3. 如果状态为就绪,使用最终设置调用 TIKTOK_PUBLISH_VIDEO
4. 可选择再次轮询状态以确认发布成功
分页
- 使用前一次响应中的
cursor获取下一页 - 检查
has_more布尔值以确定是否还有更多结果 max_count控制每页大小
已知陷阱
内容要求:
- 视频:MP4/WebM,最大 4GB,最长 10 分钟
- 照片:JPEG/PNG/WebP
- 说明:字符限制因地区而异
- 内容必须遵守 TikTok 社区指南
身份验证:
- OAuth 令牌有作用域;确保
video.upload和video.publish已授权 - 令牌会过期;如果操作因 401 错误失败,请重新进行身份验证
速率限制:
- TikTok API 对每个应用有严格的速率限制
- 对 429 响应实现指数退避
- 上传操作有每日限制
响应解析:
- 响应数据可能嵌套在
data或data.data下 - 使用带回退模式的防御性解析
- 发布 ID 是字符串;请完全按照返回的原样使用
快速参考
| 任务 | 工具标识 | 关键参数 |
|---|---|---|
| 上传视频 | TIKTOK_UPLOAD_VIDEO | video, title |
| 上传多个视频 | TIKTOK_UPLOAD_VIDEOS | videos |
| 发布视频 | TIKTOK_PUBLISH_VIDEO | publish_id, title, privacy_level |
| 发布照片 | TIKTOK_POST_PHOTO | photo, title, privacy_level |
| 列出视频 | TIKTOK_LIST_VIDEOS | max_count, cursor |
| 获取资料 | TIKTOK_GET_USER_PROFILE | (无) |
| 获取用户统计 | TIKTOK_GET_USER_STATS | (无) |
| 获取基本信息 | TIKTOK_GET_USER_BASIC_INFO | (无) |
| 检查发布状态 | TIKTOK_FETCH_PUBLISH_STATUS | publish_id |
何时使用
此技能适用于执行概述中描述的工作流或操作。
限制
- 仅当任务明确符合上述范围时才使用此技能。
- 请勿将输出视为特定环境验证、测试或专家审查的替代方案。
- 如果缺少必需的输入、权限、安全边界或成功标准,请停止并请求澄清。