Spotify MCP Node Server

searchSpotify

• Descripción: Buscar pistas, álbumes, artistas o listas de reproducción en Spotify
• Parámetros:
  • query (string): El término de búsqueda
  • type (string): Tipo de elemento a buscar (track, album, artist, playlist)
  • limit (number, opcional): Número máximo de resultados a devolver (10-50)
• Devuelve: Lista de elementos coincidentes con sus IDs, nombres y detalles adicionales
• Ejemplo: searchSpotify("bohemian rhapsody", "track", 20)

getNowPlaying

• Descripción: Obtener información sobre la pista que se está reproduciendo actualmente en Spotify
• Parámetros: Ninguno
• Devuelve: Objeto que contiene nombre de la pista, artista, álbum, progreso de reproducción, duración y estado de reproducción
• Ejemplo: getNowPlaying()

getUserPlaylists

• Descripción: Obtener una lista de las listas de reproducción del usuario actual en Spotify
• Parámetros:
  • limit (number, opcional): Número máximo de listas de reproducción a devolver (predeterminado: 20)
  • offset (number, opcional): Índice de la primera lista de reproducción a devolver (predeterminado: 0)
• Devuelve: Matriz de listas de reproducción con sus IDs, nombres, recuentos de pistas y estado público
• Ejemplo: getUserPlaylists(10, 0)

getPlaylistTracks

• Descripción: Obtener una lista de pistas en una lista de reproducción específica de Spotify
• Parámetros:
  • playlistId (string): El ID de Spotify de la lista de reproducción
  • limit (number, opcional): Número máximo de pistas a devolver (predeterminado: 100)
  • offset (number, opcional): Índice de la primera pista a devolver (predeterminado: 0)
• Devuelve: Matriz de pistas con sus IDs, nombres, artistas, álbum, duración y fecha de adición
• Ejemplo: getPlaylistTracks("37i9dQZEVXcJZyENOWUFo7")

getRecentlyPlayed

• Descripción: Recupera una lista de pistas reproducidas recientemente de Spotify.
• Parámetros:
  • limit (number, opcional): Un número que especifica el número máximo de pistas a devolver.
• Devuelve: Si se encuentran pistas, devuelve una lista formateada de pistas reproducidas recientemente; de lo contrario, un mensaje que indica: "No tienes pistas reproducidas recientemente en Spotify".
• Ejemplo: getRecentlyPlayed({ limit: 10 })

getRecentlyPlayed

• Descripción: Recupera una lista de pistas reproducidas recientemente de Spotify.
• Parámetros:
  • limit (number, opcional): Un número que especifica el número máximo de pistas a devolver.
• Devuelve: Si se encuentran pistas, devuelve una lista formateada de pistas reproducidas recientemente; de lo contrario, un mensaje que indica: "No tienes pistas reproducidas recientemente en Spotify".
• Ejemplo: getRecentlyPlayed({ limit: 10 })

getFollowedArtists

• Descripción: Recupera una lista de artistas que el usuario sigue en Spotify.
• Parámetros:
  • after (string, opcional): El último ID de artista de la solicitud anterior. Cursor para la paginación.
  • limit (number, opcional): Número máximo de artistas a devolver (1-50).
• Devuelve: Si se encuentran artistas, devuelve una lista formateada de artistas seguidos; de lo contrario, un mensaje que indica: "No sigues a ningún artista en Spotify".
• Ejemplo: getFollowedArtists({ limit: 10 })

getUserTopItems

• Descripción: Recupera una lista de los artistas o pistas principales del usuario.
• Parámetros:
  • type (string): El tipo de elementos para obtener los principales. Debe ser "artists" o "tracks".
  • time_range (string): El rango de tiempo para los elementos principales. Debe ser "short_term", "medium_term" o "long_term".
  • limit (number, opcional): Número máximo de elementos a devolver (1-50).
  • offset (number, opcional): Índice del primer elemento a devolver. El valor predeterminado es 0.
• Devuelve: Si se encuentran elementos, devuelve una lista formateada de elementos principales; de lo contrario, un mensaje que indica: "No tienes elementos principales en Spotify".
• Ejemplo: getUserTopItems({ type: "artists", time_range: "short_term", limit: 10 })

playMusic

• Descripción: Iniciar la reproducción de una pista, álbum, artista o lista de reproducción en Spotify
• Parámetros:
  • uri (string, opcional): URI de Spotify del elemento a reproducir (anula tipo e id)
  • type (string, opcional): Tipo de elemento a reproducir (track, album, artist, playlist)
  • id (string, opcional): ID de Spotify del elemento a reproducir
  • deviceId (string, opcional): ID del dispositivo en el que reproducir
• Devuelve: Estado de éxito
• Ejemplo: playMusic({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
• Alternativa: playMusic({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })

pausePlayback

• Descripción: Pausar la pista que se está reproduciendo actualmente en Spotify
• Parámetros:
  • deviceId (string, opcional): ID del dispositivo a pausar
• Devuelve: Estado de éxito
• Ejemplo: pausePlayback()

skipToNext

• Descripción: Saltar a la siguiente pista en la cola de reproducción actual
• Parámetros:
  • deviceId (string, opcional): ID del dispositivo
• Devuelve: Estado de éxito
• Ejemplo: skipToNext()

skipToPrevious

• Descripción: Saltar a la pista anterior en la cola de reproducción actual
• Parámetros:
  • deviceId (string, opcional): ID del dispositivo
• Devuelve: Estado de éxito
• Ejemplo: skipToPrevious()

createPlaylist

• Descripción: Crear una nueva lista de reproducción en Spotify
• Parámetros:
  • name (string): Nombre de la nueva lista de reproducción
  • description (string, opcional): Descripción de la lista de reproducción
  • public (boolean, opcional): Si la lista de reproducción debe ser pública (predeterminado: false)
• Devuelve: Objeto con el ID y la URL de la nueva lista de reproducción
• Ejemplo: createPlaylist({ name: "Workout Mix", description: "Songs to get pumped up", public: false })

addTracksToPlaylist

• Descripción: Añadir pistas a una lista de reproducción existente de Spotify
• Parámetros:
  • playlistId (string): ID de la lista de reproducción
  • trackUris (array): Matriz de URIs o IDs de pistas a añadir
  • position (number, opcional): Posición para insertar pistas
• Devuelve: Estado de éxito e ID de instantánea
• Ejemplo: addTracksToPlaylist({ playlistId: "3cEYpjA9oz9GiPac4AsH4n", trackUris: ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh"] })

addToQueue

• Descripción: Añade una pista, álbum, artista o lista de reproducción a la cola de reproducción actual
• • Parámetros:
  • uri (string, opcional): URI de Spotify del elemento a añadir a la cola (anula tipo e id)
  • type (string, opcional): Tipo de elemento a poner en cola (track, album, artist, playlist)
  • id (string, opcional): ID de Spotify del elemento a poner en cola
  • deviceId (string, opcional): ID del dispositivo en el que poner en cola
• Devuelve: Estado de éxito
• Ejemplo: addToQueue({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
• Alternativa: addToQueue({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })