tiktok-automation

通过 Rube MCP 自动化 TikTok

通过 Rube MCP 使用 Composio 的 TikTok 工具包，自动化 TikTok 内容创建和个人资料操作。

工具包文档：composio.dev/toolkits/tiktok

前提条件

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

设置

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

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 是否可用
2. 使用工具包 tiktok 调用 RUBE_MANAGE_CONNECTIONS
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

---

由 Composio 提供支持