透過 Rube MCP 進行 TikTok 自動化
選擇性閱讀規則
從以下開始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然後僅載入符合使用者實際任務需求的繼承文件、腳本、資產或範例。
透過 Rube MCP 使用 Composio 的 TikTok 工具組,自動化 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:停用 Duet 功能disable_stitch:停用 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. 如果狀態為 ready,使用最終設定呼叫 TIKTOK_PUBLISH_VIDEO
4. 可選地再次輪詢狀態以確認發布
分頁
- 使用前一次回應中的
cursor取得下一頁 - 檢查
has_more布林值以判斷是否還有更多結果 max_count控制頁面大小
已知陷阱
內容要求:
- 影片:MP4/WebM,最大 4GB,最長 10 分鐘
- 照片:JPEG/PNG/WebP
- 說明文字:字元限制因地區而異
- 內容必須符合 TikTok 社群規範
驗證:
- OAuth Token 具有範圍;請確保已授權 video.upload 和 video.publish
- Token 會過期;如果操作失敗並傳回 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 |
使用時機
此技能適用於執行概覽中描述的工作流程或動作。
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並尋求澄清。