{
  "schemaVersion": "1.0",
  "item": {
    "slug": "dropbox",
    "name": "Dropbox Manager",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/RyanLisse/dropbox",
    "canonicalUrl": "https://clawhub.ai/RyanLisse/dropbox",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/dropbox",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dropbox",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "AGENTS.md",
      "SKILL.json",
      "SKILL.md",
      "references/mcp-setup.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "dropbox",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T18:09:47.004Z",
      "expiresAt": "2026-05-09T18:09:47.004Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dropbox",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dropbox",
        "contentDisposition": "attachment; filename=\"dropbox-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "dropbox"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/dropbox"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/dropbox",
    "agentPageUrl": "https://openagent3.xyz/skills/dropbox/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dropbox/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dropbox/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Dropbox Manager Skill",
        "body": "Manage Dropbox files via MCP server and CLI. Swift-native implementation using SwiftyDropbox SDK with OAuth 2.0 PKCE and secure Keychain token storage."
      },
      {
        "title": "Prerequisites",
        "body": "# Clone and build Dropbook\ngit clone https://github.com/RyanLisse/Dropbook.git\ncd Dropbook\nmake build"
      },
      {
        "title": "Authentication",
        "body": "Option 1: OAuth Login with Keychain (Recommended)\n\nUse the interactive OAuth flow with secure Keychain storage:\n\nexport DROPBOX_APP_KEY=\"your_dropbox_app_key\"\nexport DROPBOX_APP_SECRET=\"your_dropbox_app_secret\"\nmake login\n# or: swift run dropbook login\n\nThis will:\n\nGenerate PKCE code verifier and challenge (SHA256, RFC 7636)\nOpen an authorization URL with state parameter (CSRF protection)\nPrompt you to paste the authorization code\nExchange code for access and refresh tokens\nSave tokens to macOS Keychain (hardware-backed encryption)\nFall back to ~/.dropbook/auth.json if Keychain unavailable\nEnable automatic token refreshing\n\nSecurity Features (RFC 9700 compliant):\n\nPKCE with S256 challenge method\nState parameter for CSRF protection\nKeychain storage with kSecAttrAccessibleWhenUnlocked\nCryptoKit for cryptographic operations\n\nOption 2: Environment Variables (Legacy)\n\nexport DROPBOX_APP_KEY=\"your_dropbox_app_key\"\nexport DROPBOX_APP_SECRET=\"your_dropbox_app_secret\"\nexport DROPBOX_ACCESS_TOKEN=\"your_dropbox_access_token\"\n\nNote: Manual tokens don't support automatic refreshing. Use OAuth login for production use."
      },
      {
        "title": "Logout",
        "body": "Clear stored tokens from both Keychain and file storage:\n\nmake logout\n# or: swift run dropbook logout"
      },
      {
        "title": "MCP Server (Recommended)",
        "body": "Start the MCP server:\n\nmake mcp\n# or: ./.build/debug/dropbook mcp"
      },
      {
        "title": "MCP Tools",
        "body": "ToolDescriptionlist_directoryList files and folders in a Dropbox directorysearchSearch for files by name or contentuploadUpload a file to DropboxdownloadDownload a file from DropboxdeleteDelete a file or folder (moves to trash)get_account_infoGet account name and emailread_fileRead contents of a text file\n\nlist_directory\n\nList files and folders in a Dropbox directory.\n\nParameters:\n\npath (string, optional): Directory path. Default: \"/\"\n\nResponse:\n\n{\n  \"files\": [\n    {\"type\": \"file\", \"name\": \"doc.pdf\", \"path\": \"/Docs/doc.pdf\", \"size\": 1024},\n    {\"type\": \"folder\", \"name\": \"Projects\", \"path\": \"/Projects\"}\n  ]\n}\n\nsearch\n\nSearch for files by name or content.\n\nParameters:\n\nquery (string, required): Search term\npath (string, optional): Path to search within. Default: \"/\"\n\nResponse:\n\n{\n  \"count\": 2,\n  \"results\": [\n    {\"matchType\": \"filename\", \"metadata\": {\"name\": \"report.pdf\", \"path\": \"/Docs/report.pdf\"}}\n  ]\n}\n\nupload\n\nUpload a file to Dropbox.\n\nParameters:\n\nlocalPath (string, required): Absolute path to local file\nremotePath (string, required): Destination in Dropbox\noverwrite (boolean, optional): Replace if exists. Default: false\n\nResponse:\n\n{\n  \"uploaded\": true,\n  \"name\": \"file.txt\",\n  \"path\": \"/Uploads/file.txt\",\n  \"size\": 5000\n}\n\ndownload\n\nDownload a file from Dropbox.\n\nParameters:\n\nremotePath (string, required): File path in Dropbox\nlocalPath (string, required): Local destination path\n\nResponse:\n\n{\n  \"downloaded\": true,\n  \"to\": \"/tmp/report.pdf\"\n}\n\ndelete\n\nDelete a file or folder from Dropbox (moves to trash).\n\nParameters:\n\npath (string, required): Path to delete in Dropbox\n\nResponse:\n\n{\n  \"deleted\": true,\n  \"path\": \"/Docs/old-file.pdf\"\n}\n\nget_account_info\n\nGet Dropbox account information.\n\nParameters: None\n\nResponse:\n\n{\n  \"name\": \"Ryan Lisse\",\n  \"email\": \"user@example.com\"\n}\n\nread_file\n\nRead and return the contents of a text file from Dropbox.\n\nParameters:\n\npath (string, required): Path to file in Dropbox\n\nResponse:\nReturns the file contents as text. Only works with UTF-8 encoded text files."
      },
      {
        "title": "CLI Commands",
        "body": "# Authentication\nmake login                 # OAuth login with Keychain storage\nmake logout                # Clear stored tokens\n\n# File operations\nmake list                  # List root directory\nswift run dropbook list /path\n\n# Search files\nswift run dropbook search \"query\" [path]\n\n# Upload file\nswift run dropbook upload /local/path /remote/path [--overwrite]\n\n# Download file\nswift run dropbook download /remote/path /local/path\n\n# Start MCP server\nmake mcp"
      },
      {
        "title": "Claude Code (Project-level)",
        "body": "The project includes a .mcp.json file that configures the MCP server:\n\n{\n  \"mcpServers\": {\n    \"dropbox\": {\n      \"command\": \"/path/to/Dropbook/.build/debug/dropbook\",\n      \"args\": [\"mcp\"],\n      \"env\": {\n        \"DROPBOX_APP_KEY\": \"${DROPBOX_APP_KEY}\",\n        \"DROPBOX_APP_SECRET\": \"${DROPBOX_APP_SECRET}\"\n      }\n    }\n  }\n}\n\nEnable project MCP servers in Claude Code settings.json:\n\n{\n  \"enableAllProjectMcpServers\": true\n}"
      },
      {
        "title": "Claude Desktop",
        "body": "{\n  \"mcpServers\": {\n    \"dropbox\": {\n      \"command\": \"/path/to/dropbook/.build/debug/dropbook\",\n      \"args\": [\"mcp\"],\n      \"env\": {\n        \"DROPBOX_APP_KEY\": \"${DROPBOX_APP_KEY}\",\n        \"DROPBOX_APP_SECRET\": \"${DROPBOX_APP_SECRET}\"\n      }\n    }\n  }\n}"
      },
      {
        "title": "Error Handling",
        "body": "ErrorCauseSolutionnotConfiguredMissing env varsSet DROPBOX_APP_KEY, DROPBOX_APP_SECRETinvalidArgumentsMissing required paramsCheck tool parametersnotFoundPath doesn't existUse list_directory to verify pathsitemNotFoundNo token in KeychainRun make login to authenticate"
      },
      {
        "title": "Architecture",
        "body": "Dropbook/\n├── Sources/\n│   ├── DropbookCore/           # Business logic (actor-based)\n│   │   ├── Auth/               # Keychain & file token storage\n│   │   ├── Config/             # Configuration management\n│   │   ├── Models/             # Domain models\n│   │   └── Services/           # DropboxService actor\n│   ├── DropbookCLI/            # CLI adapter\n│   │   └── Commands/           # Login, logout, file commands\n│   └── DropbookMCP/            # MCP server\n├── dropbox-skill/              # Skill documentation\n├── Makefile                    # Build automation\n├── .mcp.json                   # MCP server configuration\n└── Package.swift"
      },
      {
        "title": "Bulk Operations with rclone",
        "body": "For large-scale operations like backups, syncing, or bulk transfers, use rclone - a powerful cloud sync tool with native Dropbox support."
      },
      {
        "title": "Install rclone",
        "body": "brew install rclone"
      },
      {
        "title": "Configure rclone for Dropbox",
        "body": "# Interactive setup (opens browser for OAuth)\nrclone authorize dropbox\n\n# Save the token output to config\nmkdir -p ~/.config/rclone\ncat > ~/.config/rclone/rclone.conf << 'EOF'\n[dropbox]\ntype = dropbox\ntoken = {\"access_token\":\"...paste token here...\"}\nEOF"
      },
      {
        "title": "Backup to Network Drive / Time Capsule",
        "body": "# Full backup with progress\nrclone copy dropbox: /Volumes/TimeCapsule/Dropbox-Backup \\\n    --progress \\\n    --transfers 4 \\\n    --checkers 8 \\\n    --retries 10 \\\n    --log-file /tmp/dropbox-backup.log\n\n# Sync (mirror - deletes files not in source)\nrclone sync dropbox: /Volumes/Backup/Dropbox --progress\n\n# Check what would be copied (dry run)\nrclone copy dropbox: /Volumes/Backup --dry-run"
      },
      {
        "title": "Common rclone Commands",
        "body": "# List remote contents\nrclone lsd dropbox:              # List directories\nrclone ls dropbox:               # List all files\nrclone size dropbox:             # Calculate total size\n\n# Copy operations\nrclone copy dropbox:folder /local/path    # Download folder\nrclone copy /local/path dropbox:folder    # Upload folder\n\n# Sync (bidirectional)\nrclone bisync dropbox: /local/path --resync\n\n# Mount as filesystem (macOS - requires macFUSE)\nrclone mount dropbox: /mnt/dropbox --vfs-cache-mode full"
      },
      {
        "title": "rclone Flags for Reliability",
        "body": "FlagDescription--progressShow real-time transfer progress--transfers 4Number of parallel transfers--checkers 8Number of parallel checkers--retries 10Retry failed operations--low-level-retries 20Retry low-level errors--log-file pathWrite logs to file--dry-runShow what would be done--checksumVerify with checksums"
      },
      {
        "title": "Rate Limiting",
        "body": "Dropbox has strict API rate limits. If you see too_many_requests errors:\n\n# Use bandwidth limiting\nrclone copy dropbox: /backup --bwlimit 1M\n\n# Or add delays between operations\nrclone copy dropbox: /backup --tpslimit 2\n\nrclone handles rate limits automatically with exponential backoff."
      },
      {
        "title": "Best Practices",
        "body": "Use OAuth login - Secure Keychain storage with automatic token refresh\nUse MCP for agents - More reliable for programmatic access\nUse rclone for bulk ops - Better for backups and large transfers\nValidate paths first - Use list_directory before operations\nHandle errors gracefully - Check responses for error fields\nRespect rate limits - Add delays between bulk operations\nUse absolute paths - Always provide full paths for file operations"
      },
      {
        "title": "Security",
        "body": "Keychain Storage: Tokens stored with hardware-backed encryption\nPKCE: Proof Key for Code Exchange prevents authorization code interception\nState Parameter: CSRF protection for OAuth flow\nToken Refresh: Automatic refresh before expiration\nCryptoKit: Modern Swift cryptographic library"
      },
      {
        "title": "Dependencies",
        "body": "SwiftyDropbox (v10.2.4+): Official Dropbox Swift SDK\nMCP (swift-sdk): Model Context Protocol SDK\nCryptoKit: Apple's cryptographic framework\nrclone (optional): For bulk operations and backups (brew install rclone)"
      },
      {
        "title": "See Also",
        "body": "Dropbook GitHub\nCLAUDE.md - Full project documentation\nDropbox API Docs\nrclone Dropbox Docs - Bulk sync and backup\nRFC 7636 - PKCE\nRFC 9700 - OAuth 2.0 Security Best Practices"
      }
    ],
    "body": "Dropbox Manager Skill\n\nManage Dropbox files via MCP server and CLI. Swift-native implementation using SwiftyDropbox SDK with OAuth 2.0 PKCE and secure Keychain token storage.\n\nSetup\nPrerequisites\n# Clone and build Dropbook\ngit clone https://github.com/RyanLisse/Dropbook.git\ncd Dropbook\nmake build\n\nAuthentication\nOption 1: OAuth Login with Keychain (Recommended)\n\nUse the interactive OAuth flow with secure Keychain storage:\n\nexport DROPBOX_APP_KEY=\"your_dropbox_app_key\"\nexport DROPBOX_APP_SECRET=\"your_dropbox_app_secret\"\nmake login\n# or: swift run dropbook login\n\n\nThis will:\n\nGenerate PKCE code verifier and challenge (SHA256, RFC 7636)\nOpen an authorization URL with state parameter (CSRF protection)\nPrompt you to paste the authorization code\nExchange code for access and refresh tokens\nSave tokens to macOS Keychain (hardware-backed encryption)\nFall back to ~/.dropbook/auth.json if Keychain unavailable\nEnable automatic token refreshing\n\nSecurity Features (RFC 9700 compliant):\n\nPKCE with S256 challenge method\nState parameter for CSRF protection\nKeychain storage with kSecAttrAccessibleWhenUnlocked\nCryptoKit for cryptographic operations\nOption 2: Environment Variables (Legacy)\nexport DROPBOX_APP_KEY=\"your_dropbox_app_key\"\nexport DROPBOX_APP_SECRET=\"your_dropbox_app_secret\"\nexport DROPBOX_ACCESS_TOKEN=\"your_dropbox_access_token\"\n\n\nNote: Manual tokens don't support automatic refreshing. Use OAuth login for production use.\n\nLogout\n\nClear stored tokens from both Keychain and file storage:\n\nmake logout\n# or: swift run dropbook logout\n\nMCP Server (Recommended)\n\nStart the MCP server:\n\nmake mcp\n# or: ./.build/debug/dropbook mcp\n\nMCP Tools\nTool\tDescription\nlist_directory\tList files and folders in a Dropbox directory\nsearch\tSearch for files by name or content\nupload\tUpload a file to Dropbox\ndownload\tDownload a file from Dropbox\ndelete\tDelete a file or folder (moves to trash)\nget_account_info\tGet account name and email\nread_file\tRead contents of a text file\nlist_directory\n\nList files and folders in a Dropbox directory.\n\nParameters:\n\npath (string, optional): Directory path. Default: \"/\"\n\nResponse:\n\n{\n  \"files\": [\n    {\"type\": \"file\", \"name\": \"doc.pdf\", \"path\": \"/Docs/doc.pdf\", \"size\": 1024},\n    {\"type\": \"folder\", \"name\": \"Projects\", \"path\": \"/Projects\"}\n  ]\n}\n\nsearch\n\nSearch for files by name or content.\n\nParameters:\n\nquery (string, required): Search term\npath (string, optional): Path to search within. Default: \"/\"\n\nResponse:\n\n{\n  \"count\": 2,\n  \"results\": [\n    {\"matchType\": \"filename\", \"metadata\": {\"name\": \"report.pdf\", \"path\": \"/Docs/report.pdf\"}}\n  ]\n}\n\nupload\n\nUpload a file to Dropbox.\n\nParameters:\n\nlocalPath (string, required): Absolute path to local file\nremotePath (string, required): Destination in Dropbox\noverwrite (boolean, optional): Replace if exists. Default: false\n\nResponse:\n\n{\n  \"uploaded\": true,\n  \"name\": \"file.txt\",\n  \"path\": \"/Uploads/file.txt\",\n  \"size\": 5000\n}\n\ndownload\n\nDownload a file from Dropbox.\n\nParameters:\n\nremotePath (string, required): File path in Dropbox\nlocalPath (string, required): Local destination path\n\nResponse:\n\n{\n  \"downloaded\": true,\n  \"to\": \"/tmp/report.pdf\"\n}\n\ndelete\n\nDelete a file or folder from Dropbox (moves to trash).\n\nParameters:\n\npath (string, required): Path to delete in Dropbox\n\nResponse:\n\n{\n  \"deleted\": true,\n  \"path\": \"/Docs/old-file.pdf\"\n}\n\nget_account_info\n\nGet Dropbox account information.\n\nParameters: None\n\nResponse:\n\n{\n  \"name\": \"Ryan Lisse\",\n  \"email\": \"user@example.com\"\n}\n\nread_file\n\nRead and return the contents of a text file from Dropbox.\n\nParameters:\n\npath (string, required): Path to file in Dropbox\n\nResponse: Returns the file contents as text. Only works with UTF-8 encoded text files.\n\nCLI Commands\n# Authentication\nmake login                 # OAuth login with Keychain storage\nmake logout                # Clear stored tokens\n\n# File operations\nmake list                  # List root directory\nswift run dropbook list /path\n\n# Search files\nswift run dropbook search \"query\" [path]\n\n# Upload file\nswift run dropbook upload /local/path /remote/path [--overwrite]\n\n# Download file\nswift run dropbook download /remote/path /local/path\n\n# Start MCP server\nmake mcp\n\nMCP Client Configuration\nClaude Code (Project-level)\n\nThe project includes a .mcp.json file that configures the MCP server:\n\n{\n  \"mcpServers\": {\n    \"dropbox\": {\n      \"command\": \"/path/to/Dropbook/.build/debug/dropbook\",\n      \"args\": [\"mcp\"],\n      \"env\": {\n        \"DROPBOX_APP_KEY\": \"${DROPBOX_APP_KEY}\",\n        \"DROPBOX_APP_SECRET\": \"${DROPBOX_APP_SECRET}\"\n      }\n    }\n  }\n}\n\n\nEnable project MCP servers in Claude Code settings.json:\n\n{\n  \"enableAllProjectMcpServers\": true\n}\n\nClaude Desktop\n{\n  \"mcpServers\": {\n    \"dropbox\": {\n      \"command\": \"/path/to/dropbook/.build/debug/dropbook\",\n      \"args\": [\"mcp\"],\n      \"env\": {\n        \"DROPBOX_APP_KEY\": \"${DROPBOX_APP_KEY}\",\n        \"DROPBOX_APP_SECRET\": \"${DROPBOX_APP_SECRET}\"\n      }\n    }\n  }\n}\n\nError Handling\nError\tCause\tSolution\nnotConfigured\tMissing env vars\tSet DROPBOX_APP_KEY, DROPBOX_APP_SECRET\ninvalidArguments\tMissing required params\tCheck tool parameters\nnotFound\tPath doesn't exist\tUse list_directory to verify paths\nitemNotFound\tNo token in Keychain\tRun make login to authenticate\nArchitecture\nDropbook/\n├── Sources/\n│   ├── DropbookCore/           # Business logic (actor-based)\n│   │   ├── Auth/               # Keychain & file token storage\n│   │   ├── Config/             # Configuration management\n│   │   ├── Models/             # Domain models\n│   │   └── Services/           # DropboxService actor\n│   ├── DropbookCLI/            # CLI adapter\n│   │   └── Commands/           # Login, logout, file commands\n│   └── DropbookMCP/            # MCP server\n├── dropbox-skill/              # Skill documentation\n├── Makefile                    # Build automation\n├── .mcp.json                   # MCP server configuration\n└── Package.swift\n\nBulk Operations with rclone\n\nFor large-scale operations like backups, syncing, or bulk transfers, use rclone - a powerful cloud sync tool with native Dropbox support.\n\nInstall rclone\nbrew install rclone\n\nConfigure rclone for Dropbox\n# Interactive setup (opens browser for OAuth)\nrclone authorize dropbox\n\n# Save the token output to config\nmkdir -p ~/.config/rclone\ncat > ~/.config/rclone/rclone.conf << 'EOF'\n[dropbox]\ntype = dropbox\ntoken = {\"access_token\":\"...paste token here...\"}\nEOF\n\nBackup to Network Drive / Time Capsule\n# Full backup with progress\nrclone copy dropbox: /Volumes/TimeCapsule/Dropbox-Backup \\\n    --progress \\\n    --transfers 4 \\\n    --checkers 8 \\\n    --retries 10 \\\n    --log-file /tmp/dropbox-backup.log\n\n# Sync (mirror - deletes files not in source)\nrclone sync dropbox: /Volumes/Backup/Dropbox --progress\n\n# Check what would be copied (dry run)\nrclone copy dropbox: /Volumes/Backup --dry-run\n\nCommon rclone Commands\n# List remote contents\nrclone lsd dropbox:              # List directories\nrclone ls dropbox:               # List all files\nrclone size dropbox:             # Calculate total size\n\n# Copy operations\nrclone copy dropbox:folder /local/path    # Download folder\nrclone copy /local/path dropbox:folder    # Upload folder\n\n# Sync (bidirectional)\nrclone bisync dropbox: /local/path --resync\n\n# Mount as filesystem (macOS - requires macFUSE)\nrclone mount dropbox: /mnt/dropbox --vfs-cache-mode full\n\nrclone Flags for Reliability\nFlag\tDescription\n--progress\tShow real-time transfer progress\n--transfers 4\tNumber of parallel transfers\n--checkers 8\tNumber of parallel checkers\n--retries 10\tRetry failed operations\n--low-level-retries 20\tRetry low-level errors\n--log-file path\tWrite logs to file\n--dry-run\tShow what would be done\n--checksum\tVerify with checksums\nRate Limiting\n\nDropbox has strict API rate limits. If you see too_many_requests errors:\n\n# Use bandwidth limiting\nrclone copy dropbox: /backup --bwlimit 1M\n\n# Or add delays between operations\nrclone copy dropbox: /backup --tpslimit 2\n\n\nrclone handles rate limits automatically with exponential backoff.\n\nBest Practices\nUse OAuth login - Secure Keychain storage with automatic token refresh\nUse MCP for agents - More reliable for programmatic access\nUse rclone for bulk ops - Better for backups and large transfers\nValidate paths first - Use list_directory before operations\nHandle errors gracefully - Check responses for error fields\nRespect rate limits - Add delays between bulk operations\nUse absolute paths - Always provide full paths for file operations\nSecurity\nKeychain Storage: Tokens stored with hardware-backed encryption\nPKCE: Proof Key for Code Exchange prevents authorization code interception\nState Parameter: CSRF protection for OAuth flow\nToken Refresh: Automatic refresh before expiration\nCryptoKit: Modern Swift cryptographic library\nDependencies\nSwiftyDropbox (v10.2.4+): Official Dropbox Swift SDK\nMCP (swift-sdk): Model Context Protocol SDK\nCryptoKit: Apple's cryptographic framework\nrclone (optional): For bulk operations and backups (brew install rclone)\nSee Also\nDropbook GitHub\nCLAUDE.md - Full project documentation\nDropbox API Docs\nrclone Dropbox Docs - Bulk sync and backup\nRFC 7636 - PKCE\nRFC 9700 - OAuth 2.0 Security Best Practices"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/RyanLisse/dropbox",
    "publisherUrl": "https://clawhub.ai/RyanLisse/dropbox",
    "owner": "RyanLisse",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/dropbox",
    "downloadUrl": "https://openagent3.xyz/downloads/dropbox",
    "agentUrl": "https://openagent3.xyz/skills/dropbox/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dropbox/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dropbox/agent.md"
  }
}