用途
TikTok Automation via Rube MCP 用于通过 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 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包为 tiktok。
- 若连接不是 ACTIVE，按返回的授权链接完成 TikTok OAuth。
- 确认连接状态显示 ACTIVE 后再运行任何工作流。
主要能力与工作流
1. 上传并发布视频
适用场景：用户希望上传视频并发布到 TikTok。
工具顺序：
- TIKTOK_UPLOAD_VIDEO 或 TIKTOK_UPLOAD_VIDEOS — 上传视频文件（必需）
- TIKTOK_FETCH_PUBLISH_STATUS — 检查上传/处理状态（必需）
- TIKTOK_PUBLISH_VIDEO — 发布已上传的视频（必需）
上传关键参数：
- video：视频文件对象，含 s3key、mimetype、name
- title：视频标题/说明文字
发布关键参数：
- publish_id：上传步骤返回的 ID
- title：视频说明文字
- 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 指南。
- privacy_level 字符串区分大小写，必须完全匹配。
- 处理可能耗时 30-120 秒，取决于视频大小。
2. 发布照片
适用场景：用户希望向 TikTok 发布照片。
工具顺序：
- TIKTOK_POST_PHOTO — 上传并发布照片（必需）
- TIKTOK_FETCH_PUBLISH_STATUS — 检查处理状态（可选）
关键参数：
- photo：照片文件对象，含 s3key、mimetype、name
- title：照片说明文字
- 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 秒）轮询，避免触发速率限制。
- 发布失败会在响应中包含错误详情。
- 内容审核可能导致处理后的延迟或拒绝。
常见模式
视频发布流程：
- 通过 TIKTOK_UPLOAD_VIDEO 上传视频 -> 获取 publish_id
- 使用 publish_id 轮询 TIKTOK_FETCH_PUBLISH_STATUS 直到完成
- 若状态就绪，使用最终设置调用 TIKTOK_PUBLISH_VIDEO
- 可选再次轮询状态以确认发布
分页：
- 使用上一响应中的 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 下
- 使用回退模式进行防御性解析
- publish_id 是字符串；请完全按返回内容使用
快速参考
| 任务 | 工具 Slug | 关键参数 |
|---|---|---|
| 上传视频 | 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 |
适用场景
该技能适用于执行概述中描述的工作流或操作。
限制
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 若缺少必需输入、权限、安全边界或成功标准，请停止并请求澄清。