Spotify

Busca música, gestiona listas de reproducción, controla la reproducción y accede a tu biblioteca

Instrucciones de uso

Integra Spotify en tu flujo de trabajo. Busca canciones, álbumes, artistas y listas de reproducción. Gestiona listas de reproducción, accede a tu biblioteca, controla la reproducción, explora podcasts y audiolibros.

Herramientas

`spotify_search`

Busca canciones, álbumes, artistas o listas de reproducción en Spotify. Devuelve resultados coincidentes basados en la consulta.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`query`	string	Sí	Consulta de búsqueda (p. ej., "Bohemian Rhapsody", "artist:Queen", "genre:rock")
`type`	string	No	Tipo de resultados: track, album, artist, playlist, o separados por comas (p. ej., "track,artist")
`limit`	number	No	Número máximo de resultados a devolver (1-50)
`offset`	number	No	Índice del primer resultado a devolver para paginación
`market`	string	No	Código de país ISO 3166-1 alpha-2 para filtrar resultados (p. ej., "US", "GB")

Salida

Parámetro	Tipo	Descripción
`tracks`	array	Lista de canciones coincidentes

`spotify_get_track`

Obtén información detallada sobre una canción específica en Spotify mediante su ID.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`trackId`	string	Sí	El ID de Spotify de la canción
`market`	string	No	Código de país ISO 3166-1 alpha-2 para disponibilidad de la canción

Salida

Parámetro	Tipo	Descripción
`id`	string	ID de pista de Spotify
`name`	string	Nombre de la pista
`artists`	array	Lista de artistas
`album`	object	Información del álbum
`duration_ms`	number	Duración de la pista en milisegundos
`explicit`	boolean	Si la pista tiene contenido explícito
`popularity`	number	Puntuación de popularidad (0-100)
`preview_url`	string	URL para vista previa de 30 segundos
`external_url`	string	URL de Spotify
`uri`	string	URI de Spotify para la pista

`spotify_get_tracks`

Obtén información detallada sobre múltiples pistas en Spotify por sus IDs (hasta 50).

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`trackIds`	string	Sí	Lista de IDs de pistas de Spotify separadas por comas (máx. 50)
`market`	string	No	Código de país ISO 3166-1 alpha-2 para disponibilidad de pistas

Salida

Parámetro	Tipo	Descripción
`tracks`	array	Lista de pistas

`spotify_get_album`

Obtén información detallada sobre un álbum en Spotify por su ID, incluyendo el listado de pistas.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`albumId`	string	Sí	El ID de Spotify del álbum
`market`	string	No	Código de país ISO 3166-1 alpha-2 para disponibilidad de pistas

Salida

Parámetro	Tipo	Descripción
`id`	string	ID del álbum de Spotify
`name`	string	Nombre del álbum
`artists`	array	Lista de artistas
`album_type`	string	Tipo de álbum (álbum, sencillo, compilación)
`total_tracks`	number	Número total de pistas
`release_date`	string	Fecha de lanzamiento
`label`	string	Sello discográfico
`popularity`	number	Puntuación de popularidad (0-100)
`genres`	array	Lista de géneros
`image_url`	string	URL de la imagen de portada del álbum
`tracks`	array	Lista de pistas del álbum
`external_url`	string	URL de Spotify

`spotify_get_albums`

Obtener detalles de múltiples álbumes por sus IDs.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`albumIds`	string	Sí	IDs de álbumes separados por comas (máx. 20)
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`albums`	json	Lista de álbumes

`spotify_get_album_tracks`

Obtener las pistas de un álbum.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`albumId`	string	Sí	El ID del álbum de Spotify
`limit`	number	No	Número de pistas a devolver (1-50)
`offset`	number	No	Índice de la primera pista a devolver

Salida

Parámetro	Tipo	Descripción
`tracks`	json	Lista de pistas
`total`	number	Número total de pistas
`next`	string	URL para la siguiente página

`spotify_get_saved_albums`

Obtener el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número de álbumes a devolver (1-50)
`offset`	number	No	Índice del primer álbum a devolver
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`albums`	json	Lista de álbumes guardados
`total`	number	Total de álbumes guardados
`next`	string	URL para la siguiente página

`spotify_save_albums`

Guardar álbumes para el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`albumIds`	string	Sí	IDs de álbumes separados por comas (máx. 20)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los álbumes fueron guardados

