ComposioHQ/Cloudinary-Automation

Was macht Cloudinary-Automation?

Automatisieren Sie Cloudinary-Medienverwaltungs-Workflows – Ordner erstellen, Upload-Presets konfigurieren, Assets suchen, Transformationen verwalten, Ordner durchsuchen und die Nutzung überwachen – alles per natürlicher Sprache.

Toolkit-Dokumentation: composio.dev/toolkits/cloudinary

---

Einrichtung

1. Fügen Sie den Rube MCP-Server zu Ihrer Umgebung hinzu: https://rube.app/mcp
2. Verbinden Sie bei Aufforderung Ihr Cloudinary-Konto (API-Key-Authentifizierung über Composio)
3. Beginnen Sie, natürlichsprachliche Befehle für die Cloudinary-Automation zu geben

---

Kern-Workflows

1. Assets mit Ordnern organisieren

Ordnerstrukturen zur Organisation von gehosteten Bildern, Videos und Rohdateien erstellen.

Tool: CLOUDINARY_CREATE_FOLDER

Wichtige Parameter:

• folder – vollständiger Pfad des neuen Asset-Ordners (erforderlich), z. B. images/events/2023

Unterstützende Tools:

• CLOUDINARY_SEARCH_FOLDERS – Ordner nach Name, Pfad oder Erstellungsdatum durchsuchen mit Lucene-ähnlichen Ausdrücken
  • expression – Suchfilter (z. B. name:sample AND path:events)
  • max_results – 1–500 Ergebnisse (Standard 50)
  • sort_by – Liste von Sortierobjekten (z. B. [{"created_at": "desc"}])
  • next_cursor – Paginierungscursor
• CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER – Assets innerhalb eines bestimmten Ordners auflisten

Beispielaufforderung:

„Erstelle in Cloudinary einen Ordner namens 'marketing/kampagnen/fruehjahr-2026'“

---

2. Upload-Presets konfigurieren

Zentrales Upload-Verhalten definieren: Zielordner, erlaubte Formate, Transformationen, Tags und Überschreibregeln.

Tool: CLOUDINARY_CREATE_UPLOAD_PRESET

Wichtige Parameter:

• name – Preset-Name (wird automatisch generiert, wenn nicht angegeben)
• folder – Zielordner-Pfad für Uploads (z. B. samples/)
• allowed_formats – kommagetrennte Liste (z. B. jpg,png,webp)
• tags – kommagetrennte Tags zum Anwenden (z. B. marketing,thumbnail)
• transformation – eingehende Transformation (z. B. c_limit,w_500)
• eager – eager-Transformationen, die beim Upload generiert werden (z. B. c_fill,g_face,h_150,w_150)
• unsigned – nicht signierte Uploads erlauben (true/false)
• overwrite – vorhandene Assets mit derselben public_id überschreiben (darf nicht true sein, wenn unsigned=true)
• resource_type – image, video oder raw (Standard image)
• unique_filename – zufälliges Suffix anhängen, um Kollisionen zu vermeiden (Standard true)
• use_filename – ursprünglichen Dateinamen verwenden (Standard false)
• moderation – Moderationsart: manual, webpurify, aws_rek usw.
• auto_tagging – Konfidenzschwellwert 0,0–1,0 für KI-Auto-Tagging
• notification_url – Webhook-URL für Upload-Benachrichtigungen

Beispielaufforderung:

„Erstelle ein Upload-Preset namens 'produktbilder', das nur JPG und PNG erlaubt, im Ordner 'produkte/' speichert und mit einer Konfidenz von 0,7 automatisch taggt“

---

3. Asset-Details abrufen

Vollständige Details für ein bestimmtes Asset anhand seiner öffentlichen ID abrufen, einschließlich Metadaten, abgeleiteter Assets und zugehöriger Ressourcen.

Tool: CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID

Wichtige Parameter:

• public_id – die öffentliche ID des Assets (erforderlich)
• resource_type – image, video oder raw (erforderlich)
• type – Auslieferungstyp: upload, private, authenticated, fetch usw. (erforderlich)
• colors – Farbhistogramm und vorherrschende Farben einbeziehen
• faces – Koordinaten erkannter Gesichter einbeziehen
• media_metadata – IPTC-, XMP- und detaillierte Metadaten einbeziehen
• quality_analysis – Qualitätsanalysewerte einbeziehen
• phash – Perceptual Hash für Ähnlichkeitssuche einbeziehen
• versions – gesicherte Versionen einbeziehen
• related – zugehörige Assets einbeziehen
• max_results – maximale Anzahl zurückzugebender abgeleiteter/zugehöriger Assets (1–500)

Beispielaufforderung:

„Rufe vollständige Details für das Bild 'produkte/helden-banner' ab, inklusive Farbanalyse und Qualitätswerten“

---

4. Transformationen und abgeleitete Assets verwalten

Vorhandene Transformationen auflisten, eager-Transformationen auf hochgeladene Assets anwenden und abgeleitete Ressourcen bereinigen.

Tools:

• CLOUDINARY_GET_TRANSFORMATIONS – alle benannten und unbenannten Transformationen auflisten
  • max_results – 1–500 (Standard 10)
  • next_cursor – Paginierungscursor
