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 则必需］
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：每页结果数（默认 100，最多 1000）

注意事项：

• 如果存在更多结果，搜索会返回 has_more: true 和 cursor；必须继续搜索，以免遗漏匹配项
• 所有搜索页和 search_continue 页的匹配结果总数最多为 10,000
• DROPBOX_GET_METADATA 返回的 path_display 大小写可能与用户输入不同；始终使用返回的规范路径
• DROPBOX_READ_FILE 返回的文件内容可能是 Base64 编码的 file_content_bytes；解析前请先解码

2. 上传和下载文件

适用场景：用户想要将文件上传到 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：用于上传的 FileUploadable 对象，包含 s3key、mimetype 和 name
• 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 检查
• 创建链接前，务必使用 DROPBOX_GET_METADATA 验证路径，以避免出现 path/not_found 错误
• 请复用 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 会返回 409 Conflict 和 path/not_found

常见模式

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（默认最长等待 120s）
• 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 可能会以 Base64 编码的 file_content_bytes 返回内容
• 不可下载的文件（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 文件，包括共享、搜索、上传、下载和文件夹操作。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。