ComposioHQ/Uploadcare-Automation

Was macht Uploadcare-Automation?

Automatisieren Sie Uploadcare-Dateiverwaltungs-Workflows – listen Sie Projektdateien auf, speichern Sie Uploads dauerhaft, rufen Sie Dateimetadaten ab, erhalten Sie Download-URLs und verwalten Sie Dateigruppen – alles über natürliche Sprache.

Toolkit-Dokumentation: composio.dev/toolkits/uploadcare

---

Einrichtung

1. Fügen Sie den Rube MCP-Server zu Ihrer Umgebung hinzu: https://rube.app/mcp
2. Verbinden Sie Ihr Uploadcare-Konto, wenn Sie dazu aufgefordert werden (API-Schlüssel-Authentifizierung über Composio)
3. Beginnen Sie, natürliche Sprachbefehle für die Uploadcare-Automation zu geben

---

Kern-Workflows

1. Projektdateien auflisten

Durchsuchen Sie hochgeladene Dateien in Ihrem Uploadcare-Projekt mit Filterung, Sortierung und Paginierung.

Tool: UPLOADCARE_LIST_FILES

Wichtige Parameter:

• stored – Filter nach Speicherstatus: "true" für gespeichert, "false" für ungespeichert
• removed – Filter nach Entfernungsstatus: "true" für entfernt, "false" für aktiv
• ordering – Sortierung: datetime_uploaded (aufsteigend) oder -datetime_uploaded (absteigend)
• limit – Dateien pro Seite, 1–1000 (Standard: 100)
• offset – Nullbasierter Paginierungs-Offset
• from_date – ISO-8601-Zeitstempel, um Dateien zu filtern, die nach diesem Datum hochgeladen wurden
• to_date – ISO-8601-Zeitstempel, um Dateien zu filtern, die vor diesem Datum hochgeladen wurden
• include – Setzen Sie "total", um die Gesamtzahl der Dateien in der Antwort einzuschließen

Beispiel-Eingabeaufforderung:

„Liste die 50 zuletzt hochgeladenen, gespeicherten Dateien in meinem Uploadcare-Projekt auf“

---

2. Eine Datei dauerhaft speichern

Markieren Sie eine hochgeladene Datei als dauerhaft gespeichert. Standardmäßig sind Uploadcare-Dateien temporär und werden nach 24 Stunden gelöscht, sofern sie nicht gespeichert werden.

Tool: UPLOADCARE_STORE_FILE

Wichtige Parameter:

• uuid – UUID der zu speichernden Datei (erforderlich); muss im Format 8-4-4-4-12 Hex vorliegen (z. B. 3e55317b-23d1-4f35-9b4c-b9accb7b53f4)

Speichern Sie Dateien immer nach dem Upload, um eine automatische Löschung zu verhindern.

Beispiel-Eingabeaufforderung:

„Speichere die Datei mit der UUID 3e55317b-23d1-4f35-9b4c-b9accb7b53f4 dauerhaft“

---

3. Dateimetadaten abrufen

Rufen Sie detaillierte Informationen zu einer bestimmten Datei ab, einschließlich Größe, MIME-Typ, CDN-URL, Bildabmessungen und mehr.

Tool: UPLOADCARE_GET_FILE_INFO

Wichtige Parameter:

• uuid – die UUID der zu untersuchenden Datei (erforderlich); Format: 8-4-4-4-12 Hex

Rückgabe: Dateiname, Größe, MIME-Typ, CDN-URL, Upload-Datum, Speicherstatus, Bildinformationen (Abmessungen, Farbmodus) und mehr.

Beispiel-Eingabeaufforderung:

„Hole die Metadaten und Abmessungen für die Datei 3e0923f2-e05a-4b37-9f0d-343b981c9d70“

---

4. Einen temporären Download-Link abrufen

Rufen Sie einen temporären Direkt-Download-Link für eine bestimmte Datei ab.

