Cloudinary Otomasyonu

Cloudinary medya yönetimi iş akışlarını otomatikleştirin -- klasörler oluşturun, yükleme ön ayarlarını yapılandırın, varlıkları arayın, dönüşümleri yönetin, klasörlerde arama yapın ve kullanımı izleyin -- hepsi doğal dil aracılığıyla.

Toolkit dokümentasyonu: composio.dev/toolkits/cloudinary

---

Kurulum

1. Rube MCP sunucusunu ortamınıza ekleyin: https://rube.app/mcp
2. İstendiğinde Cloudinary hesabınızı bağlayın (Composio aracılığıyla API anahtarı doğrulaması)
3. Cloudinary otomasyonu için doğal dil komutları vermeye başlayın

---

Temel İş Akışları

1. Varlıkları Klasörlerle Düzenleyin

Barındırılan görselleri, videoları ve ham dosyaları düzenlemek için klasör yapıları oluşturun.

Tool: CLOUDINARY_CREATE_FOLDER

Temel parametreler:

• folder -- yeni varlık klasörünün tam yolu (gerekli), örneğin: images/events/2023

Yardımcı araçlar:

• CLOUDINARY_SEARCH_FOLDERS -- Lucene benzeri ifadeler kullanarak klasörleri ad, yol veya oluşturulma tarihine göre arayın
  • expression -- arama filtresi (örneğin: name:sample AND path:events)
  • max_results -- 1-500 sonuç (varsayılan 50)
  • sort_by -- sıralama nesneleri listesi (örneğin: [{"created_at": "desc"}])
  • next_cursor -- sayfalama imleci
• CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER -- belirli bir klasör içindeki varlıkları listeleyin

Örnek komut:

"Cloudinary'de 'marketing/campaigns/spring-2026' adlı bir klasör oluştur"

---

2. Yükleme Ön Ayarlarını Yapılandırın

Hedef klasör, izin verilen formatlar, dönüşümler, etiketler ve üzerine yazma kuralları dahil olmak üzere merkezi yükleme davranışını tanımlayın.

Tool: CLOUDINARY_CREATE_UPLOAD_PRESET

Temel parametreler:

• name -- ön ayar adı (atlanırsa otomatik olarak oluşturulur)
• folder -- yüklenmeler için hedef klasör yolu (örneğin: samples/)
• allowed_formats -- virgülle ayrılmış liste (örneğin: jpg,png,webp)
• tags -- uygulanacak virgülle ayrılmış etiketler (örneğin: marketing,thumbnail)
• transformation -- gelen dönüşüm (örneğin: c_limit,w_500)
• eager -- yüklemede oluşturulacak eager dönüşümleri (örneğin: c_fill,g_face,h_150,w_150)
• unsigned -- imzasız yüklemelere izin ver (true/false)
• overwrite -- aynı public_id'ye sahip mevcut varlıkların üzerine yaz (unsigned=true olduğunda true olamaz)
• resource_type -- image, video veya raw (varsayılan image)
• unique_filename -- çarpışmaları önlemek için rastgele sonek ekle (varsayılan true)
• use_filename -- orijinal dosya adını kullan (varsayılan false)
• moderation -- moderasyon türü: manual, webpurify, aws_rek, vb.
• auto_tagging -- AI otomatik etiketlemesi için 0.0-1.0 güven eşiği
• notification_url -- yükleme bildirimleri için webhook URL'si

Örnek komut:

"Yalnızca JPG ve PNG'ye izin veren, 'products/' klasöründe depolayan ve 0.7 güvenle otomatik etiketleyen 'product-images' adlı bir yükleme ön ayarı oluştur"

---

3. Varlık Ayrıntılarını Arayın

Public ID'sine göre belirli bir varlığın tam ayrıntılarını alın; meta veriler, türetilmiş varlıklar ve ilgili kaynaklar dahil.

Tool: CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID

Temel parametreler:

• public_id -- varlığın public ID'si (gerekli)
• resource_type -- image, video veya raw (gerekli)
• type -- teslim türü: upload, private, authenticated, fetch, vb. (gerekli)
• colors -- renk histogramı ve baskın renkler dahil et
• faces -- algılanan yüz koordinatları dahil et
• media_metadata -- IPTC, XMP ve ayrıntılı meta veriler dahil et
• quality_analysis -- kalite analizi puanları dahil et
• phash -- benzerlik algılaması için algısal hash dahil et
• versions -- yedeklenmiş sürümler dahil et
• related -- ilgili varlıklar dahil et
• max_results -- döndürülecek maksimum türetilmiş/ilgili varlıklar (1-500)

Örnek komut:

"Renk analizi ve kalite puanları dahil olmak üzere 'products/hero-banner' görüntüsü için tam ayrıntıları al"

---

4. Dönüşümleri ve Türetilmiş Varlıkları Yönetin

Mevcut dönüşümleri listeleyin, yüklenen varlıklara eager dönüşümleri uygulayın ve türetilmiş kaynakları temizleyin.

Araçlar:

• CLOUDINARY_GET_TRANSFORMATIONS -- tüm adlandırılmış ve adlandırılmamış dönüşümleri listeleyin
  • max_results -- 1-500 (varsayılan 10)
  • next_cursor -- sayfalama imleci
