Rube MCP 経由の TikTok 自動化
選択的読み取りルール
以下のファイルから読み始めてください:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
その後、ユーザーの実際のタスクに一致する継承されたドキュメント、スクリプト、アセット、または例のみを読み込んでください。
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 キーは不要です。エンドポイントを追加するだけで動作します。
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
落とし穴:
- ステータス値には、processing(処理中)、success(成功)、failure(失敗)の状態が含まれます
- レート制限を避けるために、適切な間隔(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トークンにはスコープがあります。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 |
使用タイミング
このスキルは、概要に記載されたワークフローまたはアクションを実行する場合に適用されます。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、立ち止まって明確化を求めてください。