Tool: UPLOADCARE_GET_FILE_DOWNLOAD_URL

Wichtige Parameter:

• file_id – die eindeutige Dateikennung (erforderlich)

Gibt eine zeitlich begrenzte URL zurück, die für einen direkten Datei-Download verwendet werden kann.

Beispiel-Eingabeaufforderung:

„Erhalte einen Download-Link für die Datei 3e0923f2-e05a-4b37-9f0d-343b981c9d70“

---

5. Dateigruppen durchsuchen

Listen Sie Dateigruppen in Ihrem Projekt auf. Gruppen sind Sammlungen von Dateien, die gemeinsam hochgeladen wurden.

Tool: UPLOADCARE_LIST_GROUPS

Wichtige Parameter:

• limit – Gruppen pro Seite, 1–1000 (Standard: 20)
• offset – Nullbasierter Paginierungs-Offset (Standard: 0)
• ordering – Sortierung: datetime_created (aufsteigend) oder -datetime_created (absteigend)

Beispiel-Eingabeaufforderung:

„Liste meine 10 neuesten Dateigruppen auf“

---

6. Datei-Lebenszyklus-Workflow

Kombinieren Sie Tools für eine durchgängige Dateiverwaltung:

1. Hochladen: Dateien werden über die Uploadcare-Upload-API oder das Widget hochgeladen (außerhalb dieses Toolkits)
2. Speichern: UPLOADCARE_STORE_FILE – Dateien als dauerhaft markieren, um automatische Löschung zu verhindern
3. Inspizieren: UPLOADCARE_GET_FILE_INFO – Metadaten prüfen, Abmessungen und MIME-Typ überprüfen
4. Teilen: UPLOADCARE_GET_FILE_DOWNLOAD_URL – einen temporären Download-Link generieren
5. Durchsuchen: UPLOADCARE_LIST_FILES – alle Dateien mit Status- und Datumsfiltern prüfen
6. Gruppen: UPLOADCARE_LIST_GROUPS – Batch-Uploads überprüfen

Beispiel-Eingabeaufforderung:

„Speichere die Datei abc-123 und hole dann ihre Metadaten und einen Download-Link“

---

Bekannte Fallstricke

Fallstrick	Details
Automatische Löschung ungespeicherter Dateien	Hochgeladene Dateien sind standardmäßig temporär und werden nach 24 Stunden gelöscht – rufen Sie immer UPLOADCARE_STORE_FILE auf, um sie zu erhalten
Strenge UUID-Formate	Datei-UUIDs müssen das exakte Format 8-4-4-4-12 Hex haben (z. B. 3e55317b-23d1-4f35-9b4c-b9accb7b53f4); ungültige Formate werden abgelehnt
Filterwerte sind Zeichenketten	Die Parameter stored und removed akzeptieren die Zeichenketten "true" oder "false", keine booleschen Werte
Temporäre Download-URLs	URLs von UPLOADCARE_GET_FILE_DOWNLOAD_URL sind zeitlich begrenzt und laufen ab
Paginierung erfolgt offset-basiert	Verwenden Sie offset + limit für die Paginierung; es gibt keine cursor-basierten Paginierungs-Token
Kein Upload-Tool	Datei-Uploads erfolgen über die Uploadcare-Upload-API oder das Widget, nicht über dieses Toolkit – diese Tools verwalten bereits hochgeladene Dateien

---

Kurzreferenz

Aktion	Tool-Slug	Wichtige Parameter
Dateien auflisten	UPLOADCARE_LIST_FILES	stored, ordering, limit, offset
Datei speichern	UPLOADCARE_STORE_FILE	uuid
Dateiinfo abrufen	UPLOADCARE_GET_FILE_INFO	uuid
Download-URL abrufen	UPLOADCARE_GET_FILE_DOWNLOAD_URL	file_id
Gruppen auflisten	UPLOADCARE_LIST_GROUPS	limit, offset, ordering

---

Bereitgestellt von Composio