• CLOUDINARY_EXPLICIT_RESOURCE -- mevcut bir varlığı güncelleyin: dönüşümleri ön oluşturun, meta verileri güncelleyin, yeni klasörlere taşıyın veya etiketleri değiştirin
  • public_id -- hedef varlık (gerekli)
  • eager -- ön oluşturulacak dönüşüm dizgileri listesi (örneğin: ["c_fill,w_300,h_200", "c_thumb,w_100,h_100,g_face"])
  • eager_async -- dönüşümleri asenkron olarak oluştur
  • tags -- mevcut etiketlerin yerine koymak
  • asset_folder -- varlığı yeni bir klasöre taşı
  • display_name -- görünen adı ayarla
  • context -- anahtar-değer meta verileri (örneğin: {"alt": "Mountain view"})
  • invalidate -- CDN önbelleğini geçersiz kıl (1 saate kadar sürer)
• CLOUDINARY_DELETE_DERIVED_RESOURCES -- belirli türetilmiş varlıkları ID'lerine göre silin (çağrı başına 100'e kadar)

Örnek komut:

"'products/hero-banner' varlığı için 300x200 fill crop ve 100x100 yüz algılama küçük resmini ön oluştur"

---

5. Kullanımı ve Yapılandırmayı İzleyin

Hesap düzeyinde kullanım limitlerini, ortam yapılandırmasını ve etiket envanterini kontrol edin.

Araçlar:

• CLOUDINARY_GET_USAGE -- depolama, bant genişliği, istekler ve kota limitlerini izleyin
• CLOUDINARY_GET_CONFIG -- ortam yapılandırması ayrıntılarını getirin
  • settings -- folder_mode gibi yapılandırma ayarlarını içermesi için true olarak ayarlayın
• CLOUDINARY_GET_TAGS -- bir kaynak türü için tüm etiketleri listeleyin

Örnek komut:

"Cloudinary hesap kullanımımı ve kalan kotamı göster"

---

6. Webhook Tetikleyicilerini Ayarlayın

Belirli Cloudinary olayları için webhook bildirimleri oluşturun.

Tool: CLOUDINARY_CREATE_TRIGGER

Yüklemeler tamamlandığında, dönüşümler bittiğinde veya diğer olaylar gerçekleştiğinde geri çağrılar almak için kullanın.

Örnek komut:

"Yükleme olaylarında https://my-app.com/hook adresine bildirim gönderen bir webhook tetikleyicisi oluştur"

---

Bilinen Sorunlar

Sorun	Ayrıntılar
Klasör oluşturma eşgüçlülüğü	CLOUDINARY_CREATE_FOLDER yol zaten varsa hata verebilir veya hiçbir işlem yapmayabilir -- eşgüçlü klasör adlandırması tasarlayın
Ön ayar-yükleme uyumu	allowed_formats, folder ve unsigned gibi yükleme ön ayarı seçenekleri gerçek yükleme yöntemiyle eşleşmeli yoksa yüklemeler reddedilecektir
Katı varlık araması	CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID varlık var olsa bile resource_type, type veya public_id herhangi biri yanlışsa başarısız olur
Klasör yolu hassasiyeti	CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER yalnızca belirtilen tam klasördeki varlıkları listeler; yazım hataları boş sonuçlar döndürür
Kota engelleme	CLOUDINARY_GET_USAGE hesap düzeyinde limitleri yansıtır -- kapları vurmak kullanım kontrol edilip giderilene kadar yüklemeleri sessizce engeller
CDN geçersiz kılma gecikmesi	CLOUDINARY_EXPLICIT_RESOURCE üzerinde invalidate=true ayarlamak 1 saaya kadar yayılması için zaman alır
İmzasız vs üzerine yazma çatışması	Yükleme ön ayarlarında unsigned=true olduğunda overwrite=true ayarlanamaz

---

Hızlı Referans

İşlem	Tool Slug	Temel Parametreler
Klasör oluştur	CLOUDINARY_CREATE_FOLDER	folder
Klasörlerde ara	CLOUDINARY_SEARCH_FOLDERS	expression, max_results
Klasör varlıklarını listele	CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER	klasör yolu
Yükleme ön ayarı oluştur	CLOUDINARY_CREATE_UPLOAD_PRESET	name, folder, allowed_formats, tags
Varlık ayrıntılarını al	CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID	public_id, resource_type, type
Dönüşümleri listele	CLOUDINARY_GET_TRANSFORMATIONS	max_results, next_cursor
Varlığı güncelle/dönüştür	CLOUDINARY_EXPLICIT_RESOURCE	public_id, eager, tags
Türetilmiş varlıkları sil	CLOUDINARY_DELETE_DERIVED_RESOURCES	derived_resource_ids
Kullanımı al	CLOUDINARY_GET_USAGE	(yok)
Yapılandırmayı al	CLOUDINARY_GET_CONFIG	settings
Etiketleri listele	CLOUDINARY_GET_TAGS	resource_type
Webhook oluştur	CLOUDINARY_CREATE_TRIGGER	olay türü, URL

---

Composio tarafından desteklenmektedir