Automação do Spotify
Automatize operações do Spotify — gerencie playlists, pesquise no catálogo musical, controle a reprodução, navegue por álbuns e faixas e acesse perfis de usuário — tudo orquestrado através da integração MCP do Composio.
Documentação do toolkit: composio.dev/toolkits/spotify
Configuração
- Conecte sua conta do Spotify através do servidor MCP do Composio em
https://rube.app/mcp - O agente solicitará um link de autenticação se não houver uma conexão ativa
- Uma vez conectado, todas as ferramentas
SPOTIFY_*ficam disponíveis para execução - Nota: Alguns recursos (controle de reprodução) exigem uma assinatura Spotify Premium
Fluxos de Trabalho Principais
1. Obter Perfil do Usuário Atual
Recupere informações completas do perfil do usuário autenticado do Spotify.
Ferramenta: SPOTIFY_GET_CURRENT_USER_S_PROFILE
Nenhum parâmetro necessário.
Retorna: nome de exibição, email, país, nível de assinatura (premium/grátis),
configurações de conteúdo explícito, imagens de perfil, número de seguidores e URIs do Spotify.
Escopos necessários: user-read-private, user-read-email.
2. Pesquisar no Catálogo do Spotify
Encontre álbuns, artistas, playlists, faixas, programas, episódios ou audiolivros por palavra-chave.
Ferramenta: SPOTIFY_SEARCH_FOR_ITEM
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
q | string | Sim | Palavras-chave da consulta de pesquisa |
type | array | Sim | Tipos de item: album, artist, playlist, track, show, episode, audiobook |
limit | integer | Não | Resultados a retornar (padrão: 20) |
offset | integer | Não | Deslocamento para paginação (padrão: 0) |
market | string | Não | Código de país ISO 3166-1 alfa-2 |
include_external | string | Não | Defina como audio para incluir conteúdo externo |
Nota: Audiolivros estão disponíveis apenas nos EUA, Reino Unido, Canadá, Irlanda, Nova Zelândia e Austrália.
3. Gerenciar Playlists
Navegue, crie, modifique e preencha playlists.
Obter playlists de um usuário:
Ferramenta: SPOTIFY_GET_USER_S_PLAYLISTS
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
user_id | string | Sim | ID do usuário do Spotify |
limit | integer | Não | Máx. de playlists, 1-50 (padrão: 20) |
offset | integer | Não | Deslocamento de paginação, 0-100000 (padrão: 0) |
Obter playlists do usuário atual:
Ferramenta: SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit | integer | Não | Máx. de playlists, 1-50 (padrão: 20) |
offset | integer | Não | Deslocamento de paginação, 0-100000 (padrão: 0) |
Obter detalhes da playlist:
Ferramenta: SPOTIFY_GET_PLAYLIST
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
playlist_id | string | Sim | ID da playlist do Spotify (ex.: 3cEYpjA9oz9GiPac4AsH4n) |
fields | string | Não | Filtro de campos separados por vírgula para reduzir o tamanho da resposta |
market | string | Não | Código de país ISO para conteúdo específico do mercado |
additional_types | string | Não | track,episode para incluir episódios de podcast |
Atualizar detalhes da playlist:
Ferramenta: SPOTIFY_CHANGE_PLAYLIST_DETAILS
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
playlist_id | string | Sim | ID da playlist (deve ser de propriedade do usuário atual) |
name | string | Não | Novo nome da playlist |
description | string | Não | Nova descrição da playlist |
public | boolean | Não | Alternar público/privado |
collaborative | boolean | Não | Modo colaborativo (apenas em playlists não públicas) |
4. Navegar pelos Itens da Playlist e Adicionar Faixas
Visualize as faixas em uma playlist e adicione novos itens.
Ferramenta: SPOTIFY_GET_PLAYLIST_ITEMS
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
playlist_id | string | Sim | ID da playlist do Spotify |
limit | integer | Não | Itens por página, 1-50 (padrão: 20) |
offset | integer | Não | Deslocamento de paginação (padrão: 0) |
fields | string | Não | Filtro de campo (ex.: items(track(name,id))) |
market | string | Não | Código de país ISO |
additional_types | string | Não | track,episode para episódios de podcast |
Ferramenta: SPOTIFY_ADD_ITEMS_TO_PLAYLIST
Adicione faixas ou episódios a uma playlist usando URIs do Spotify.
5. Obter Detalhes de Faixas e Álbuns
Recupere informações do catálogo para faixas e álbuns individuais.
Ferramenta: SPOTIFY_GET_TRACK — Obtenha detalhes de uma única faixa pelo ID do Spotify.
Ferramenta: SPOTIFY_GET_ALBUM — Obtenha dados completos do álbum, incluindo lista de faixas, informações do artista, capa e popularidade.
6. Controlar a Reprodução
Inicie, retome ou altere a reprodução no dispositivo ativo do usuário.
Ferramenta: SPOTIFY_START_RESUME_PLAYBACK
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
context_uri | string | Não | URI do Spotify do álbum, artista ou playlist (não pode ser combinado com uris) |
uris | array | Não | Lista de URIs de faixas para tocar (não pode ser combinado com context_uri) |
offset | object | Não | Posição inicial: {position: 5} ou {uri: 'spotify:track:...'} |
position_ms | integer | Não | Posição inicial em milissegundos |
device_id | string | Não | ID do dispositivo alvo (padrão para o dispositivo ativo) |
Requisitos: Assinatura Spotify Premium e pelo menos um dispositivo ativo.
Armadilhas Conhecidas
| Armadilha | Detalhes |
|---|---|
| Premium necessário para reprodução | SPOTIFY_START_RESUME_PLAYBACK retorna 403 se o usuário não tiver Spotify Premium |
| Dispositivo ativo necessário | O controle de reprodução retorna 404 se nenhum dispositivo Spotify (celular, desktop, web, alto-falante) estiver ativo |
| context_uri e uris são exclusivos | Não é possível usar context_uri e uris na mesma chamada de reprodução |
| Playlists colaborativas | collaborative só pode ser definido como true em playlists não públicas (public deve ser false) |
| Propriedade da playlist | SPOTIFY_CHANGE_PLAYLIST_DETAILS funciona apenas em playlists de propriedade do usuário autenticado |
| Restrições de mercado de audiolivros | Audiolivros via pesquisa estão disponíveis apenas nos EUA, Reino Unido, Canadá, Irlanda, Nova Zelândia e Austrália |
| Máx. de 11.000 playlists | Os usuários estão limitados a aproximadamente 11.000 playlists via SPOTIFY_CREATE_PLAYLIST |
Referência Rápida
| Slug da Ferramenta | Finalidade |
|---|---|
SPOTIFY_GET_CURRENT_USER_S_PROFILE | Obter perfil do usuário autenticado |
SPOTIFY_SEARCH_FOR_ITEM | Pesquisar catálogo por faixas, álbuns, artistas, etc. |
SPOTIFY_GET_USER_S_PLAYLISTS | Obter playlists de qualquer usuário |
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS | Obter playlists do usuário atual |
SPOTIFY_GET_PLAYLIST | Obter informações detalhadas da playlist |
SPOTIFY_GET_PLAYLIST_ITEMS | Listar faixas/episódios em uma playlist |
SPOTIFY_CHANGE_PLAYLIST_DETAILS | Atualizar nome, descrição e visibilidade da playlist |
SPOTIFY_CREATE_PLAYLIST | Criar uma nova playlist |
SPOTIFY_ADD_ITEMS_TO_PLAYLIST | Adicionar faixas/episódios a uma playlist |
SPOTIFY_GET_TRACK | Obter detalhes da faixa por ID |
SPOTIFY_GET_ALBUM | Obter detalhes do álbum por ID |
SPOTIFY_START_RESUME_PLAYBACK | Iniciar ou retomar a reprodução em um dispositivo |
Desenvolvido por Composio