Cloudinary自动化：AI自然语言指令管理媒体资源、文件夹与转换 | SkillsMDCloudinary自动化：AI自然语言指令管理媒体资源、文件夹与转换
Cloudinary Automation by composiohq/awesome-claude-skills
npx skills add https://github.com/composiohq/awesome-claude-skills --skill 'Cloudinary Automation'🇨🇳中文介绍
Cloudinary 自动化
通过自然语言自动化 Cloudinary 媒体管理工作流——创建文件夹、配置上传预设、查找资源、管理转换、搜索文件夹以及监控使用情况。
工具包文档： composio.dev/toolkits/cloudinary
设置
- 将 Rube MCP 服务器添加到您的环境：
https://rube.app/mcp
- 根据提示连接您的 Cloudinary 账户（通过 Composio 进行 API 密钥认证）
- 开始为 Cloudinary 自动化发出自然语言指令
核心工作流
1. 使用文件夹组织资源
创建文件夹结构来组织托管的图片、视频和原始文件。
工具： CLOUDINARY_CREATE_FOLDER
关键参数：
folder —— 新资源文件夹的完整路径（必需），例如 images/events/2023
支持工具：
CLOUDINARY_SEARCH_FOLDERS —— 使用类似 Lucene 的表达式按名称、路径或创建日期搜索文件夹
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
expression —— 搜索过滤器（例如 name:sample AND path:events）max_results —— 1-500 个结果（默认 50）sort_by —— 排序对象列表（例如 [{"created_at": "desc"}]）next_cursor —— 分页游标
CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER —— 列出特定文件夹内的资源
"在 Cloudinary 中创建一个名为 'marketing/campaigns/spring-2026' 的文件夹"
2. 配置上传预设
定义集中化的上传行为，包括目标文件夹、允许的格式、转换、标签和覆盖规则。
工具： CLOUDINARY_CREATE_UPLOAD_PRESET
name —— 预设名称（如果省略则自动生成）folder —— 上传的目标文件夹路径（例如 samples/）allowed_formats —— 逗号分隔的列表（例如 jpg,png,webp）tags —— 要应用的逗号分隔标签（例如 marketing,thumbnail）transformation —— 传入转换（例如 c_limit,w_500）eager —— 上传时要生成的急切转换（例如 c_fill,g_face,h_150,w_150）unsigned —— 允许无签名上传（true/false）overwrite —— 覆盖具有相同 public_id 的现有资源（当 unsigned=true 时不能为 true）resource_type —— image、video 或 raw（默认 image）unique_filename —— 附加随机后缀以避免冲突（默认 true）use_filename —— 使用原始文件名（默认 false）moderation —— 审核类型：manual、webpurify、aws_rek 等。auto_tagging —— AI 自动标记的置信度阈值 0.0-1.0notification_url —— 用于上传通知的 webhook URL
"创建一个名为 'product-images' 的上传预设，仅允许 JPG 和 PNG，存储在 'products/' 文件夹中，并以 0.7 的置信度进行自动标记"
3. 查找资源详情
通过公共 ID 检索特定资源的完整详情，包括元数据、衍生资源和相关资源。
工具： CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID
public_id —— 资源的公共 ID（必需）resource_type —— image、video 或 raw（必需）type —— 交付类型：upload、private、authenticated、fetch 等。（必需）colors —— 包含颜色直方图和主要颜色faces —— 包含检测到的人脸坐标media_metadata —— 包含 IPTC、XMP 和详细元数据quality_analysis —— 包含质量分析分数phash —— 包含用于相似性检测的感知哈希versions —— 包含备份版本related —— 包含相关资源max_results —— 要返回的最大衍生/相关资源数量（1-500）
"获取图片 'products/hero-banner' 的完整详情，包括颜色分析和质量分数"
4. 管理转换和衍生资源
列出现有转换，将急切转换应用于上传的资源，并清理衍生资源。
CLOUDINARY_GET_TRANSFORMATIONS —— 列出所有命名和未命名的转换
max_results —— 1-500（默认 10）next_cursor —— 分页游标
CLOUDINARY_EXPLICIT_RESOURCE —— 更新现有资源：预生成转换、更新元数据、移动到新文件夹或修改标签
public_id —— 目标资源（必需）eager —— 要预生成的转换字符串列表（例如 ["c_fill,w_300,h_200", "c_thumb,w_100,h_100,g_face"]）eager_async —— 异步生成转换tags —— 替换现有标签asset_folder —— 将资源移动到新文件夹display_name —— 设置显示名称context —— 键值元数据（例如 {"alt": "Mountain view"}）invalidate —— 使 CDN 缓存失效（最多需要 1 小时）
CLOUDINARY_DELETE_DERIVED_RESOURCES —— 按 ID 删除特定的衍生资源（每次调用最多 100 个）
"为资源 'products/hero-banner' 预生成一个 300x200 的填充裁剪和一个 100x100 的人脸检测缩略图"
5. 监控使用情况和配置
CLOUDINARY_GET_USAGE —— 监控存储、带宽、请求和配额限制CLOUDINARY_GET_CONFIG —— 获取环境配置详情
settings —— 设置为 true 以包含配置设置，如 folder_mode
CLOUDINARY_GET_TAGS —— 列出资源类型的所有标签
"显示我的 Cloudinary 账户使用情况和剩余配额"
6. 设置 Webhook 触发器
为特定的 Cloudinary 事件创建 webhook 通知。
工具： CLOUDINARY_CREATE_TRIGGER
用于在上传完成、转换完成或其他事件发生时接收回调。
已知陷阱
| 陷阱 | 详情 |
|---|
| 文件夹创建幂等性 | 如果路径已存在，CLOUDINARY_CREATE_FOLDER 可能会报错或无操作——请设计幂等的文件夹命名 |
| 预设与上传对齐 | 上传预设选项如 allowed_formats、folder 和 unsigned 必须与实际的上传方法匹配，否则上传将被拒绝 |
| 严格的资源查找 | 如果 resource_type、type 或 public_id 中任何一项不正确，即使资源存在，CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID 也会失败 |
| 文件夹路径敏感性 | CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER 仅列出指定确切文件夹中的资源；拼写错误会返回空结果 |
| 配额阻塞 | CLOUDINARY_GET_USAGE 反映账户级别的限制——达到上限会静默阻止上传，直到检查并处理使用情况 |
| CDN 失效延迟 | 在 CLOUDINARY_EXPLICIT_RESOURCE 上设置 invalidate=true 最多需要 1 小时才能传播 |
| 无签名与覆盖冲突 | 在上传预设中，当 unsigned=true 时不能设置 overwrite=true |
快速参考
| 操作 | 工具标识 | 关键参数 |
|---|
| 创建文件夹 | CLOUDINARY_CREATE_FOLDER | folder |
| 搜索文件夹 | CLOUDINARY_SEARCH_FOLDERS | expression, max_results |
| 列出文件夹资源 | CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER | 文件夹路径 |
| 创建上传预设 | CLOUDINARY_CREATE_UPLOAD_PRESET | name, folder, allowed_formats, tags |
| 获取资源详情 | CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID | public_id, resource_type, type |
| 列出转换 | CLOUDINARY_GET_TRANSFORMATIONS | max_results, next_cursor |
| 更新/转换资源 | CLOUDINARY_EXPLICIT_RESOURCE | public_id, eager, tags |
| 删除衍生资源 | CLOUDINARY_DELETE_DERIVED_RESOURCES | derived_resource_ids |
| 获取使用情况 | CLOUDINARY_GET_USAGE | （无） |
| 获取配置 | CLOUDINARY_GET_CONFIG | settings |
| 列出标签 | CLOUDINARY_GET_TAGS | resource_type |
| 创建 webhook | CLOUDINARY_CREATE_TRIGGER | 事件类型, URL |
🇺🇸English
Cloudinary Automation
Automate Cloudinary media management workflows -- create folders, configure upload presets, look up assets, manage transformations, search folders, and monitor usage -- all through natural language.
Toolkit docs: composio.dev/toolkits/cloudinary
Setup
- Add the Rube MCP server to your environment:
https://rube.app/mcp
- Connect your Cloudinary account when prompted (API key auth via Composio)
- Start issuing natural language commands for Cloudinary automation
Core Workflows
1. Organize Assets with Folders
Create folder structures for organizing hosted images, videos, and raw files.
Tool: CLOUDINARY_CREATE_FOLDER
Key parameters:
folder -- full path of the new asset folder (required), e.g., images/events/2023
Supporting tools:
CLOUDINARY_SEARCH_FOLDERS -- search folders by name, path, or creation date using Lucene-like expressions
expression -- search filter (e.g., name:sample AND path:events)max_results -- 1-500 results (default 50)sort_by -- list of sort objects (e.g., [{"created_at": "desc"}])next_cursor -- pagination cursor
CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER -- list assets within a specific folder
Example prompt:
"Create a folder called 'marketing/campaigns/spring-2026' in Cloudinary"
2. Configure Upload Presets
Define centralized upload behavior including target folder, allowed formats, transformations, tags, and overwrite rules.
Tool: CLOUDINARY_CREATE_UPLOAD_PRESET
Key parameters:
name -- preset name (auto-generated if omitted)folder -- target folder path for uploads (e.g., samples/)allowed_formats -- comma-separated list (e.g., jpg,png,webp)tags -- comma-separated tags to apply (e.g., marketing,thumbnail)transformation -- incoming transformation (e.g., c_limit,w_500)eager -- eager transformations to generate on upload (e.g., )
Example prompt:
"Create an upload preset called 'product-images' that only allows JPG and PNG, stores in 'products/' folder, and auto-tags with 0.7 confidence"
3. Look Up Asset Details
Retrieve full details for a specific asset by its public ID, including metadata, derived assets, and related resources.
Tool: CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID
Key parameters:
public_id -- the asset's public ID (required)resource_type -- image, video, or raw (required)type -- delivery type: upload, private, authenticated, fetch, etc. (required)colors -- include color histogram and predominant colors
Example prompt:
"Get full details for the image 'products/hero-banner' including color analysis and quality scores"
4. Manage Transformations and Derived Assets
List existing transformations, apply eager transformations to uploaded assets, and clean up derived resources.
Tools:
CLOUDINARY_GET_TRANSFORMATIONS -- list all named and unnamed transformations
max_results -- 1-500 (default 10)next_cursor -- pagination cursor
CLOUDINARY_EXPLICIT_RESOURCE -- update an existing asset: pre-generate transformations, update metadata, move to new folders, or modify tags
public_id -- target asset (required)eager -- list of transformation strings to pre-generate (e.g., ["c_fill,w_300,h_200", "c_thumb,w_100,h_100,g_face"])eager_async -- generate transformations asynchronously- -- replace existing tags
Example prompt:
"Pre-generate a 300x200 fill crop and a 100x100 face-detection thumbnail for asset 'products/hero-banner'"
5. Monitor Usage and Configuration
Check account-level usage limits, environment configuration, and tag inventory.
Tools:
CLOUDINARY_GET_USAGE -- monitor storage, bandwidth, requests, and quota limitsCLOUDINARY_GET_CONFIG -- fetch environment config details
settings -- set to true to include configuration settings like folder_mode
CLOUDINARY_GET_TAGS -- list all tags for a resource type
Example prompt:
"Show me my Cloudinary account usage and remaining quota"
6. Set Up Webhook Triggers
Create webhook notifications for specific Cloudinary events.
Tool: CLOUDINARY_CREATE_TRIGGER
Use to receive callbacks when uploads complete, transformations finish, or other events occur.
Example prompt:
"Create a webhook trigger that notifies https://my-app.com/hook on upload events"
Known Pitfalls
| Pitfall | Details |
|---|
| Folder creation idempotency | CLOUDINARY_CREATE_FOLDER may error or no-op if the path already exists -- design idempotent folder naming |
| Preset-upload alignment | Upload preset options like allowed_formats, folder, and unsigned must match the actual upload method or uploads will be rejected |
| Strict asset lookup | CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID fails if any of resource_type, type, or public_id is incorrect, even when the asset exists |
Quick Reference
| Action | Tool Slug | Key Params |
|---|
| Create folder | CLOUDINARY_CREATE_FOLDER | folder |
| Search folders | CLOUDINARY_SEARCH_FOLDERS | expression, max_results |
| List folder assets | CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER | folder path |
| Create upload preset | |
Powered byComposio
Weekly Installs
0
Repository
composiohq/awes…e-skills
GitHub Stars
42.3K
First Seen
Jan 1, 1970
Security Audits
Gen Agent Trust HubFailSocketPassSnykPass
Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理
102,600 周安装
c_fill,g_face,h_150,w_150
unsigned -- allow unsigned uploads (true/false)overwrite -- overwrite existing assets with same public_id (cannot be true when unsigned=true)resource_type -- image, video, or raw (default image)unique_filename -- append random suffix to avoid collisions (default true)use_filename -- use original filename (default false)moderation -- moderation type: manual, webpurify, aws_rek, etc.auto_tagging -- confidence threshold 0.0-1.0 for AI auto-taggingnotification_url -- webhook URL for upload notificationsfaces -- include detected face coordinatesmedia_metadata -- include IPTC, XMP, and detailed metadataquality_analysis -- include quality analysis scoresphash -- include perceptual hash for similarity detectionversions -- include backed-up versionsrelated -- include related assetsmax_results -- max derived/related assets to return (1-500)tags
asset_folder -- move asset to a new folderdisplay_name -- set display namecontext -- key-value metadata (e.g., {"alt": "Mountain view"})invalidate -- invalidate CDN cache (takes up to 1 hour)CLOUDINARY_DELETE_DERIVED_RESOURCES -- delete specific derived assets by IDs (up to 100 per call)| Folder path sensitivity | CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER only lists assets in the exact folder specified; typos return empty results |
| Quota blocking | CLOUDINARY_GET_USAGE reflects account-level limits -- hitting caps silently blocks uploads until usage is checked and addressed |
| CDN invalidation delay | Setting invalidate=true on CLOUDINARY_EXPLICIT_RESOURCE takes up to 1 hour to propagate |
| Unsigned vs overwrite conflict | Cannot set overwrite=true when unsigned=true in upload presets |
CLOUDINARY_CREATE_UPLOAD_PRESET
name, folder, allowed_formats, tags |
| Get asset details | CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID | public_id, resource_type, type |
| List transformations | CLOUDINARY_GET_TRANSFORMATIONS | max_results, next_cursor |
| Update/transform asset | CLOUDINARY_EXPLICIT_RESOURCE | public_id, eager, tags |
| Delete derived assets | CLOUDINARY_DELETE_DERIVED_RESOURCES | derived_resource_ids |
| Get usage | CLOUDINARY_GET_USAGE | (none) |
| Get config | CLOUDINARY_GET_CONFIG | settings |
| List tags | CLOUDINARY_GET_TAGS | resource_type |
| Create webhook | CLOUDINARY_CREATE_TRIGGER | event type, URL |
