ComposioHQ/Spotify-Automation

Was macht Spotify-Automation?

Automatisiere Spotify-Operationen – verwalte Playlists, durchsuche den Musikkatalog, steuere die Wiedergabe, durchstöbere Alben und Tracks und greife auf Benutzerprofile zu – alles orchestriert über die Composio MCP-Integration.

Toolkit-Dokumentation: composio.dev/toolkits/spotify

---

Einrichtung

1. Verbinde dein Spotify-Konto über den Composio MCP-Server unter https://rube.app/mcp
2. Der Agent fordert dich mit einem Authentifizierungslink auf, falls keine aktive Verbindung besteht
3. Sobald die Verbindung hergestellt ist, stehen alle SPOTIFY_*-Tools zur Ausführung bereit
4. Hinweis: Einige Funktionen (Wiedergabesteuerung) erfordern ein Spotify Premium-Abonnement

---

Kern-Workflows

1. Aktuelles Benutzerprofil abrufen

Rufe umfassende Profilinformationen für den authentifizierten Spotify-Benutzer ab.

Tool: SPOTIFY_GET_CURRENT_USER_S_PROFILE

Keine Parameter erforderlich.
Gibt zurück: Anzeigename, E-Mail, Land, Abonnementstufe (premium/free),
Einstellungen für explizite Inhalte, Profilbilder, Followeranzahl und Spotify-URIs.
Erforderliche Bereiche: user-read-private, user-read-email.

---

2. Spotify-Katalog durchsuchen

Finde Alben, Künstler, Playlists, Tracks, Shows, Episoden oder Hörbücher per Stichwort.

Tool: SPOTIFY_SEARCH_FOR_ITEM

Parameter	Typ	Erforderlich	Beschreibung
q	string	Ja	Suchbegriffe
type	array	Ja	Elementtypen: album, artist, playlist, track, show, episode, audiobook
limit	integer	Nein	Anzahl der zurückzugebenden Ergebnisse (Standard: 20)
offset	integer	Nein	Offset für Paginierung (Standard: 0)
market	string	Nein	ISO 3166-1 alpha-2 Ländercode
include_external	string	Nein	Auf audio setzen, um externe Inhalte einzuschließen

Hinweis: Hörbücher sind nur in den USA, Großbritannien, Kanada, Irland, Neuseeland und Australien verfügbar.

---

3. Playlists verwalten

Durchstöbere, erstelle, ändere und befülle Playlists.

Playlists eines Benutzers abrufen:

Tool: SPOTIFY_GET_USER_S_PLAYLISTS

Parameter	Typ	Erforderlich	Beschreibung
user_id	string	Ja	Spotify-Benutzer-ID
limit	integer	Nein	Max. Playlists, 1-50 (Standard: 20)
offset	integer	Nein	Paginierungs-Offset, 0-100000 (Standard: 0)

Playlists des aktuellen Benutzers abrufen:

Tool: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS

Parameter	Typ	Erforderlich	Beschreibung
limit	integer	Nein	Max. Playlists, 1-50 (Standard: 20)
offset	integer	Nein	Paginierungs-Offset, 0-100000 (Standard: 0)

Playlist-Details abrufen:

Tool: SPOTIFY_GET_PLAYLIST

Parameter	Typ	Erforderlich	Beschreibung
playlist_id	string	Ja	Spotify-Playlist-ID (z. B. 3cEYpjA9oz9GiPac4AsH4n)
fields	string	Nein	Kommagetrennter Feld-Filter, um die Antwortgröße zu reduzieren
market	string	Nein	ISO-Ländercode für marktspezifische Inhalte
additional_types	string	Nein	track,episode, um Podcast-Episoden einzuschließen

Playlist-Details aktualisieren:

Tool: SPOTIFY_CHANGE_PLAYLIST_DETAILS

Parameter	Typ	Erforderlich	Beschreibung
playlist_id	string	Ja	Playlist-ID (muss dem aktuellen Benutzer gehören)
name	string	Nein	Neuer Playlist-Name
description	string	Nein	Neue Playlist-Beschreibung
public	boolean	Nein	Öffentlich/privat umschalten
collaborative	boolean	Nein	Kollaborativer Modus (nur bei nicht-öffentlichen Playlists)

---

4. Playlist-Elemente durchsuchen & Tracks hinzufügen

Zeige Tracks in einer Playlist an und füge neue Elemente hinzu.

Tool: SPOTIFY_GET_PLAYLIST_ITEMS

