Cloudinary Automation by composiohq/awesome-claude-skills
npx skills add https://github.com/composiohq/awesome-claude-skills --skill 'Cloudinary Automation'通过自然语言自动化 Cloudinary 媒体管理工作流——创建文件夹、配置上传预设、查找资源、管理转换、搜索文件夹以及监控使用情况。
工具包文档: composio.dev/toolkits/cloudinary
https://rube.app/mcp创建文件夹结构来组织托管的图片、视频和原始文件。
工具: 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' 的文件夹"
定义集中化的上传行为,包括目标文件夹、允许的格式、转换、标签和覆盖规则。
工具: 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 的置信度进行自动标记"
通过公共 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' 的完整详情,包括颜色分析和质量分数"
列出现有转换,将急切转换应用于上传的资源,并清理衍生资源。
工具:
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 的人脸检测缩略图"
检查账户级别的使用限制、环境配置和标签清单。
工具:
CLOUDINARY_GET_USAGE —— 监控存储、带宽、请求和配额限制CLOUDINARY_GET_CONFIG —— 获取环境配置详情
settings —— 设置为 true 以包含配置设置,如 folder_modeCLOUDINARY_GET_TAGS —— 列出资源类型的所有标签示例提示:
"显示我的 Cloudinary 账户使用情况和剩余配额"
为特定的 Cloudinary 事件创建 webhook 通知。
工具: CLOUDINARY_CREATE_TRIGGER
用于在上传完成、转换完成或其他事件发生时接收回调。
示例提示:
"创建一个 webhook 触发器,在上传事件时通知 https://my-app.com/hook"
| 陷阱 | 详情 |
|---|---|
| 文件夹创建幂等性 | 如果路径已存在,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 |
由 Composio 提供支持
每周安装
0
代码仓库
GitHub 星标
42.3K
首次出现
Jan 1, 1970
安全审计
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
https://rube.app/mcpCreate 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/2023Supporting 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 cursorCLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER -- list assets within a specific folderExample prompt:
"Create a folder called 'marketing/campaigns/spring-2026' in Cloudinary"
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"
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 colorsExample prompt:
"Get full details for the image 'products/hero-banner' including color analysis and quality scores"
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 cursorCLOUDINARY_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 asynchronouslyExample prompt:
"Pre-generate a 300x200 fill crop and a 100x100 face-detection thumbnail for asset 'products/hero-banner'"
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_modeCLOUDINARY_GET_TAGS -- list all tags for a resource typeExample prompt:
"Show me my Cloudinary account usage and remaining quota"
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"
| 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 |
| 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
GitHub Stars
42.3K
First Seen
Jan 1, 1970
Security Audits
Azure Data Explorer (Kusto) 查询技能:KQL数据分析、日志遥测与时间序列处理
102,600 周安装
c_fill,g_face,h_150,w_150unsigned -- 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)tagsasset_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_PRESETname, 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 |