tiktok-automation

Rube MCP を使った TikTok の自動化

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

ツールキットのドキュメント：composio.dev/toolkits/tiktok

前提条件

• Rube MCP に接続している必要があります（RUBE_SEARCH_TOOLS が利用可能であること）
• tiktok ツールキットを指定した RUBE_MANAGE_CONNECTIONS で、TikTok への接続が有効になっていること
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP を入手する：クライアント設定で https://rube.app/mcp を 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：コメントを無効にします

注意事項：

• 動画のアップロードと公開は別々の手順です。まずアップロードし、その後に公開してください
• アップロード後、処理が完了してから公開するために、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、タイトル、作成時刻、共有 URL、長さなどの動画メタデータが含まれます
• ページネーションにはカーソル方式を使用します。レスポンスの 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. Upload video via TIKTOK_UPLOAD_VIDEO -> get publish_id
2. Poll TIKTOK_FETCH_PUBLISH_STATUS with publish_id until complete
3. If status is ready, call TIKTOK_PUBLISH_VIDEO with final settings
4. Optionally poll status again to confirm publication

ページネーション

• 次のページを取得するには、前回のレスポンスに含まれる 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

---

Composio によって提供