dropbox-automation

Rube MCP による Dropbox の自動化

Composio の Dropbox ツールキットを通じて、ファイルのアップロード／ダウンロード、検索、フォルダー管理、共有リンク、バッチ操作、メタデータの取得など、Dropbox の操作を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS でツールキット dropbox を指定し、有効な Dropbox 接続を確立していること
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出すこと

セットアップ

既存の承認済み Rube 接続を使用してください。エンドポイントだけでは Dropbox の認証はできません。依頼された範囲内で、サポートされているセットアップ／認証フローを使用してください。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット dropbox を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクを開き、Dropbox OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

以下の過去のスラッグ／制限／デフォルト値については、現在のスキーマでの確認が必要です。変更、上書き、所有権の譲渡、共有を行う前に、アカウント／ルート名前空間、対象ファイル／バージョン、保存先、承認済みの共有対象を確認してください。既存のリンクは、依頼された共有対象より広範囲に公開されている可能性があります。再利用する前に権限を確認してください。非同期の書き込みや結果が不明な書き込みについては、再試行する前に元のジョブ ID を使って状況を確認してください。

主なワークフロー

1. ファイルとフォルダーを検索する

使用する場面：名前、内容、種類からファイルやフォルダーを探す場合

ツールの呼び出し順：

1. DROPBOX_SEARCH_FILE_OR_FOLDER - クエリ文字列と、任意のパス範囲およびフィルターを指定して検索します［必須］
2. DROPBOX_SEARCH_CONTINUE - カーソルを使用して、追加の検索結果をページングします［has_more が true の場合は必須］
3. DROPBOX_GET_METADATA - 検索結果を検証し、正規パスを取得します［任意］
4. DROPBOX_READ_FILE - ファイルの内容を読み取り、意図したドキュメントであることを確認します［任意］

主なパラメーター：

• query：検索文字列（大文字と小文字を区別せず、空白以外の文字を 1 文字以上含む）
• options.path：検索対象をフォルダーに限定します（例："/Documents"）。ルートを指定する場合は空文字列を使用します
• options.file_categories：種類で絞り込みます（"image"、"document"、"pdf"、"folder" など）
• options.file_extensions：拡張子で絞り込みます（例：["jpg", "png"]）
• options.filename_only：ファイル名のみを対象にする場合は true に設定します（内容は対象外）
• options.max_results：1 ページあたりの検索結果数（デフォルトは 100、最大 1000）

注意点：

• 検索結果がさらにある場合、has_more: true と cursor が返されます。一致する項目を見落とさないよう、必ず続きを取得してください
• 検索と search_continue の全ページを通じた一致件数の上限は 10,000 件です
• DROPBOX_GET_METADATA が返す path_display は、ユーザー入力と大文字／小文字が異なる場合があります。必ず返された正規パスを使用してください
• DROPBOX_READ_FILE のファイル内容は、base64 エンコードされた file_content_bytes として返される場合があります。解析する前にデコードしてください

2. ファイルのアップロードとダウンロード

使用する場面：Dropbox にファイルをアップロードしたい場合、または Dropbox からファイルをダウンロードしたい場合

ツールの手順：

1. DROPBOX_UPLOAD_FILE - 指定したパスにファイルをアップロードします［アップロードに必須］
2. DROPBOX_READ_FILE - Dropbox からファイルをダウンロード／読み込みます［ダウンロードに必須］
3. DROPBOX_DOWNLOAD_ZIP - フォルダー全体を zip ファイルとしてダウンロードします［任意］
4. DROPBOX_SAVE_URL - 公開 URL からファイルを Dropbox に直接保存します［任意］
5. DROPBOX_GET_SHARED_LINK_FILE - 共有リンク URL からファイルをダウンロードします［任意］
6. DROPBOX_EXPORT_FILE - Dropbox Paper など、ダウンロードできないファイルを markdown／HTML にエクスポートします［任意］

主なパラメーター：