`spotify_remove_saved_albums`

Eliminar álbumes del usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`albumIds`	string	Sí	IDs de álbumes separados por comas (máx. 20)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si los álbumes fueron eliminados

`spotify_check_saved_albums`

Comprobar si los álbumes están guardados en la biblioteca.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`albumIds`	string	Sí	IDs de álbumes separados por comas (máximo 20)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de booleanos para cada álbum

`spotify_get_artist`

Obtener información detallada sobre un artista en Spotify mediante su ID.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`artistId`	string	Sí	El ID de Spotify del artista

Salida

Parámetro	Tipo	Descripción
`id`	string	ID del artista en Spotify
`name`	string	Nombre del artista
`genres`	array	Lista de géneros asociados con el artista
`popularity`	number	Puntuación de popularidad (0-100)
`followers`	number	Número de seguidores
`image_url`	string	URL de la imagen del artista
`external_url`	string	URL de Spotify

`spotify_get_artists`

Obtener detalles de múltiples artistas mediante sus IDs.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`artistIds`	string	Sí	IDs de artistas separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`artists`	json	Lista de artistas

`spotify_get_artist_albums`

Obtener álbumes de un artista en Spotify. Puede filtrar por tipo de álbum.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`artistId`	string	Sí	El ID de Spotify del artista
`include_groups`	string	No	Filtrar por tipo de álbum: album, single, appears_on, compilation (separados por comas)
`limit`	number	No	Número máximo de álbumes a devolver (1-50)
`offset`	number	No	Índice del primer álbum a devolver
`market`	string	No	Código de país ISO 3166-1 alpha-2

Salida

Parámetro	Tipo	Descripción
`albums`	array	Artista

`spotify_get_artist_top_tracks`

Obtener las 10 canciones más populares de un artista en Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`artistId`	string	Sí	El ID de Spotify del artista
`market`	string	No	Código de país ISO 3166-1 alpha-2 (obligatorio para este endpoint)

Salida

Parámetro	Tipo	Descripción
`tracks`	array	Artista

`spotify_follow_artists`

