以下为本文档的中文说明dropbox-automationDropbox自动化是通过Rube MCP即Composio平台实现Dropbox文件管理自动化的技能。它覆盖了Dropbox的核心操作包括文件上传下载、搜索查找、文件夹管理、共享链接、批量操作和元数据检索。该技能通过Composio的Dropbox工具集与Dropbox API交互在AI代理中实现无缝的云端文件管理。设置过程分为四步连接Rube MCP服务器添加https://rube.app/mcp作为MCP端点无需API密钥通过RUBE_MANAGE_CONNECTIONS连接Dropbox工具集按照返回的OAuth链接完成授权确认连接状态为ACTIVE后开始使用。该技能详细提供了五大核心工作流的工具序列和参数说明文件搜索支持按名称、类型和扩展名筛选注意搜索结果可能分页最多10000条匹配上传下载支持常规文件操作、文件夹ZIP下载、公共URL保存和共享链接下载共享链接管理支持创建、列出和获取共享链接元数据允许设置受众范围、访问权限、过期时间和密码保护文件夹管理支持创建、移动、复制、删除包括批量操作和异步任务轮询文件夹内容浏览支持递归列出和分页。该技能还详细列出了各种操作中的常见陷阱如路径格式要求区分大小写、必须以/开头、速率限制、批量操作的异步特性等。它适用于需要频繁与Dropbox交互的自动化工作流如文档处理、备份同步和文件分发。Dropbox Automation via Rube MCPAutomate Dropbox operations including file upload/download, search, folder management, sharing links, batch operations, and metadata retrieval through Composio’s Dropbox toolkit.PrerequisitesRube MCP must be connected (RUBE_SEARCH_TOOLS available)Active Dropbox connection viaRUBE_MANAGE_CONNECTIONSwith toolkitdropboxAlways callRUBE_SEARCH_TOOLSfirst to get current tool schemasSetupGet Rube MCP: Addhttps://rube.app/mcpas an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.Verify Rube MCP is available by confirmingRUBE_SEARCH_TOOLSrespondsCallRUBE_MANAGE_CONNECTIONSwith toolkitdropboxIf connection is not ACTIVE, follow the returned auth link to complete Dropbox OAuthConfirm connection status shows ACTIVE before running any workflowsCore Workflows1. Search for Files and FoldersWhen to use: User wants to find files or folders by name, content, or typeTool 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])options.filename_only: Settrueto match filenames only (not content)options.max_results: Results per page (default 100, max 1000)Pitfalls:Search returnshas_more: truewith acursorwhen more results exist; MUST continue to avoid silently missing matchesMaximum 10,000 matches total across all pages of search search_continueDROPBOX_GET_METADATAreturnedpath_displaymay differ in casing from user input; always use the returned canonical pathFile content fromDROPBOX_READ_FILEmay be returned as base64-encodedfile_content_bytes; decode before parsing2. Upload and Download FilesWhen to use: User wants to upload files to Dropbox or download files from itTool 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) oroverwritefor uploadsautorename:trueto auto-rename on conflict instead of failingcontent: FileUploadable object withs3key,mimetype, andnamefor uploadsurl: Public URL forDROPBOX_SAVE_URLexport_format:markdown,html, orplain_textfor Paper docsPitfalls:DROPBOX_SAVE_URLis asynchronous and may take up to 15 minutes for large filesDROPBOX_DOWNLOAD_ZIPfolder must be under 20 GB with no single file over 4 GB and fewer than 10,000 entriesDROPBOX_READ_FILEcontent may be base64-encoded; check response formatShared link downloads viaDROPBOX_GET_SHARED_LINK_FILEmay requirelink_passwordfor protected links3. Share Files and Manage LinksWhen to use: User wants to create sharing links or manage existing shared linksTool sequence:DROPBOX_GET_METADATA- Confirm file/folder exists andget 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, orno_onesettings.access:vieweroreditorsettings.expires: ISO 8601 expiration date (e.g.,2026-12-31T23:59:59Z)settings.require_password/settings.link_password: Password protectionsettings.allow_download: Boolean for download permissiondirect_only: ForLIST_SHARED_LINKS, settrueto only return direct links (not parent folder links)Pitfalls:DROPBOX_CREATE_SHARED_LINKfails with 409 Conflict if a shared link already exists for the path; check withDROPBOX_LIST_SHARED_LINKSfirstAlways validate path withDROPBOX_GET_METADATAbefore creating links to avoidpath/not_founderrorsReuse existing links fromDROPBOX_LIST_SHARED_LINKSinstead of creating duplicatesrequested_visibilityis deprecated; useaudiencefor newer implementations4. Manage Folders (Create, Move, Delete)When to use: User wants to create, move, rename, or delete files and foldersTool 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:trueto auto-rename on conflictentries: Array of{from_path, to_path}for batch moves; array of paths for batch createsallow_shared_folder: Settrueto allow moving shared foldersallow_ownership_transfer: Settrueif move changes ownershipPitfalls:All paths are case-sensitive and must start with/Paths must NOT end with/or whitespaceBatch operations may be asynchronous; poll withDROPBOX_CHECK_MOVE_BATCHorDROPBOX_CHECK_FOLDER_BATCHDROPBOX_FILES_MOVE_BATCH(v1) has “all or nothing” behavior - if any entry fails, entire batch failsDROPBOX_MOVE_BATCH(v2) is preferred overDROPBOX_FILES_MOVE_BATCH(v1)Maximum 1000 entries per batch delete/move; 10,000 paths per batch folder createCase-only renaming is not supported in batch move operations5. List Folder ContentsWhen to use: User wants to browse or enumerate files in a Dropbox folderTool 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 stringfor root)recursive:trueto list all nested contentslimit: Max results per request (default/max 2000)include_deleted:trueto include deleted but recoverable itemsinclude_media_info:trueto get photo/video metadataPitfalls:Use empty stringfor root folder, not/Recursive listings can be very large; uselimitto control page sizeResults may paginate via cursor even with small limitsDROPBOX_LIST_FILES_IN_FOLDERreturns 409 Conflict withpath/not_foundfor incorrect pathsCommon PatternsID ResolutionPath-based: Most Dropbox tools use path strings (e.g.,/Documents/file.pdf)ID-based: Some tools acceptid:...format (e.g.,id:4g0reWVRsAAAAAAAAAAAQ)Canonical path: Always usepath_displayorpath_lowerfromDROPBOX_GET_METADATAresponses for subsequent callsShared link URL: UseDROPBOX_GET_SHARED_LINK_METADATAto resolve URLs to paths/IDsPaginationDropbox uses cursor-based pagination across most endpoints:Search: Followhas_morecursorwithDROPBOX_SEARCH_CONTINUE(max 10,000 total matches)Folder listing: Follow cursor from response until no more pagesShared links: Followhas_morecursorinDROPBOX_LIST_SHARED_LINKSBatch job status: Poll withDROPBOX_CHECK_MOVE_BATCH/DROPBOX_CHECK_FOLDER_BATCHAsync OperationsSeveral Dropbox operations run asynchronously:DROPBOX_SAVE_URL- returns job ID; poll or setwait: 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 IDKnown PitfallsPath FormatsAll paths must start with/(except empty string for root in some endpoints)Paths must NOT end with/or contain trailing whitespacePaths are case-sensitive for write operationspath_displayfrom API may differ in casing from user input; always prefer API-returned pathsRate LimitsDropbox API has per-endpoint rate limits; batch operations help reduce call countSearch is limited to 10,000 total matches across all paginationDROPBOX_SAVE_URLhas a 15-minute timeout for large filesFile ContentDROPBOX_READ_FILEmay return content as base64-encodedfile_content_bytesNon-downloadable files (Dropbox Paper, Google Docs) requireDROPBOX_EXPORT_FILEinsteadDownload URLs from shared links require proper authentication headersSharingCreating a shared link when one already exists returns a 409 Conflict errorAlways checkDROPBOX_LIST_SHARED_LINKSbefore creating new linksShared folder access may not appear in standard path listings; useDROPBOX_LIST_SHARED_FOLDERSQuick ReferenceTaskTool SlugKey ParamsSearch filesDROPBOX_SEARCH_FILE_OR_FOLDERquery,options.pathContinue searchDROPBOX_SEARCH_CONTINUEcursorList folderDROPBOX_LIST_FILES_IN_FOLDERpath,recursive,limitList foldersDROPBOX_LIST_FOLDERSpath,recursiveGet metadataDROPBOX_GET_METADATApathRead/download fileDROPBOX_READ_FILEpathUpload fileDROPBOX_UPLOAD_FILEpath,content,modeSave URL to DropboxDROPBOX_SAVE_URLpath,urlDownload folder zipDROPBOX_DOWNLOAD_ZIPpathExport Paper docDROPBOX_EXPORT_FILEpath,export_formatDownload shared linkDROPBOX_GET_SHARED_LINK_FILEurlCreate shared linkDROPBOX_CREATE_SHARED_LINKpath,settingsList shared linksDROPBOX_LIST_SHARED_LINKSpath,direct_onlyShared link metadataDROPBOX_GET_SHARED_LINK_METADATAurlList shared foldersDROPBOX_LIST_SHARED_FOLDERSlimitCreate folderDROPBOX_CREATE_FOLDERpathCreate folders batchDROPBOX_CREATE_FOLDER_BATCHpathsMove file/folderDROPBOX_MOVE_FILE_OR_FOLDERfrom_path,to_pathMove batchDROPBOX_MOVE_BATCHentriesDelete file/folderDROPBOX_DELETE_FILE_OR_FOLDERpathDelete batchDROPBOX_DELETE_BATCHentriesCopy file/folderDROPBOX_COPY_FILE_OR_FOLDERfrom_path,to_pathCheck batch statusDROPBOX_CHECK_MOVE_BATCHasync_job_idWhen to UseThis skill is applicable to execute the workflow or actions described in the overview.LimitationsUse this skill only when the task clearly matches the scope described above.Do not treat the output as a substitute for environment-specific validation, testing, or expert review.Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.