Parameter	Typ	Erforderlich	Beschreibung
playlist_id	string	Ja	Spotify-Playlist-ID
limit	integer	Nein	Elemente pro Seite, 1-50 (Standard: 20)
offset	integer	Nein	Paginierungs-Offset (Standard: 0)
fields	string	Nein	Feld-Filter (z. B. items(track(name,id)))
market	string	Nein	ISO-Ländercode
additional_types	string	Nein	track,episode für Podcast-Episoden

Tool: SPOTIFY_ADD_ITEMS_TO_PLAYLIST

Füge Tracks oder Episoden zu einer Playlist hinzu, indem du Spotify-URIs verwendest.

---

5. Track- & Album-Details abrufen

Rufe Kataloginformationen für einzelne Tracks und Alben ab.

Tool: SPOTIFY_GET_TRACK – Rufe Details für einen einzelnen Track anhand der Spotify-ID ab.

Tool: SPOTIFY_GET_ALBUM – Rufe umfassende Albumdaten ab, einschließlich Trackliste, Künstlerinfo, Cover-Art und Beliebtheit.

---

6. Wiedergabe steuern

Starte, setze fort oder ändere die Wiedergabe auf dem aktiven Gerät des Benutzers.

Tool: SPOTIFY_START_RESUME_PLAYBACK

Parameter	Typ	Erforderlich	Beschreibung
context_uri	string	Nein	Spotify-URI von Album, Künstler oder Playlist (kann nicht mit uris kombiniert werden)
uris	array	Nein	Liste von Track-URIs zur Wiedergabe (kann nicht mit context_uri kombiniert werden)
offset	object	Nein	Startposition: {position: 5} oder {uri: 'spotify:track:...'}
position_ms	integer	Nein	Startposition in Millisekunden
device_id	string	Nein	Zielgeräte-ID (Standard: aktives Gerät)

Anforderungen: Spotify Premium-Abonnement und mindestens ein aktives Gerät.

---

Bekannte Fallstricke

Fallstrick	Details
Premium für Wiedergabe erforderlich	SPOTIFY_START_RESUME_PLAYBACK gibt 403 zurück, wenn der Benutzer kein Spotify Premium hat
Aktives Gerät erforderlich	Die Wiedergabesteuerung gibt 404 zurück, wenn kein Spotify-Gerät (Handy, Desktop, Web, Lautsprecher) aktiv ist
context_uri vs uris schließen sich aus	context_uri und uris können nicht im selben Wiedergabeaufruf verwendet werden
Kollaborative Playlists	collaborative kann nur auf true gesetzt werden, wenn die Playlist nicht öffentlich ist (public muss false sein)
Playlist-Besitz	SPOTIFY_CHANGE_PLAYLIST_DETAILS funktioniert nur bei Playlists, die dem authentifizierten Benutzer gehören
Marktbeschränkungen für Hörbücher	Hörbücher über die Suche sind nur in den USA, Großbritannien, Kanada, Irland, Neuseeland und Australien verfügbar
Maximal 11000 Playlists	Benutzer sind auf etwa 11.000 Playlists über SPOTIFY_CREATE_PLAYLIST beschränkt

---

Kurzreferenz

Tool-Slug	Zweck
SPOTIFY_GET_CURRENT_USER_S_PROFILE	Profil des authentifizierten Benutzers abrufen
SPOTIFY_SEARCH_FOR_ITEM	Katalog nach Tracks, Alben, Künstlern usw. durchsuchen
SPOTIFY_GET_USER_S_PLAYLISTS	Playlists eines beliebigen Benutzers abrufen
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS	Playlists des aktuellen Benutzers abrufen
SPOTIFY_GET_PLAYLIST	Detaillierte Playlist-Informationen abrufen
SPOTIFY_GET_PLAYLIST_ITEMS	Tracks/Episoden in einer Playlist auflisten
SPOTIFY_CHANGE_PLAYLIST_DETAILS	Playlist-Name, -Beschreibung, -Sichtbarkeit aktualisieren
SPOTIFY_CREATE_PLAYLIST	Eine neue Playlist erstellen
SPOTIFY_ADD_ITEMS_TO_PLAYLIST	Tracks/Episoden zu einer Playlist hinzufügen
SPOTIFY_GET_TRACK	Track-Details nach ID abrufen
SPOTIFY_GET_ALBUM	Album-Details nach ID abrufen
SPOTIFY_START_RESUME_PLAYBACK	Wiedergabe auf einem Gerät starten oder fortsetzen

---

Powered by Composio