• path：Dropbox のパス（"/Documents/report.pdf" のように、/ で始まる必要があります）
• mode：アップロード時の "add"（デフォルト。競合時は失敗）または "overwrite"
• autorename：競合時に失敗する代わりに自動で名前を変更する場合は true
• content：アップロードに使用する s3key、mimetype、name を含む FileUploadable オブジェクト
• url：DROPBOX_SAVE_URL 用の公開 URL
• export_format：Paper ドキュメント用の "markdown"、"html"、または "plain_text"

注意点：

• DROPBOX_SAVE_URL は非同期で、大きなファイルの場合は最大 15 分かかることがあります
• DROPBOX_DOWNLOAD_ZIP では、フォルダーのサイズが 20 GB 未満で、単一ファイルが 4 GB を超えず、エントリ数が 10,000 未満である必要があります
• DROPBOX_READ_FILE のコンテンツは base64 でエンコードされている場合があります。レスポンス形式を確認してください
• DROPBOX_GET_SHARED_LINK_FILE を使用した共有リンクからのダウンロードでは、保護されたリンクの場合に link_password が必要になることがあります

3. ファイルの共有とリンクの管理

使用する場面：共有リンクを作成したい場合、または既存の共有リンクを管理したい場合

ツールの手順：

1. DROPBOX_GET_METADATA - ファイル／フォルダーの存在を確認し、正規のパスを取得します［前提条件］
2. DROPBOX_LIST_SHARED_LINKS - 重複を避けるため、既存の共有リンクを確認します［前提条件］
3. DROPBOX_CREATE_SHARED_LINK - 新しい共有リンクを作成します［必須］
4. DROPBOX_GET_SHARED_LINK_METADATA - 共有リンク URL をメタデータに解決します［任意］
5. DROPBOX_LIST_SHARED_FOLDERS - ユーザーがアクセスできる共有フォルダーをすべて一覧表示します［任意］

主なパラメーター：

• path：リンクを作成するファイルまたはフォルダーのパス
• settings.audience："public"、"team"、または "no_one"
• settings.access："viewer" または "editor"
• settings.expires：ISO 8601 形式の有効期限（例："2026-12-31T23:59:59Z"）
• settings.require_password / settings.link_password：パスワード保護
• settings.allow_download：ダウンロード権限を示すブール値
• direct_only：LIST_SHARED_LINKS で true に設定すると、直接リンクのみを返します（親フォルダーのリンクは返しません）

注意点：

• 対象のパスに共有リンクがすでに存在する場合、DROPBOX_CREATE_SHARED_LINK は 409 Conflict で失敗します。最初に DROPBOX_LIST_SHARED_LINKS で確認してください
• path/not_found エラーを避けるため、リンクを作成する前に必ず DROPBOX_GET_METADATA でパスを検証してください
• 重複を作成する代わりに、DROPBOX_LIST_SHARED_LINKS から既存のリンクを再利用してください
• requested_visibility は非推奨です。新しい実装では audience を使用してください

4. フォルダーを管理する（作成、移動、削除）

使用するタイミング：ファイルやフォルダーの作成、移動、名前変更、削除をユーザーが希望する場合

ツールの順序：

1. DROPBOX_CREATE_FOLDER - 単一のフォルダーを作成します［作成時に必須］
2. DROPBOX_CREATE_FOLDER_BATCH - 複数のフォルダーを一度に作成します［任意］
3. DROPBOX_MOVE_FILE_OR_FOLDER - 単一のファイルまたはフォルダーを移動または名前変更します［移動時に必須］
4. DROPBOX_MOVE_BATCH - 複数の項目を一度に移動します［任意］
5. DROPBOX_DELETE_FILE_OR_FOLDER - 単一のファイルまたはフォルダーを削除します［削除時に必須］
6. DROPBOX_DELETE_BATCH - 複数の項目を一度に削除します［任意］
7. DROPBOX_COPY_FILE_OR_FOLDER - ファイルまたはフォルダーを新しい場所にコピーします［任意］
8. DROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCH - 非同期バッチジョブのステータスを確認します［バッチ操作時に必須］

主なパラメーター：

