Automação com Cloudinary

Automatize fluxos de trabalho de gerenciamento de mídia do Cloudinary -- crie pastas, configure predefinições de upload, consulte ativos, gerencie transformações, pesquise pastas e monitore o uso -- tudo através de linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/cloudinary

Configuração

1. Adicione o servidor Rube MCP ao seu ambiente: https://rube.app/mcp
2. Conecte sua conta Cloudinary quando solicitado (autenticação por chave de API via Composio)
3. Comece a emitir comandos em linguagem natural para automação do Cloudinary

Fluxos de Trabalho Principais

1. Organize Ativos com Pastas

Crie estruturas de pastas para organizar imagens, vídeos e arquivos brutos hospedados.

Ferramenta: CLOUDINARY_CREATE_FOLDER

Parâmetros principais:

• folder -- caminho completo da nova pasta de ativos (obrigatório), por exemplo, images/events/2023

Ferramentas de suporte:

• CLOUDINARY_SEARCH_FOLDERS -- pesquise pastas por nome, caminho ou data de criação usando expressões semelhantes a Lucene
  • expression -- filtro de pesquisa (por exemplo, name:sample AND path:events)
  • max_results -- 1-500 resultados (padrão 50)
  • sort_by -- lista de objetos de ordenação (por exemplo, [{"created_at": "desc"}])
  • next_cursor -- cursor de paginação
• CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER -- liste ativos dentro de uma pasta específica

Exemplo de prompt:

"Crie uma pasta chamada 'marketing/campanhas/primavera-2026' no Cloudinary"

2. Configure Predefinições de Upload

Defina o comportamento centralizado de upload, incluindo pasta de destino, formatos permitidos, transformações, tags e regras de substituição.

Ferramenta: CLOUDINARY_CREATE_UPLOAD_PRESET

Parâmetros principais:

• name -- nome da predefinição (gerado automaticamente se omitido)
• folder -- caminho da pasta de destino para uploads (por exemplo, samples/)
• allowed_formats -- lista separada por vírgulas (por exemplo, jpg,png,webp)
• tags -- tags separadas por vírgulas a serem aplicadas (por exemplo, marketing,thumbnail)
• transformation -- transformação de entrada (por exemplo, c_limit,w_500)
• eager -- transformações "eager" a serem geradas no upload (por exemplo, c_fill,g_face,h_150,w_150)
• unsigned -- permitir uploads não assinados (true/false)
• overwrite -- substitua ativos existentes com o mesmo public_id (não pode ser true quando unsigned=true)
• resource_type -- image, video, ou raw (padrão image)
• unique_filename -- anexe um sufixo aleatório para evitar colisões (padrão true)
• use_filename -- use o nome do arquivo original (padrão false)
• moderation -- tipo de moderação: manual, webpurify, aws_rek, etc.
• auto_tagging -- limite de confiança de 0.0 a 1.0 para auto-tagging por IA
• notification_url -- URL de webhook para notificações de upload

Exemplo de prompt:

"Crie uma predefinição de upload chamada 'imagens-de-produto' que permita apenas JPG e PNG, armazene na pasta 'produtos/', e aplique tags automaticamente com 0.7 de confiança"

3. Consulte Detalhes de Ativos

Recupere detalhes completos para um ativo específico pelo seu ID público, incluindo metadados, ativos derivados e recursos relacionados.

Ferramenta: CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID

Parâmetros principais:

• public_id -- o ID público do ativo (obrigatório)
• resource_type -- image, video, ou raw (obrigatório)
• type -- tipo de entrega: upload, private, authenticated, fetch, etc. (obrigatório)
• colors -- inclui histograma de cores e cores predominantes
• faces -- inclui coordenadas de rostos detectados
• media_metadata -- inclui metadados IPTC, XMP e detalhados
• quality_analysis -- inclui pontuações de análise de qualidade
• phash -- inclui hash perceptual para detecção de similaridade
• versions -- inclui versões de backup
• related -- inclui ativos relacionados
• max_results -- número máximo de ativos derivados/relacionados a retornar (1-500)

Exemplo de prompt:

"Obtenha detalhes completos para a imagem 'products/hero-banner' incluindo análise de cores e pontuações de qualidade"

4. Gerencie Transformações e Ativos Derivados

Liste transformações existentes, aplique transformações "eager" a ativos carregados e limpe recursos derivados.

Ferramentas:

• CLOUDINARY_GET_TRANSFORMATIONS -- liste todas as transformações nomeadas e não nomeadas
  • max_results -- 1-500 (padrão 10)
  • next_cursor -- cursor de paginação
• CLOUDINARY_EXPLICIT_RESOURCE -- atualize um ativo existente: pré-gere transformações, atualize metadados, mova para novas pastas ou modifique tags
  • public_id -- ativo de destino (obrigatório)
  • eager -- lista de strings de transformação para pré-gerar (por exemplo, ["c_fill,w_300,h_200", "c_thumb,w_100,h_100,g_face"])
  • eager_async -- gere transformações assincronamente
  • tags -- substitua tags existentes

…