用途
Uploadcare Automation 用于通过自然语言指令自动化 Uploadcare 项目中的文件管理工作，把原本需要在控制台或代码中完成的操作转化为对话式命令。它面向已使用 Uploadcare 存储与分发文件的开发者或运营人员，帮助完成文件审计、持久化、信息查询和链接生成等日常任务。
主要能力
列出项目文件：使用 UPLOADCARE_LIST_FILES 浏览已上传文件，支持按存储状态（stored 为 "true"/"false"）、移除状态（removed）、上传时间范围（from_date、to_date，ISO 8601）过滤，按 datetime_uploaded 升序或降序排序，通过 limit（1-1000，默认 100）与 offset 分页，并可设置 include="total" 返回文件总数。
永久存储文件：使用 UPLOADCARE_STORE_FILE 将文件标记为永久存储，防止临时文件被自动删除。参数 uuid 必填，须为 8-4-4-4-12 十六进制格式。
查询文件元数据：使用 UPLOADCARE_GET_FILE_INFO 获取指定文件的文件名、大小、MIME 类型、CDN URL、上传日期、存储状态及图片信息（尺寸、色彩模式）等。
获取临时下载链接：使用 UPLOADCARE_GET_FILE_DOWNLOAD_URL，传入 file_id，返回有时效的直接下载地址。
浏览文件组：使用 UPLOADCARE_LIST_GROUPS 查看批量上传形成的文件组集合，支持 limit（1-1000，默认 20）、offset、按 datetime_created 排序。
组合生命周期工作流：可将存储、查询元数据、生成下载链接、按状态与日期审计文件、查看批量上传组等步骤串联，用一条自然语言指令完成多步操作。
使用方式
- 在环境中添加 Rube MCP 服务器：https://rube.app/mcp
- 按提示连接 Uploadcare 账号（通过 Composio 进行 API key 认证）
- 用自然语言下达 Uploadcare 自动化指令
工具包文档：composio.dev/toolkits/uploadcare
示例指令包括：列出最近上传的 50 个已存储文件；永久存储指定 UUID 的文件；获取某文件的元数据与尺寸；获取某文件的下载链接；列出最近 10 个文件组；先存储文件再获取其元数据与下载链接。
适用场景
- 定期审计项目中的临时与已存储文件，按时间与状态筛选
- 上传后批量将重要文件转为永久存储，避免 24 小时自动删除
- 快速核对文件的 MIME 类型、尺寸等属性
- 为文件临时生成可分享的下载地址
- 查看批量上传产生的文件组记录
限制与注意事项
- 未存储文件会自动删除：默认情况下上传文件为临时文件，24 小时后删除，需调用存储工具持久化。
- UUID 格式严格：必须为 8-4-4-4-12 十六进制格式，否则会被拒绝。
- 过滤参数为字符串：stored 与 removed 接受 "true" 或 "false" 字符串，而非布尔值。
- 下载链接有时效：生成的下载 URL 会过期。
- 分页为偏移式：使用 offset + limit，没有游标分页令牌。
- 不含上传工具：文件上传需通过 Uploadcare 的上传 API 或组件完成，本工具集仅管理已上传文件。
快速参考
| 操作 | 工具标识 | 关键参数 |
|---|---|---|
| 列出文件 | UPLOADCARE_LIST_FILES | stored、ordering、limit、offset |
| 永久存储 | UPLOADCARE_STORE_FILE | uuid |
| 查询元数据 | UPLOADCARE_GET_FILE_INFO | uuid |
| 获取下载链接 | UPLOADCARE_GET_FILE_DOWNLOAD_URL | file_id |
| 列出文件组 | UPLOADCARE_LIST_GROUPS | limit、offset、ordering |