Seguir a uno o más artistas.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`artistIds`	string	Sí	IDs de artistas separados por comas para seguir (máx. 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los artistas fueron seguidos con éxito

`spotify_unfollow_artists`

Dejar de seguir a uno o más artistas.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`artistIds`	string	Sí	IDs de artistas separados por comas para dejar de seguir (máx. 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si se dejó de seguir a los artistas con éxito

`spotify_get_followed_artists`

Obtener el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número de artistas a devolver (1-50)
`after`	string	No	Cursor para paginación (último ID de artista de la solicitud anterior)

Salida

Parámetro	Tipo	Descripción
`artists`	json	Lista de artistas seguidos
`total`	number	Número total de artistas seguidos
`next`	string	Cursor para la siguiente página

`spotify_check_following`

Comprobar si el usuario sigue a artistas o usuarios.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`type`	string	Sí	Tipo a comprobar: "artist" o "user"
`ids`	string	Sí	IDs de artistas o usuarios separados por comas (máx. 50)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de booleanos para cada ID

`spotify_get_show`

Obtener detalles de un podcast.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`showId`	string	Sí	El ID del show de Spotify
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`id`	string	ID del show
`name`	string	Nombre del show
`description`	string	Descripción del show
`publisher`	string	Nombre del editor
`total_episodes`	number	Total de episodios
`explicit`	boolean	Contiene contenido explícito
`languages`	json	Idiomas
`image_url`	string	URL de la imagen de portada
`external_url`	string	URL de Spotify

`spotify_get_shows`

Obtener detalles de múltiples podcasts.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`showIds`	string	Sí	IDs de shows separados por comas (máx. 50)
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`shows`	json	Lista de shows

`spotify_get_show_episodes`

Obtener episodios de un programa de podcast.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`showId`	string	Sí	El ID del programa de Spotify
`limit`	number	No	Número de episodios a devolver (1-50)
`offset`	number	No	Índice del primer episodio a devolver
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`episodes`	json	Lista de episodios
`total`	number	Total de episodios
`next`	string	URL para la siguiente página

`spotify_get_saved_shows`

Obtener el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número de programas a devolver (1-50)
`offset`	number	No	Índice del primer programa a devolver

Salida

Parámetro	Tipo	Descripción
`shows`	json	Lista de programas guardados
`total`	number	Total de programas guardados
`next`	string	URL para la siguiente página

`spotify_save_shows`

Guardar programas de podcast para el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`showIds`	string	Sí	IDs de programas separados por comas (máx. 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los programas fueron guardados

`spotify_remove_saved_shows`

Eliminar programas de podcast del usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`showIds`	string	Sí	IDs de programas separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los programas fueron eliminados

`spotify_check_saved_shows`

Comprobar si los programas están guardados en la biblioteca.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`showIds`	string	Sí	IDs de programas separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de booleanos para cada programa

`spotify_get_episode`

Obtener detalles de un episodio de podcast.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`episodeId`	string	Sí	El ID del episodio de Spotify
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`id`	string	ID del episodio
`name`	string	Nombre del episodio
`description`	string	Descripción del episodio
`duration_ms`	number	Duración en ms
`release_date`	string	Fecha de lanzamiento
`explicit`	boolean	Contiene contenido explícito
`show`	json	Información del programa principal
`image_url`	string	URL de la imagen de portada
`external_url`	string	URL de Spotify

`spotify_get_episodes`

Obtener detalles de múltiples episodios de podcast.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`episodeIds`	string	Sí	IDs de episodios separados por comas (máx. 50)
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`episodes`	json	Lista de episodios

`spotify_get_saved_episodes`

Obtener el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número de episodios a devolver (1-50)
`offset`	number	No	Índice del primer episodio a devolver
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`episodes`	json	Lista de episodios guardados
`total`	number	Total de episodios guardados
`next`	string	URL para la siguiente página

`spotify_save_episodes`

Guardar episodios de podcast para el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`episodeIds`	string	Sí	IDs de episodios separados por comas (máx. 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los episodios fueron guardados

`spotify_remove_saved_episodes`

Eliminar episodios de podcast del usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`episodeIds`	string	Sí	IDs de episodios separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si los episodios fueron eliminados

`spotify_check_saved_episodes`

Comprobar si los episodios están guardados en la biblioteca.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`episodeIds`	string	Sí	IDs de episodios separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de booleanos para cada episodio

`spotify_get_audiobook`

Obtener detalles de un audiolibro.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`audiobookId`	string	Sí	El ID del audiolibro de Spotify
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`id`	string	ID del audiolibro
`name`	string	Nombre del audiolibro
`authors`	json	Autores
`narrators`	json	Narradores
`publisher`	string	Editorial
`description`	string	Descripción
`total_chapters`	number	Total de capítulos
`languages`	json	Idiomas
`image_url`	string	URL de la imagen de portada
`external_url`	string	URL de Spotify

`spotify_get_audiobooks`

Obtener detalles de múltiples audiolibros.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`audiobookIds`	string	Sí	IDs de audiolibros separados por comas (máx. 50)
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`audiobooks`	json	Lista de audiolibros

`spotify_get_audiobook_chapters`

Obtener capítulos de un audiolibro.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`audiobookId`	string	Sí	El ID del audiolibro de Spotify
`limit`	number	No	Número de capítulos a devolver (1-50)
`offset`	number	No	Índice del primer capítulo a devolver
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`chapters`	json	Lista de capítulos
`total`	number	Total de capítulos
`next`	string	URL para la siguiente página

`spotify_get_saved_audiobooks`

Obtener el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número de audiolibros a devolver (1-50)
`offset`	number	No	Índice del primer audiolibro a devolver

Salida

Parámetro	Tipo	Descripción
`audiobooks`	json	Lista de audiolibros guardados
`total`	number	Total de audiolibros guardados
`next`	string	URL para la siguiente página

`spotify_save_audiobooks`

Guardar audiolibros para el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`audiobookIds`	string	Sí	IDs de audiolibros separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los audiolibros fueron guardados

`spotify_remove_saved_audiobooks`

Eliminar audiolibros del usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`audiobookIds`	string	Sí	IDs de audiolibros separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si los audiolibros fueron eliminados

`spotify_check_saved_audiobooks`

Comprobar si los audiolibros están guardados en la biblioteca.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`audiobookIds`	string	Sí	IDs de audiolibros separados por comas (máximo 50)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de booleanos para cada audiolibro

`spotify_get_playlist`

Obtener información detallada sobre una lista de reproducción en Spotify por su ID.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de Spotify de la lista de reproducción
`market`	string	No	Código de país ISO 3166-1 alpha-2 para la disponibilidad de pistas

Salida

Parámetro	Tipo	Descripción
`id`	string	ID de la lista de reproducción de Spotify
`name`	string	Nombre de la lista de reproducción
`description`	string	Descripción de la lista de reproducción
`public`	boolean	Si la lista de reproducción es pública
`collaborative`	boolean	Si la lista de reproducción es colaborativa
`owner`	object	Información del propietario de la lista de reproducción
`image_url`	string	URL de la imagen de portada de la lista de reproducción
`total_tracks`	number	Número total de pistas
`snapshot_id`	string	ID de instantánea de la lista de reproducción para control de versiones
`external_url`	string	URL de Spotify

`spotify_get_playlist_tracks`

Obtener las pistas de una lista de reproducción de Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de Spotify de la lista de reproducción
`limit`	number	No	Número máximo de pistas a devolver (1-100)
`offset`	number	No	Índice de la primera pista a devolver
`market`	string	No	Código de país ISO 3166-1 alpha-2 para la disponibilidad de pistas

Salida

Parámetro	Tipo	Descripción
`tracks`	array	Lista de pistas en la lista de reproducción

`spotify_get_playlist_cover`

Obtener una lista de reproducción

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify

Salida

Parámetro	Tipo	Descripción
`images`	json	Lista de imágenes de portada

`spotify_get_user_playlists`

Obtener el usuario actual

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número máximo de listas de reproducción a devolver (1-50)
`offset`	number	No	Índice de la primera lista de reproducción a devolver

Salida

Parámetro	Tipo	Descripción
`playlists`	array	Usuario

`spotify_create_playlist`

Crear una nueva lista de reproducción para el usuario actual en Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`name`	string	Sí	Nombre para la nueva lista de reproducción
`description`	string	No	Descripción para la lista de reproducción
`public`	boolean	No	Si la lista de reproducción debe ser pública
`collaborative`	boolean	No	Si la lista de reproducción debe ser colaborativa (requiere que public sea false)

Salida

Parámetro	Tipo	Descripción
`id`	string	ID de la lista de reproducción de Spotify
`name`	string	Nombre de la lista de reproducción
`description`	string	Descripción de la lista de reproducción
`public`	boolean	Si la lista de reproducción es pública
`collaborative`	boolean	Si es colaborativa
`snapshot_id`	string	ID de instantánea de la lista de reproducción
`external_url`	string	URL de Spotify

`spotify_update_playlist`

Actualizar una lista de reproducción

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify
`name`	string	No	Nuevo nombre para la lista de reproducción
`description`	string	No	Nueva descripción para la lista de reproducción
`public`	boolean	No	Si la lista de reproducción debe ser pública

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si la actualización tuvo éxito

`spotify_add_playlist_cover`

Subir una imagen de portada personalizada para una lista de reproducción. La imagen debe ser JPEG y pesar menos de 256KB.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify
`imageBase64`	string	Sí	Imagen JPEG codificada en Base64 (máx. 256KB)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si la subida tuvo éxito

`spotify_add_tracks_to_playlist`

Añadir una o más pistas a una lista de reproducción de Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de Spotify de la lista de reproducción
`uris`	string	Sí	URIs de Spotify separadas por comas (p. ej., "spotify:track:xxx,spotify:track:yyy")
`position`	number	No	Posición para insertar pistas (base 0). Si se omite, las pistas se añaden al final.

Salida

Parámetro	Tipo	Descripción
`snapshot_id`	string	Nuevo ID de instantánea de la lista de reproducción después de la modificación

`spotify_remove_tracks_from_playlist`

Eliminar una o más pistas de una lista de reproducción de Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de Spotify de la lista de reproducción
`uris`	string	Sí	URIs de Spotify separadas por comas para eliminar (p. ej., "spotify:track:xxx,spotify:track:yyy")

Salida

Parámetro	Tipo	Descripción
`snapshot_id`	string	Nuevo ID de instantánea de la lista de reproducción después de la modificación

`spotify_reorder_playlist_items`

Mover pistas a una posición diferente en una lista de reproducción.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify
`range_start`	number	Sí	Índice inicial de los elementos a reordenar
`insert_before`	number	Sí	Índice donde insertar los elementos
`range_length`	number	No	Número de elementos a reordenar
`snapshot_id`	string	No	ID de instantánea de la lista de reproducción para control de concurrencia

Salida

Parámetro	Tipo	Descripción
`snapshot_id`	string	Nuevo ID de instantánea de la lista de reproducción

`spotify_replace_playlist_items`

Reemplazar todos los elementos en una lista de reproducción con nuevas pistas.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify
`uris`	string	Sí	URIs de Spotify separados por comas (máximo 100)

Salida

Parámetro	Tipo	Descripción
`snapshot_id`	string	Nuevo ID de instantánea de la lista de reproducción

`spotify_follow_playlist`

Seguir (guardar) una lista de reproducción.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify
`public`	boolean	No	Si la lista de reproducción estará en listas de reproducción públicas

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si el seguimiento tuvo éxito

`spotify_unfollow_playlist`

Dejar de seguir (eliminar) una lista de reproducción.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si dejar de seguir tuvo éxito

`spotify_check_playlist_followers`

Comprobar si los usuarios siguen una lista de reproducción.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`playlistId`	string	Sí	El ID de la lista de reproducción de Spotify
`userIds`	string	Sí	IDs de usuario separados por comas para verificar (máximo 5)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de booleanos para cada usuario

`spotify_get_current_user`

Obtener el usuario actual

Entrada

Parámetro	Tipo	Obligatorio	Descripción

Salida

Parámetro	Tipo	Descripción
`id`	string	ID de usuario de Spotify
`display_name`	string	Nombre visible
`email`	string	Dirección de correo electrónico
`country`	string	Código de país
`product`	string	Nivel de suscripción (gratuito, premium)
`followers`	number	Número de seguidores
`image_url`	string	URL de imagen de perfil
`external_url`	string	URL del perfil de Spotify

`spotify_get_user_profile`

Obtener un usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`userId`	string	Sí	El ID de usuario de Spotify

Salida

Parámetro	Tipo	Descripción
`id`	string	ID de usuario
`display_name`	string	Nombre visible
`followers`	number	Número de seguidores
`image_url`	string	URL de imagen de perfil
`external_url`	string	URL de Spotify

`spotify_get_top_tracks`

Obtener el usuario actual

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`time_range`	string	No	Rango de tiempo: short_term (~4 semanas), medium_term (~6 meses), long_term (años)
`limit`	number	No	Número de pistas a devolver (1-50)
`offset`	number	No	Índice de la primera pista a devolver

Salida

Parámetro	Tipo	Descripción
`tracks`	array	Usuario

`spotify_get_top_artists`

Obtener el usuario actual

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`time_range`	string	No	Rango de tiempo: short_term (~4 semanas), medium_term (~6 meses), long_term (años)
`limit`	number	No	Número de artistas a devolver (1-50)
`offset`	number	No	Índice del primer artista a devolver

Salida

Parámetro	Tipo	Descripción
`artists`	array	Usuario

`spotify_get_saved_tracks`

Obtener el usuario actual

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`limit`	number	No	Número de pistas a devolver (1-50)
`offset`	number	No	Índice de la primera pista a devolver
`market`	string	No	Código de país ISO 3166-1 alpha-2

Salida

Parámetro	Tipo	Descripción
`tracks`	array	Usuario

`spotify_save_tracks`

Guardar pistas para el usuario actual

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`trackIds`	string	Sí	IDs de pistas de Spotify separados por comas para guardar (máximo 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si las pistas se guardaron correctamente

`spotify_remove_saved_tracks`

Eliminar pistas del usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`trackIds`	string	Sí	IDs de pistas separados por comas para eliminar (máximo 50)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Si las pistas se eliminaron correctamente

`spotify_check_saved_tracks`

Comprobar si una o más pistas están guardadas en el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`trackIds`	string	Sí	IDs de pistas separados por comas para comprobar (máximo 50)

Salida

Parámetro	Tipo	Descripción
`results`	json	Array de IDs de pistas con estado de guardado
`all_saved`	boolean	Si todas las pistas están guardadas
`none_saved`	boolean	Si ninguna pista está guardada

`spotify_get_recently_played`

Obtener el usuario

Entrada

Parámetro	Tipo	Requerido	Descripción
`limit`	number	No	Número de pistas a devolver (1-50)
`after`	number	No	Marca de tiempo Unix en milisegundos. Devuelve elementos después de este cursor.
`before`	number	No	Marca de tiempo Unix en milisegundos. Devuelve elementos antes de este cursor.

Salida

Parámetro	Tipo	Descripción
`items`	array	Pistas reproducidas recientemente

`spotify_get_new_releases`

Obtener una lista de nuevos lanzamientos de álbumes destacados en Spotify.

Entrada

Parámetro	Tipo	Requerido	Descripción
`country`	string	No	Código de país ISO 3166-1 alpha-2 (p. ej., "US", "GB")
`limit`	number	No	Número de lanzamientos a devolver (1-50)
`offset`	number	No	Índice del primer lanzamiento a devolver

Salida

Parámetro	Tipo	Descripción
`albums`	json	Lista de nuevos lanzamientos
`total`	number	Número total de nuevos lanzamientos
`next`	string	URL para la siguiente página

`spotify_get_categories`

Obtener una lista de categorías de navegación utilizadas para etiquetar elementos en Spotify.

Entrada

Parámetro	Tipo	Requerido	Descripción
`country`	string	No	Código de país ISO 3166-1 alpha-2 (p. ej., "US", "GB")
`locale`	string	No	Código de localización (p. ej., "en_US", "es_MX")
`limit`	number	No	Número de categorías a devolver (1-50)

Salida

Parámetro	Tipo	Descripción
`categories`	json	Lista de categorías de navegación
`total`	number	Número total de categorías

`spotify_get_markets`

Obtener la lista de mercados donde Spotify está disponible.

Entrada

Parámetro	Tipo	Obligatorio	Descripción

Salida

Parámetro	Tipo	Descripción
`markets`	json	Lista de códigos de país ISO

`spotify_get_playback_state`

Obtener el estado actual de reproducción incluyendo dispositivo, pista y progreso.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`market`	string	No	Código de país ISO 3166-1 alpha-2

Salida

Parámetro	Tipo	Descripción
`is_playing`	boolean	Si la reproducción está activa
`device`	object	Información del dispositivo activo
`progress_ms`	number	Progreso en milisegundos
`currently_playing_type`	string	Tipo de contenido en reproducción
`shuffle_state`	boolean	Si el modo aleatorio está activado
`repeat_state`	string	Modo de repetición (off, track, context)
`track`	object	Pista en reproducción actual

`spotify_get_currently_playing`

Obtener el usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`market`	string	No	Código de país ISO para el mercado

Salida

Parámetro	Tipo	Descripción
`is_playing`	boolean	Si la reproducción está activa
`progress_ms`	number	Posición actual en la pista (ms)
`track`	json	Pista reproduciéndose actualmente

`spotify_get_devices`

Obtener el usuario

Entrada

Parámetro	Tipo	Requerido	Descripción

Salida

Parámetro	Tipo	Descripción
`devices`	array	Dispositivos de reproducción disponibles

`spotify_get_queue`

Obtener el usuario

Entrada

Parámetro	Tipo	Requerido	Descripción

Salida

Parámetro	Tipo	Descripción
`currently_playing`	json	Pista reproduciéndose actualmente
`queue`	json	Próximas pistas en la cola

`spotify_play`

Iniciar o reanudar la reproducción en Spotify. Puede reproducir pistas, álbumes o listas de reproducción específicas.

Entrada

Parámetro	Tipo	Requerido	Descripción
`device_id`	string	No	ID del dispositivo para reproducir. Si no se proporciona, reproduce en el dispositivo activo.
`context_uri`	string	No	URI de Spotify del álbum, artista o lista de reproducción a reproducir (p. ej., "spotify:album:xxx")
`uris`	string	No	URIs de pistas separadas por comas para reproducir (p. ej., "spotify:track:xxx,spotify:track:yyy")
`offset`	number	No	Posición en el contexto para comenzar a reproducir (índice basado en 0)
`position_ms`	number	No	Posición en la pista para comenzar (en milisegundos)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si la reproducción comenzó correctamente

`spotify_pause`

Pausar la reproducción en Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`device_id`	string	No	ID del dispositivo para pausar. Si no se proporciona, pausa el dispositivo activo.

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si la reproducción fue pausada

`spotify_skip_next`

Saltar a la siguiente pista en Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`device_id`	string	No	ID del dispositivo. Si no se proporciona, usa el dispositivo activo.

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si el salto fue exitoso

`spotify_skip_previous`

Saltar a la pista anterior en Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`device_id`	string	No	ID del dispositivo. Si no se proporciona, usa el dispositivo activo.

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si el salto fue exitoso

`spotify_seek`

Buscar una posición en la pista que se está reproduciendo actualmente.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`position_ms`	number	Sí	Posición en milisegundos a la que desplazarse
`device_id`	string	No	ID del dispositivo objetivo

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si el desplazamiento fue exitoso

`spotify_add_to_queue`

Añadir una pista al usuario

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`uri`	string	Sí	URI de Spotify de la pista a añadir (p. ej., "spotify:track:xxx")
`device_id`	string	No	ID del dispositivo. Si no se proporciona, usa el dispositivo activo.

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si la pista fue añadida a la cola

`spotify_set_volume`

Establecer el volumen de reproducción en Spotify.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`volume_percent`	number	Sí	Nivel de volumen (0 a 100)
`device_id`	string	No	ID del dispositivo. Si no se proporciona, usa el dispositivo activo.

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si el volumen fue establecido

`spotify_set_repeat`

Establecer el modo de repetición para la reproducción.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`state`	string	Sí	Modo de repetición: "off", "track", o "context"
`device_id`	string	No	ID del dispositivo objetivo

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si el modo de repetición se estableció correctamente

`spotify_set_shuffle`

Activar o desactivar la reproducción aleatoria.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`state`	boolean	Sí	true para activar la reproducción aleatoria, false para desactivarla
`device_id`	string	No	ID del dispositivo objetivo

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si la reproducción aleatoria se estableció correctamente

`spotify_transfer_playback`

Transferir la reproducción a un dispositivo diferente.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`device_id`	string	Sí	ID del dispositivo al que transferir la reproducción
`play`	boolean	No	Indica si se debe iniciar la reproducción en el nuevo dispositivo

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Indica si la transferencia fue exitosa

Notas

Categoría: tools
Tipo: spotify

On this page

On this page

Instrucciones de uso

spotify_search

spotify_get_track

spotify_get_tracks

spotify_get_album

spotify_get_albums

spotify_get_album_tracks

spotify_get_saved_albums

spotify_save_albums

spotify_remove_saved_albums

spotify_check_saved_albums

spotify_get_artist

spotify_get_artists

spotify_get_artist_albums

spotify_get_artist_top_tracks

spotify_follow_artists

spotify_unfollow_artists

spotify_get_followed_artists

spotify_check_following

spotify_get_show

spotify_get_shows

spotify_get_show_episodes

spotify_get_saved_shows

spotify_save_shows

spotify_remove_saved_shows

spotify_check_saved_shows

spotify_get_episode

spotify_get_episodes

spotify_get_saved_episodes

spotify_save_episodes

spotify_remove_saved_episodes

spotify_check_saved_episodes

spotify_get_audiobook

spotify_get_audiobooks

spotify_get_audiobook_chapters

spotify_get_saved_audiobooks

spotify_save_audiobooks

spotify_remove_saved_audiobooks

spotify_check_saved_audiobooks

spotify_get_playlist

spotify_get_playlist_tracks

spotify_get_playlist_cover

spotify_get_user_playlists

spotify_create_playlist

spotify_update_playlist

spotify_add_playlist_cover

spotify_add_tracks_to_playlist

spotify_remove_tracks_from_playlist

spotify_reorder_playlist_items

spotify_replace_playlist_items

spotify_follow_playlist

spotify_unfollow_playlist

spotify_check_playlist_followers

spotify_get_current_user

spotify_get_user_profile

spotify_get_top_tracks

spotify_get_top_artists

spotify_get_saved_tracks

spotify_save_tracks

spotify_remove_saved_tracks

spotify_check_saved_tracks

spotify_get_recently_played

spotify_get_new_releases

spotify_get_categories

spotify_get_markets

spotify_get_playback_state

spotify_get_currently_playing

spotify_get_devices

spotify_get_queue

spotify_pause

spotify_skip_next

spotify_skip_previous

spotify_add_to_queue

spotify_set_volume

spotify_set_repeat

spotify_set_shuffle

spotify_transfer_playback

Start building today

Trusted by over 60,000 builders.

Build Agentic workflows visually on a drag-and-drop canvas or with natural language.