• CLOUDINARY_EXPLICIT_RESOURCE – ein vorhandenes Asset aktualisieren: Transformationen vorab generieren, Metadaten aktualisieren, in neue Ordner verschieben oder Tags ändern
  • public_id – Ziel-Asset (erforderlich)
  • eager – Liste der vorab zu generierenden Transformationsstrings (z. B. ["c_fill,w_300,h_200", "c_thumb,w_100,h_100,g_face"])
  • eager_async – Transformationen asynchron generieren
  • tags – vorhandene Tags ersetzen
  • asset_folder – Asset in einen neuen Ordner verschieben
  • display_name – Anzeigenamen festlegen
  • context – Schlüssel-Wert-Metadaten (z. B. {"alt": "Bergblick"})
  • invalidate – CDN-Cache ungültig machen (kann bis zu 1 Stunde dauern)
• CLOUDINARY_DELETE_DERIVED_RESOURCES – bestimmte abgeleitete Assets anhand ihrer IDs löschen (bis zu 100 pro Aufruf)

Beispielaufforderung:

„Generiere für das Asset 'produkte/helden-banner' vorab einen 300x200 Fill-Crop und ein 100x100 Gesichtserkennungs-Thumbnail“

---

5. Nutzung und Konfiguration überwachen

Kontoweite Nutzungslimits, Umgebungskonfiguration und Tag-Inventar prüfen.

Tools:

• CLOUDINARY_GET_USAGE – Speicher, Bandbreite, Anfragen und Kontingentlimits überwachen
• CLOUDINARY_GET_CONFIG – Umgebungskonfigurationsdetails abrufen
  • settings – auf true setzen, um Konfigurationseinstellungen wie folder_mode einzuschließen
• CLOUDINARY_GET_TAGS – alle Tags für einen Ressourcentyp auflisten

Beispielaufforderung:

„Zeige mir meine Cloudinary-Kontonutzung und das verbleibende Kontingent“

---

6. Webhook-Trigger einrichten

Webhook-Benachrichtigungen für bestimmte Cloudinary-Ereignisse erstellen.

Tool: CLOUDINARY_CREATE_TRIGGER

Verwenden Sie es, um Rückrufe zu erhalten, wenn Uploads abgeschlossen sind, Transformationen beendet sind oder andere Ereignisse eintreten.

Beispielaufforderung:

„Erstelle einen Webhook-Trigger, der https://my-app.com/hook bei Upload-Ereignissen benachrichtigt“

---

Bekannte Fallstricke

Fallstrick	Details
Ordnererstellungs-Idempotenz	CLOUDINARY_CREATE_FOLDER kann einen Fehler auslösen oder nichts tun, wenn der Pfad bereits existiert – entwerfen Sie idempotente Ordnerbenennungen
Preset-Upload-Abstimmung	Upload-Preset-Optionen wie allowed_formats, folder und unsigned müssen mit der tatsächlichen Upload-Methode übereinstimmen, sonst werden Uploads abgelehnt
Strenge Asset-Suche	CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID schlägt fehl, wenn resource_type, type oder public_id falsch ist, selbst wenn das Asset existiert
Ordnerpfad-Empfindlichkeit	CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER listet nur Assets im exakt angegebenen Ordner auf; Tippfehler liefern leere Ergebnisse
Kontingentblockade	CLOUDINARY_GET_USAGE zeigt kontoweite Limits – das Erreichen von Obergrenzen blockiert Uploads stillschweigend, bis die Nutzung geprüft und behoben wird
CDN-Invalidierungsverzögerung	Das Setzen von invalidate=true bei CLOUDINARY_EXPLICIT_RESOURCE benötigt bis zu 1 Stunde zur Ausbreitung
Konflikt zwischen unsigniert und Überschreiben	overwrite=true kann nicht gesetzt werden, wenn unsigned=true in Upload-Presets

---

Kurzreferenz

Aktion	Tool-Slug	Wichtige Parameter
Ordner erstellen	CLOUDINARY_CREATE_FOLDER	folder
Ordner durchsuchen	CLOUDINARY_SEARCH_FOLDERS	expression, max_results
Ordner-Assets auflisten	CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER	Ordnerpfad
Upload-Preset erstellen	CLOUDINARY_CREATE_UPLOAD_PRESET	name, folder, allowed_formats, tags
Asset-Details abrufen	CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID	public_id, resource_type, type
Transformationen auflisten	CLOUDINARY_GET_TRANSFORMATIONS	max_results, next_cursor
Asset aktualisieren/transformieren	CLOUDINARY_EXPLICIT_RESOURCE	public_id, eager, tags
Abgeleitete Assets löschen	CLOUDINARY_DELETE_DERIVED_RESOURCES	derived_resource_ids
Nutzung abrufen	CLOUDINARY_GET_USAGE	(keine)
Konfiguration abrufen	CLOUDINARY_GET_CONFIG	settings
Tags auflisten	CLOUDINARY_GET_TAGS	resource_type
Webhook erstellen	CLOUDINARY_CREATE_TRIGGER	Ereignistyp, URL

---

Powered by Composio