Rube MCP による TikTok 自動化

Composio の TikTok ツールキットを Rube MCP 経由で TikTok コンテンツ作成とプロフィール操作を自動化します。

前提条件

• Rube MCP が接続されていること (RUBE_SEARCH_TOOLS が利用可能)
• RUBE_MANAGE_CONNECTIONS を通じた TikTok 接続（ツールキット tiktok）がアクティブ
• 常に RUBE_SEARCH_TOOLS を最初に呼び出して現在のツールスキーマを取得

セットアップ

Rube MCP の取得: クライアント設定で MCP サーバーとして https://rube.app/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: コメントを無効化

注意点:

• 動画のアップロードと公開は 2 つの別ステップです。まずアップロードしてから公開してください
• アップロード後、公開前に 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: 1 ページあたりに返す動画数
• 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. 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 は文字列です。返された通りに正確に使用してください

クイックリファレンス

タスク	ツール 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

使用時期

このスキルは概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、上記で説明されているスコープと明確に一致するタスクでのみ使用してください。
• 出力を環境固有の検証、テスト、またはエキスパートレビューの代替品として扱わないでください。
• 必要な入力、権限、安全上の境界線、または成功基準が不明な場合は、停止して説明を求めてください。