Rube MCP による TikTok 自動化
Composio の TikTok ツールキット(Rube MCP 経由)を使用して、TikTok のコンテンツ作成とプロフィール操作を自動化します。
前提条件
- Rube MCP が接続されていること(
RUBE_SEARCH_TOOLSが利用可能) RUBE_MANAGE_CONNECTIONSでtiktokツールキットがアクティブに接続されていること- 常に最初に
RUBE_SEARCH_TOOLSを呼び出して最新のツールスキーマを取得すること
セットアップ
Rube MCP を入手する: クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認し、Rube MCP が利用可能かを確認しますRUBE_MANAGE_CONNECTIONSをツールキットtiktokで呼び出します- 接続が 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: コメントを無効にする
落とし穴:
- 動画のアップロードと公開は別々の手順です。先にアップロードし、その後公開します
- アップロード後、公開前に
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、タイトル、作成日時、共有 URL、再生時間など)が含まれます
- ページネーションはカーソルベースです。レスポンス内の
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
落とし穴:
- ステータス値には processing、success、failure の状態があります
- レート制限を避けるため、適切な間隔(5 ~ 10 秒)でポーリングします
- 公開失敗時は、レスポンスにエラーの詳細が含まれます
- コンテンツモデレーションにより、処理後の遅延や拒否が発生する場合があります
共通パターン
動画公開フロー
1. TIKTOK_UPLOAD_VIDEO で動画をアップロード -> publish_id を取得
2. TIKTOK_FETCH_PUBLISH_STATUS を publish_id でポーリングし、完了するまで待機
3. ステータスが ready になったら、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 |
使用するケース
このスキルは、概要に記載されたワークフローやアクションを実行するために適用されます。
関連リンク
- ドメイン: [[コミュニケーション & コンテンツ]]
- カテゴリー: [[ソーシャルメディア]]
- ナビゲーション: [[スキル一覧]], [[ホーム]]