Rube MCP による TikTok 自動化
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 が利用可能であることを確認します。- ツールキット
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、nameを含む動画ファイルオブジェクトtitle: 動画のタイトル/キャプション
公開の主要パラメータ:
publish_id: アップロード手順で返された IDtitle: 動画のキャプションテキスト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 に写真を投稿したい場合
ツールシーケンス:
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: 1ページあたりの動画数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. ステータスが準備完了の場合、最終設定で 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 応答に対しては指数バックオフを実装してください。
- アップロード操作には1日あたりの制限があります。
応答の解析:
- 応答データは
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 |
使用タイミング
このスキルは、概要で説明されているワークフローやアクションを実行する際に適用されます。