cline/save-to-spotify

O que save-to-spotify faz?

Habilidade do agente 'save-to-spotify' de cline/skills.

Descrição

Permite que um agente de IA salve faixas, álbuns ou playlists na sua biblioteca do Spotify.

Configuração

1. Crie um aplicativo no Spotify Developer Dashboard.
2. Defina as seguintes variáveis de ambiente:

SPOTIFY_CLIENT_ID=seu_client_id_aqui
SPOTIFY_CLIENT_SECRET=seu_client_secret_aqui

3. Certifique-se de que o URI de redirecionamento configurado no Spotify Developer Dashboard seja http://localhost:8888/callback (ou conforme necessário para o seu agente).

Comandos

• add track <nome da faixa> [artista] – Salva uma faixa na sua biblioteca.
• save album <nome do álbum> [artista] – Salva um álbum na sua biblioteca.
• follow playlist <nome da playlist> [owner] – Segue uma playlist pública.

Funcionamento

1. O agente verifica se as credenciais do Spotify estão configuradas.
2. Se não houver token de acesso válido, o agente inicia o fluxo OAuth, solicitando que o usuário autorize o aplicativo.
3. Após a autorização, o agente pode realizar operações na API do Spotify em nome do usuário.
4. O token de acesso é armazenado em cache no arquivo .spotify_token.json para evitar reautenticação.

Exemplo de uso

Usuário: Adicione 'Bohemian Rhapsody' do Queen à minha biblioteca.
Agente: Claro! Buscando a faixa... Faixa 'Bohemian Rhapsody' do Queen foi salva com sucesso na sua biblioteca do Spotify.

Dependências

• curl ou node instalado para requisições HTTP.
• jq (opcional, para processar JSON em scripts shell).

Notas

• A habilidade só funciona para contas pessoais do Spotify.
• O token de acesso expira após 1 hora; o agente tentará renová-lo automaticamente usando o refresh token.