• path：対象のパス（通常は / で始まります。パスの比較では大文字と小文字が区別されません）
• from_path / to_path：移動／コピー操作の移動元と移動先
• autorename：競合時に自動で名前を変更するには true を指定します
• entries：バッチ移動では {from_path, to_path} の配列、バッチ作成ではパスの配列
• allow_shared_folder：共有フォルダーの移動を許可するには true を指定します
• allow_ownership_transfer：移動によって所有権が変わる場合は true を指定します

注意点：

• Dropbox のパスでは大文字と小文字が区別されず、通常は / で始まります。不透明な ID では大文字と小文字が区別されます
• パスの末尾に / や空白を付けることはできません
• バッチ操作は非同期で実行されることがあります。DROPBOX_CHECK_MOVE_BATCH または DROPBOX_CHECK_FOLDER_BATCH で状態を確認してください
• DROPBOX_FILES_MOVE_BATCH（v1）は「全件成功または全件失敗」の動作です。いずれかのエントリーが失敗すると、バッチ全体が失敗します
• DROPBOX_MOVE_BATCH（v2）は DROPBOX_FILES_MOVE_BATCH（v1）よりも推奨されます
• バッチ削除／移動では最大 1000 件、バッチフォルダー作成では最大 10,000 件のパスを指定できます
• バッチ移動操作では、大文字と小文字だけが異なる名前への変更はサポートされていません

5. フォルダーの内容を一覧表示する

使用するタイミング：Dropbox フォルダー内のファイルを閲覧または列挙したい場合

ツールの順序：

1. DROPBOX_LIST_FILES_IN_FOLDER - フォルダーの内容を一覧表示します［必須］
2. DROPBOX_LIST_FOLDERS - 削除済みの項目にも対応した代替のフォルダー一覧表示です［任意］
3. DROPBOX_GET_METADATA - 特定の項目の詳細を取得します［任意］

主なパラメーター：

• path：フォルダーのパス（ルートには空文字列 "" を指定します）
• recursive：すべての階層の内容を一覧表示するには true を指定します
• limit：リクエストごとの最大結果数（デフォルト／最大値は 2000）
• include_deleted：削除済みで復元可能な項目を含めるには true を指定します
• include_media_info：写真／動画のメタデータを取得するには true を指定します

注意点：

• ルートフォルダーには "/" ではなく空文字列 "" を使用してください
• 再帰的な一覧表示では結果が非常に多くなる場合があります。limit を使ってページサイズを調整してください
• 制限値が小さくても、カーソルによるページネーションが行われることがあります
• パスが正しくない場合、DROPBOX_LIST_FILES_IN_FOLDER は path/not_found を含む 409 Conflict を返します

よくあるパターン

ID の解決

• パスベース：ほとんどの Dropbox ツールではパス文字列を使用します（例："/Documents/file.pdf"）
• ID ベース：一部のツールでは id:... 形式を受け付けます（例："id:4g0reWVRsAAAAAAAAAAAQ"）
• 正規パス：後続の呼び出しでは、DROPBOX_GET_METADATA のレスポンスに含まれる path_display または path_lower を常に使用してください
• 共有リンク URL：DROPBOX_GET_SHARED_LINK_METADATA を使用して、URL をパス／ID に解決します

ページネーション

Dropbox では、ほとんどのエンドポイントでカーソルベースのページネーションを使用します：

• 検索：DROPBOX_SEARCH_CONTINUE で has_more と cursor をたどります（合計一致数は最大 10,000 件）
• フォルダー一覧：レスポンスのカーソルを使い、ページがなくなるまでたどります
• 共有リンク：DROPBOX_LIST_SHARED_LINKS の has_more と cursor をたどります
• バッチジョブのステータス：DROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCH で状態を確認します

非同期操作

Dropbox の操作のうち、いくつかは非同期で実行されます：

• DROPBOX_SAVE_URL - ジョブ ID を返します。状態を確認するか、wait: true を設定します（デフォルトでは最大 120 秒）
• DROPBOX_MOVE_BATCH / DROPBOX_FILES_MOVE_BATCH - ジョブ ID を返すことがあります
• DROPBOX_CREATE_FOLDER_BATCH - ジョブ ID を返すことがあります
• DROPBOX_DELETE_BATCH - ジョブ ID を返します

