tiktok-automation

通过 Rube MCP 实现 TikTok 自动化

通过 Rube MCP 使用 Composio 的 TikTok 工具包，自动化 TikTok 内容创作和账号运营。

前置条件

• 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）
• 已通过 RUBE_MANAGE_CONNECTIONS 建立有效的 TikTok 连接，工具包为 tiktok
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务。无需 API 密钥 — 只需添加该端点即可使用。

1. 通过确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用
2. 调用 RUBE_MANAGE_CONNECTIONS，工具包为 tiktok
3. 如果连接不是 ACTIVE，请按照返回的授权链接完成 TikTok OAuth
4. 在运行任何工作流之前，确认连接状态显示为 ACTIVE

核心工作流

1. 上传并发布视频

使用场景：用户想要上传视频并发布到 TikTok

工具调用顺序：

1. TIKTOK_UPLOAD_VIDEO 或 TIKTOK_UPLOAD_VIDEOS - 上传视频文件 [必需]
2. TIKTOK_FETCH_PUBLISH_STATUS - 检查上传/处理状态 [必需]
3. 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 指南
• 隐私级别字符串区分大小写，必须完全匹配
• 处理可能需要 30-120 秒，具体取决于视频大小

2. 发布照片

使用场景：用户想要发布照片到 TikTok

工具调用顺序：

1. TIKTOK_POST_PHOTO - 上传并发布照片 [必需]
2. TIKTOK_FETCH_PUBLISH_STATUS - 检查处理状态 [可选]

关键参数：

• photo：照片文件对象，包含 s3key、mimetype、name
• title：照片文案文本
• privacy_level：帖子的隐私设置

注意事项：

• 照片帖子是较新的 TikTok 功能；可用性可能因账号类型而异
• 支持的格式：JPEG、PNG、WebP
• 图片大小和尺寸限制适用；请查看当前 TikTok 指南

3. 列出和管理视频

使用场景：用户想要查看自己已发布的视频

工具调用顺序：

1. TIKTOK_LIST_VIDEOS - 列出用户已发布的视频 [必需]

关键参数：

• max_count：每页返回的视频数量
• cursor：下一页的分页游标

注意事项：

• 仅返回已认证用户自己的视频
• 响应包含视频元数据：id、title、create_time、share_url、duration 等
• 分页使用基于游标的方式；检查响应中的 has_more 和 cursor
• 最近发布的视频可能不会立即出现在列表中

4. 查看用户个人资料和统计数据

适用场景：用户想查看自己的 TikTok 个人资料信息或账号统计数据

工具调用顺序：

1. TIKTOK_GET_USER_PROFILE - 获取完整的个人资料信息［必需］
2. TIKTOK_GET_USER_STATS - 获取账号统计数据［可选］
3. TIKTOK_GET_USER_BASIC_INFO - 获取基本用户信息［替代方案］

关键参数：（无必需参数；返回已通过身份验证的用户的数据）

注意事项：

• 个人资料数据仅适用于已通过身份验证的用户；无法查看其他用户的个人资料
• 统计数据包括粉丝数、关注数、视频数和获赞数
• GET_USER_PROFILE 返回的信息比 GET_USER_BASIC_INFO 更详细
• 统计数据可能略有延迟，并非实时数据

5. 检查发布状态

适用场景：用户想检查内容上传或发布操作的状态

工具调用顺序：

1. TIKTOK_FETCH_PUBLISH_STATUS - 轮询状态更新［必需］

关键参数：

• publish_id：之前的上传或发布操作返回的发布 ID

注意事项：

• 状态值包括处理中、成功和失败
• 以合理的间隔（5-10 秒）轮询，以避免触发速率限制
• 发布失败时，响应中会包含错误详情
• 内容审核可能会导致处理完成后的延迟或拒绝

常见模式

视频发布流程

1. Upload video via TIKTOK_UPLOAD_VIDEO -> get publish_id
2. Poll TIKTOK_FETCH_PUBLISH_STATUS with publish_id until complete
3. If status is ready, call TIKTOK_PUBLISH_VIDEO with final settings
4. Optionally poll status again to confirm publication

分页

• 使用上一页响应中的 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