tiktok-automation

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 キーは不要です — エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを検証します
2. RUBE_MANAGE_CONNECTIONS をツールキット tiktok で呼び出します
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: ページごとに返す動画の数
• 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. 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