googlephotos-automation

Google Photos-Automatisierung per Rube MCP

Laden Sie Fotos hoch, verwalten Sie Alben, durchsuchen Sie Medieninhalte und organisieren Sie Inhalte in Google Photos mit Rube MCP (Composio) stapelweise.

Toolkit-Dokumentation: composio.dev/toolkits/googlephotos

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit dem Toolkit googlephotos
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Werkzeugschemata zu erhalten

Einrichtung

Rube MCP abrufen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – fügen Sie einfach den Endpunkt hinzu, und es funktioniert.

1. Überprüfen Sie, ob Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit dem Toolkit googlephotos auf
3. Wenn die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätigen Sie, dass der Verbindungsstatus AKTIV anzeigt, bevor Sie Workflows ausführen

Kern-Workflows

1. Alben auflisten

Verwenden Sie GOOGLEPHOTOS_LIST_ALBUMS, um alle im Tab „Alben" des Benutzers sichtbaren Alben abzurufen.

Tool: GOOGLEPHOTOS_LIST_ALBUMS
Parameter:
  - pageSize: Anzahl der Alben pro Seite
  - pageToken: Paginierungs-Token
  - excludeNonAppCreatedData: Nur von dieser App erstellte Alben anzeigen

2. Ein neues Album erstellen

Verwenden Sie GOOGLEPHOTOS_CREATE_ALBUM, um ein neues Album in Google Photos zu erstellen.

Tool: GOOGLEPHOTOS_CREATE_ALBUM
Parameter:
  - title (erforderlich): Albumtitel

3. Medien hochladen

Verwenden Sie GOOGLEPHOTOS_UPLOAD_MEDIA, um eine Bild- oder Videodatei in Google Photos hochzuladen.

Tool: GOOGLEPHOTOS_UPLOAD_MEDIA
Parameter:
  - file_to_upload: Lokaler Dateipfad zum Hochladen
  - url: URL der hochzuladenden Datei (Alternative zu file_to_upload)
  - file_name: Name für die hochgeladene Datei
  - description: Beschreibung/Bildunterschrift für das Medienelement

4. Stapelweise hochladen und Medienelemente erstellen

Verwenden Sie GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS, um mehrere Dateien hochzuladen und in einem Vorgang Medienelemente zu erstellen.

Tool: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS
Parameter:
  - files: Lokale Dateipfade zum Hochladen
  - urls: URLs hochzuladender Dateien
  - media_files: Gemischte Eingabe (Dateien und URLs)
  - albumId: Album, dem Elemente hinzugefügt werden sollen
  - albumPosition: Position innerhalb des Albums

5. Medienelemente durchsuchen

Verwenden Sie GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS, um die Fotobibliothek des Benutzers mit Filtern zu durchsuchen.

Tool: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS
Parameter:
  - albumId: Nach Album filtern
  - filters: Suchfilter (Datumsbereiche, Inhaltskategorien, Medientypen)
  - orderBy: Sortierreihenfolge
  - pageSize: Ergebnisse pro Seite
  - pageToken: Paginierungs-Token

6. Elemente zu einem Album hinzufügen

Verwenden Sie GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS, um vorhandene Medienelemente zu einem Album hinzuzufügen.

Tool: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS
Parameter:
  - albumId (erforderlich): Ziel-Album-ID
  - mediaItemIds (erforderlich): Array der hinzuzufügenden Medienelement-IDs

Häufige Muster

• Album erstellen und dann hochladen: Verwenden Sie GOOGLEPHOTOS_CREATE_ALBUM, um ein Album zu erstellen, und dann GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS mit der Album-ID, um Fotos in einem Schritt hochzuladen und zu organisieren.
• Auflisten und dann organisieren: Verwenden Sie GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS oder GOOGLEPHOTOS_LIST_MEDIA_ITEMS, um Medienelement-IDs zu finden, und dann GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS, um sie Alben hinzuzufügen.
• Album-Metadaten aktualisieren: Verwenden Sie GOOGLEPHOTOS_UPDATE_ALBUM, um den Titel oder das Titelbild eines Albums zu ändern.
• Album-Details abrufen: Verwenden Sie GOOGLEPHOTOS_GET_ALBUM mit einer Album-ID, um vollständige Album-Informationen abzurufen.
• Anreicherungen hinzufügen: Verwenden Sie GOOGLEPHOTOS_ADD_ENRICHMENT, um Texteinblendungen, Standorte oder Kartenanreicherungen zu Album-Positionen hinzuzufügen.
• Von URLs hochladen: Verwenden Sie den Parameter url in GOOGLEPHOTOS_UPLOAD_MEDIA oder urls in GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS, um Bilder direkt von Web-URLs hochzuladen.

Bekannte Fallstricke

• GOOGLEPHOTOS_LIST_MEDIA_ITEMS ist veraltet – bevorzugen Sie GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS zum Auflisten und Filtern von Medien.
• GOOGLEPHOTOS_UPLOAD_MEDIA unterstützt Bilder bis zu 200 MB und Videos bis zu einer größeren Grenze. Überschreitung führt zu Fehlern.
• Album-IDs müssen aus den Antworten von GOOGLEPHOTOS_LIST_ALBUMS oder GOOGLEPHOTOS_CREATE_ALBUM bezogen werden – es sind undurchsichtige Zeichenfolgen.
• GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS kann Elemente nur zu Alben hinzufügen, die von der App erstellt wurden oder die der Benutzer besitzt.
• Der Parameter filters in GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS verwendet eine spezifische Google Photos-API-Filterstruktur – konsultieren Sie das Schema für Datumsbereiche und Formate von Inhaltskategorien.
• Über die API erstellte Medienelemente erscheinen aufgrund von Verarbeitungsverzögerungen möglicherweise nicht sofort in der Google Photos-Weboberfläche.

Kurzreferenz

Aktion	Werkzeug	Wichtige Parameter
Alben auflisten	GOOGLEPHOTOS_LIST_ALBUMS	pageSize, pageToken
Album erstellen	GOOGLEPHOTOS_CREATE_ALBUM	title
Album abrufen	GOOGLEPHOTOS_GET_ALBUM	albumId
Album aktualisieren	GOOGLEPHOTOS_UPDATE_ALBUM	albumId, title, coverPhotoMediaItemId
Medien hochladen	GOOGLEPHOTOS_UPLOAD_MEDIA	file_to_upload oder url, description
Stapelupload	GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS	files oder urls, albumId
Medien durchsuchen	GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS	albumId, filters, pageSize
Medienelemente auflisten	GOOGLEPHOTOS_LIST_MEDIA_ITEMS	pageSize, pageToken
Elemente zu Album hinzufügen	GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS	albumId, mediaItemIds
Anreicherung hinzufügen	GOOGLEPHOTOS_ADD_ENRICHMENT	albumId, newEnrichmentItem, albumPosition

---

Bereitgestellt von Composio