重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
dropbox-automation by composiohq/awesome-claude-skills
npx skills add https://github.com/composiohq/awesome-claude-skills --skill dropbox-automation通过 Composio 的 Dropbox 工具包,自动化 Dropbox 操作,包括文件上传/下载、搜索、文件夹管理、共享链接、批量操作和元数据检索。
工具包文档 : composio.dev/toolkits/dropbox
RUBE_SEARCH_TOOLS 可用)RUBE_MANAGE_CONNECTIONS 建立活跃的 Dropbox 连接,并指定工具包 dropboxRUBE_SEARCH_TOOLS 以获取当前工具模式获取 Rube MCP : 在您的客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。
RUBE_SEARCH_TOOLS 有响应,以验证 Rube MCP 可用广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
dropbox 调用 RUBE_MANAGE_CONNECTIONS使用场景 : 用户希望按名称、内容或类型查找文件或文件夹
工具调用顺序 :
DROPBOX_SEARCH_FILE_OR_FOLDER - 使用查询字符串进行搜索,可指定路径范围和过滤器 [必需]DROPBOX_SEARCH_CONTINUE - 使用游标对额外结果进行分页 [如果 has_more 为真则必需]DROPBOX_GET_METADATA - 验证搜索结果并获取其规范路径 [可选]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;必须继续搜索以避免静默遗漏匹配项DROPBOX_GET_METADATA 返回的 path_display 可能与用户输入的大小写不同;始终使用返回的规范路径DROPBOX_READ_FILE 返回的文件内容可能是 base64 编码的 file_content_bytes;解析前需解码使用场景 : 用户希望上传文件到 Dropbox 或从 Dropbox 下载文件
工具调用顺序 :
DROPBOX_UPLOAD_FILE - 将文件上传到指定路径 [上传必需]DROPBOX_READ_FILE - 从 Dropbox 下载/读取文件 [下载必需]DROPBOX_DOWNLOAD_ZIP - 将整个文件夹下载为 zip 文件 [可选]DROPBOX_SAVE_URL - 将公共 URL 的文件直接保存到 Dropbox [可选]DROPBOX_GET_SHARED_LINK_FILE - 从共享链接 URL 下载文件 [可选]DROPBOX_EXPORT_FILE - 将不可下载的文件(如 Dropbox Paper)导出为 markdown/HTML 格式 [可选]关键参数 :
path: Dropbox 路径(必须以 / 开头,例如 "/Documents/report.pdf")mode: 上传模式,"add"(默认,冲突时失败)或 "overwrite"autorename: 设置为 true 可在冲突时自动重命名,而不是失败content: 用于上传的 FileUploadable 对象,包含 s3key、mimetype 和 nameurl: DROPBOX_SAVE_URL 使用的公共 URLexport_format: 用于 Paper 文档的导出格式,"markdown"、"html" 或 "plain_text"注意事项 :
DROPBOX_SAVE_URL 是异步操作,大文件最多可能需要 15 分钟DROPBOX_DOWNLOAD_ZIP 的文件夹必须小于 20 GB,单个文件不超过 4 GB,且条目数少于 10,000DROPBOX_READ_FILE 的内容可能是 base64 编码的;请检查响应格式DROPBOX_GET_SHARED_LINK_FILE 下载受保护的共享链接可能需要 link_password使用场景 : 用户希望创建共享链接或管理现有的共享链接
工具调用顺序 :
DROPBOX_GET_METADATA - 确认文件/文件夹存在并获取规范路径 [前提]DROPBOX_LIST_SHARED_LINKS - 检查现有的共享链接以避免重复 [前提]DROPBOX_CREATE_SHARED_LINK - 创建新的共享链接 [必需]DROPBOX_GET_SHARED_LINK_METADATA - 将共享链接 URL 解析为元数据 [可选]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 冲突错误而失败;请先使用 DROPBOX_LIST_SHARED_LINKS 检查DROPBOX_GET_METADATA 验证路径,以避免 path/not_found 错误DROPBOX_LIST_SHARED_LINKS 中的现有链接,而不是创建重复链接requested_visibility 已弃用;新实现请使用 audience使用场景 : 用户希望创建、移动、重命名或删除文件和文件夹
工具调用顺序 :
DROPBOX_CREATE_FOLDER - 创建单个文件夹 [创建必需]DROPBOX_CREATE_FOLDER_BATCH - 一次性创建多个文件夹 [可选]DROPBOX_MOVE_FILE_OR_FOLDER - 移动或重命名单个文件/文件夹 [移动必需]DROPBOX_MOVE_BATCH - 一次性移动多个项目 [可选]DROPBOX_DELETE_FILE_OR_FOLDER - 删除单个文件或文件夹 [删除必需]DROPBOX_DELETE_BATCH - 一次性删除多个项目 [可选]DROPBOX_COPY_FILE_OR_FOLDER - 将文件或文件夹复制到新位置 [可选]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_CHECK_MOVE_BATCH 或 DROPBOX_CHECK_FOLDER_BATCH 轮询状态DROPBOX_FILES_MOVE_BATCH (v1) 具有“全有或全无”行为——如果任何条目失败,整个批处理都会失败DROPBOX_MOVE_BATCH (v2) 而非 DROPBOX_FILES_MOVE_BATCH (v1)使用场景 : 用户希望浏览或枚举 Dropbox 文件夹中的文件
工具调用顺序 :
DROPBOX_LIST_FILES_IN_FOLDER - 列出文件夹内容 [必需]DROPBOX_LIST_FOLDERS - 替代的文件夹列表方法,支持已删除条目 [可选]DROPBOX_GET_METADATA - 获取特定项目的详细信息 [可选]关键参数 :
path: 文件夹路径(根目录使用空字符串 "")recursive: 设置为 true 以列出所有嵌套内容limit: 每个请求的最大结果数(默认/最大 2000)include_deleted: 设置为 true 以包含已删除但可恢复的项目include_media_info: 设置为 true 以获取照片/视频元数据注意事项 :
"",而不是 "/"limit 控制页面大小DROPBOX_LIST_FILES_IN_FOLDER 会返回 409 冲突错误,并附带 path/not_found"/Documents/file.pdf")id:... 格式(例如 "id:4g0reWVRsAAAAAAAAAAAQ")DROPBOX_GET_METADATA 响应中的 path_display 或 path_lowerDROPBOX_GET_SHARED_LINK_METADATA 将 URL 解析为路径/IDDropbox 在大多数端点使用基于游标的分页:
has_more 为真,则使用 cursor 调用 DROPBOX_SEARCH_CONTINUE(总计最多 10,000 个匹配项)DROPBOX_LIST_SHARED_LINKS 中跟随 has_more + cursorDROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCH 轮询一些 Dropbox 操作是异步运行的:
DROPBOX_SAVE_URL - 返回作业 ID;轮询或设置 wait: true(默认最多 120 秒)DROPBOX_MOVE_BATCH / DROPBOX_FILES_MOVE_BATCH - 可能返回作业 IDDROPBOX_CREATE_FOLDER_BATCH - 可能返回作业 IDDROPBOX_DELETE_BATCH - 返回作业 ID/ 开头(某些端点中根目录使用空字符串除外)/ 结尾或包含尾随空格path_display 可能与用户输入的大小写不同;始终优先使用 API 返回的路径DROPBOX_SAVE_URL 对于大文件有 15 分钟的超时限制DROPBOX_READ_FILE 可能将内容作为 base64 编码的 file_content_bytes 返回DROPBOX_EXPORT_FILE 替代DROPBOX_LIST_SHARED_LINKSDROPBOX_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 |
由 Composio 提供支持
每周安装数
68
代码仓库
GitHub 星标数
42.3K
首次出现
2026年2月6日
安全审计
安装于
claude-code53
opencode52
gemini-cli46
codex43
replit42
cursor39
Automate Dropbox operations including file upload/download, search, folder management, sharing links, batch operations, and metadata retrieval through Composio's Dropbox toolkit.
Toolkit docs : composio.dev/toolkits/dropbox
RUBE_MANAGE_CONNECTIONS with toolkit dropboxRUBE_SEARCH_TOOLS first to get current tool schemasGet Rube MCP : Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
RUBE_SEARCH_TOOLS respondsRUBE_MANAGE_CONNECTIONS with toolkit dropboxWhen to use : User wants to find files or folders by name, content, or type
Tool sequence :
DROPBOX_SEARCH_FILE_OR_FOLDER - Search by query string with optional path scope and filters [Required]DROPBOX_SEARCH_CONTINUE - Paginate through additional results using cursor [Required if has_more]DROPBOX_GET_METADATA - Validate and get canonical path for a search result [Optional]DROPBOX_READ_FILE - Read file content to verify it is the intended document [Optional]Key parameters :
query: Search string (case-insensitive, 1+ non-whitespace characters)options.path: Scope search to a folder (e.g., "/Documents"); empty string for rootoptions.file_categories: Filter by type ("image", "document", "pdf", "folder", etc.)options.file_extensions: Filter by extension (e.g., ["jpg", "png"])Pitfalls :
has_more: true with a cursor when more results exist; MUST continue to avoid silently missing matchesDROPBOX_GET_METADATA returned path_display may differ in casing from user input; always use the returned canonical pathDROPBOX_READ_FILE may be returned as base64-encoded file_content_bytes; decode before parsingWhen to use : User wants to upload files to Dropbox or download files from it
Tool sequence :
DROPBOX_UPLOAD_FILE - Upload a file to a specified path [Required for upload]DROPBOX_READ_FILE - Download/read a file from Dropbox [Required for download]DROPBOX_DOWNLOAD_ZIP - Download an entire folder as a zip file [Optional]DROPBOX_SAVE_URL - Save a file from a public URL directly to Dropbox [Optional]DROPBOX_GET_SHARED_LINK_FILE - Download a file from a shared link URL [Optional]DROPBOX_EXPORT_FILE - Export non-downloadable files like Dropbox Paper to markdown/HTML [Optional]Key parameters :
path: Dropbox path (must start with /, e.g., "/Documents/report.pdf")mode: "add" (default, fail on conflict) or "overwrite" for uploadsautorename: true to auto-rename on conflict instead of failingcontent: FileUploadable object with s3key, mimetype, and for uploadsPitfalls :
DROPBOX_SAVE_URL is asynchronous and may take up to 15 minutes for large filesDROPBOX_DOWNLOAD_ZIP folder must be under 20 GB with no single file over 4 GB and fewer than 10,000 entriesDROPBOX_READ_FILE content may be base64-encoded; check response formatDROPBOX_GET_SHARED_LINK_FILE may require link_password for protected linksWhen to use : User wants to create sharing links or manage existing shared links
Tool sequence :
DROPBOX_GET_METADATA - Confirm file/folder exists and get canonical path [Prerequisite]DROPBOX_LIST_SHARED_LINKS - Check for existing shared links to avoid duplicates [Prerequisite]DROPBOX_CREATE_SHARED_LINK - Create a new shared link [Required]DROPBOX_GET_SHARED_LINK_METADATA - Resolve a shared link URL to metadata [Optional]DROPBOX_LIST_SHARED_FOLDERS - List all shared folders the user has access to [Optional]Key parameters :
path: File or folder path for link creationsettings.audience: "public", "team", or "no_one"settings.access: "viewer" or "editor"settings.expires: ISO 8601 expiration date (e.g., "2026-12-31T23:59:59Z")settings.require_password / : Password protectionPitfalls :
DROPBOX_CREATE_SHARED_LINK fails with 409 Conflict if a shared link already exists for the path; check with DROPBOX_LIST_SHARED_LINKS firstDROPBOX_GET_METADATA before creating links to avoid path/not_found errorsDROPBOX_LIST_SHARED_LINKS instead of creating duplicatesrequested_visibility is deprecated; use audience for newer implementationsWhen to use : User wants to create, move, rename, or delete files and folders
Tool sequence :
DROPBOX_CREATE_FOLDER - Create a single folder [Required for create]DROPBOX_CREATE_FOLDER_BATCH - Create multiple folders at once [Optional]DROPBOX_MOVE_FILE_OR_FOLDER - Move or rename a single file/folder [Required for move]DROPBOX_MOVE_BATCH - Move multiple items at once [Optional]DROPBOX_DELETE_FILE_OR_FOLDER - Delete a single file or folder [Required for delete]DROPBOX_DELETE_BATCH - Delete multiple items at once [Optional]DROPBOX_COPY_FILE_OR_FOLDER - Copy a file or folder to a new location [Optional]DROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCH - Poll async batch job status [Required for batch ops]Key parameters :
path: Target path (must start with /, case-sensitive)from_path / to_path: Source and destination for move/copy operationsautorename: true to auto-rename on conflictentries: Array of {from_path, to_path} for batch moves; array of paths for batch createsallow_shared_folder: Set true to allow moving shared foldersPitfalls :
// or whitespaceDROPBOX_CHECK_MOVE_BATCH or DROPBOX_CHECK_FOLDER_BATCHDROPBOX_FILES_MOVE_BATCH (v1) has "all or nothing" behavior - if any entry fails, entire batch failsDROPBOX_MOVE_BATCH (v2) is preferred over DROPBOX_FILES_MOVE_BATCH (v1)When to use : User wants to browse or enumerate files in a Dropbox folder
Tool sequence :
DROPBOX_LIST_FILES_IN_FOLDER - List contents of a folder [Required]DROPBOX_LIST_FOLDERS - Alternative folder listing with deleted entries support [Optional]DROPBOX_GET_METADATA - Get details for a specific item [Optional]Key parameters :
path: Folder path (empty string "" for root)recursive: true to list all nested contentslimit: Max results per request (default/max 2000)include_deleted: true to include deleted but recoverable itemsinclude_media_info: true to get photo/video metadataPitfalls :
"" for root folder, not "/"limit to control page sizeDROPBOX_LIST_FILES_IN_FOLDER returns 409 Conflict with path/not_found for incorrect paths"/Documents/file.pdf")id:... format (e.g., "id:4g0reWVRsAAAAAAAAAAAQ")path_display or path_lower from DROPBOX_GET_METADATA responses for subsequent callsDROPBOX_GET_SHARED_LINK_METADATA to resolve URLs to paths/IDsDropbox uses cursor-based pagination across most endpoints:
has_more + cursor with DROPBOX_SEARCH_CONTINUE (max 10,000 total matches)has_more + cursor in DROPBOX_LIST_SHARED_LINKSDROPBOX_CHECK_MOVE_BATCH / DROPBOX_CHECK_FOLDER_BATCHSeveral Dropbox operations run asynchronously:
DROPBOX_SAVE_URL - returns job ID; poll or set wait: true (up to 120s default)DROPBOX_MOVE_BATCH / DROPBOX_FILES_MOVE_BATCH - may return job IDDROPBOX_CREATE_FOLDER_BATCH - may return job IDDROPBOX_DELETE_BATCH - returns job ID/ (except empty string for root in some endpoints)/ or contain trailing whitespacepath_display from API may differ in casing from user input; always prefer API-returned pathsDROPBOX_SAVE_URL has a 15-minute timeout for large filesDROPBOX_READ_FILE may return content as base64-encoded file_content_bytesDROPBOX_EXPORT_FILE insteadDROPBOX_LIST_SHARED_LINKS before creating new linksDROPBOX_LIST_SHARED_FOLDERS| Task | Tool Slug | Key Params |
|---|---|---|
| Search files | DROPBOX_SEARCH_FILE_OR_FOLDER | query, options.path |
| Continue search | DROPBOX_SEARCH_CONTINUE | cursor |
| List folder | DROPBOX_LIST_FILES_IN_FOLDER | path, , |
Powered byComposio
Weekly Installs
68
Repository
GitHub Stars
42.3K
First Seen
Feb 6, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
claude-code53
opencode52
gemini-cli46
codex43
replit42
cursor39
Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU
111,700 周安装
options.filename_onlytrueoptions.max_results: Results per page (default 100, max 1000)nameurl: Public URL for DROPBOX_SAVE_URLexport_format: "markdown", "html", or "plain_text" for Paper docssettings.link_passwordsettings.allow_download: Boolean for download permissiondirect_only: For LIST_SHARED_LINKS, set true to only return direct links (not parent folder links)allow_ownership_transfertruerecursivelimit| List folders | DROPBOX_LIST_FOLDERS | path, recursive |
| Get metadata | DROPBOX_GET_METADATA | path |
| Read/download file | DROPBOX_READ_FILE | path |
| Upload file | DROPBOX_UPLOAD_FILE | path, content, mode |
| Save URL to Dropbox | DROPBOX_SAVE_URL | path, url |
| Download folder zip | DROPBOX_DOWNLOAD_ZIP | path |
| Export Paper doc | DROPBOX_EXPORT_FILE | path, export_format |
| Download shared link | DROPBOX_GET_SHARED_LINK_FILE | url |
| Create shared link | DROPBOX_CREATE_SHARED_LINK | path, settings |
| List shared links | DROPBOX_LIST_SHARED_LINKS | path, direct_only |
| Shared link metadata | DROPBOX_GET_SHARED_LINK_METADATA | url |
| List shared folders | DROPBOX_LIST_SHARED_FOLDERS | limit |
| Create folder | DROPBOX_CREATE_FOLDER | path |
| Create folders batch | DROPBOX_CREATE_FOLDER_BATCH | paths |
| Move file/folder | DROPBOX_MOVE_FILE_OR_FOLDER | from_path, to_path |
| Move batch | DROPBOX_MOVE_BATCH | entries |
| Delete file/folder | DROPBOX_DELETE_FILE_OR_FOLDER | path |
| Delete batch | DROPBOX_DELETE_BATCH | entries |
| Copy file/folder | DROPBOX_COPY_FILE_OR_FOLDER | from_path, to_path |
| Check batch status | DROPBOX_CHECK_MOVE_BATCH | async_job_id |