既知の注意点

パス形式

• すべてのパスは/で始まる必要があります（いくつかのエンドポイントでは、ルートを示す空文字列を除きます）。
• パスの末尾に/や空白を付けることはできません。
• パスでは大文字と小文字が区別されません。不透明なファイル ID の大文字と小文字はそのまま保持してください。
• API のpath_displayはユーザー入力と大文字・小文字が異なる場合があります。常に API から返されたパスを優先してください。

レート制限

• Dropbox API にはエンドポイントごとのレート制限があります。バッチ操作を使うと呼び出し回数を減らせます。
• 検索では、ページネーション全体を通じて一致する項目の合計が10,000件に制限されます。
• 大きなファイルの場合、DROPBOX_SAVE_URLは15分でタイムアウトします。

ファイルの内容

• DROPBOX_READ_FILEは、file_content_bytes内のコンテンツをBase64エンコードして返す場合があります。
• ダウンロードできないファイル（Dropbox Paper、Google Docs）には、代わりにDROPBOX_EXPORT_FILEが必要です。
• 共有リンクのダウンロード URL には、適切な認証ヘッダーが必要です。

共有

• 共有リンクがすでに存在する場合、新しい共有リンクを作成すると409 Conflictエラーが返されます。
• 新しいリンクを作成する前に、必ずDROPBOX_LIST_SHARED_LINKSを確認してください。
• 共有フォルダーへのアクセスは標準のパス一覧に表示されない場合があります。DROPBOX_LIST_SHARED_FOLDERSを使用してください。

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
ファイルを検索	DROPBOX_SEARCH_FILE_OR_FOLDER	query、options.path
検索を続行	DROPBOX_SEARCH_CONTINUE	cursor
フォルダーを一覧表示	DROPBOX_LIST_FILES_IN_FOLDER	path、recursive、limit
フォルダーを一覧表示	DROPBOX_LIST_FOLDERS	path、recursive
メタデータを取得	DROPBOX_GET_METADATA	path
ファイルを読み取り／ダウンロード	DROPBOX_READ_FILE	path
ファイルをアップロード	DROPBOX_UPLOAD_FILE	path、content、mode
URL を Dropbox に保存	DROPBOX_SAVE_URL	path、url
フォルダーの ZIP をダウンロード	DROPBOX_DOWNLOAD_ZIP	path
Paper ドキュメントをエクスポート	DROPBOX_EXPORT_FILE	path、export_format
共有リンクからダウンロード	DROPBOX_GET_SHARED_LINK_FILE	url
共有リンクを作成	DROPBOX_CREATE_SHARED_LINK	path、settings
共有リンクを一覧表示	DROPBOX_LIST_SHARED_LINKS	path、direct_only
共有リンクのメタデータ	DROPBOX_GET_SHARED_LINK_METADATA	url
共有フォルダーを一覧表示	DROPBOX_LIST_SHARED_FOLDERS	limit
フォルダーを作成	DROPBOX_CREATE_FOLDER	path
フォルダーを一括作成	DROPBOX_CREATE_FOLDER_BATCH	paths
ファイル／フォルダーを移動	DROPBOX_MOVE_FILE_OR_FOLDER	from_path、to_path
一括移動	DROPBOX_MOVE_BATCH	entries
ファイル／フォルダーを削除	DROPBOX_DELETE_FILE_OR_FOLDER	path
一括削除	DROPBOX_DELETE_BATCH	entries
ファイル／フォルダーをコピー	DROPBOX_COPY_FILE_OR_FOLDER	from_path、to_path
一括処理のステータスを確認	DROPBOX_CHECK_MOVE_BATCH	async_job_id

使用する場面

このスキルは、概要で説明されているワークフローまたは操作を実行する場合に適用できます。

例

ユーザーのリクエスト：

Rube MCP（Composio）を介して、Dropbox のファイル管理、共有、検索、アップロード、ダウンロード、フォルダー操作を自動化する。

制限事項

• このスキルは、タスクが上記の説明の範囲に明確に該当する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。