Spotify Web Api

Spotify Web API

Integration guide for Spotify's official Web API. It uses Authorization Code with PKCE, stores tokens locally under the private Skill data directory, and never returns access or refresh tokens in action output.

Use this skill for Spotify playlist edits, current playback lookup, track search, queueing, adding tracks to either a specified playlist or the playlist currently being played, and reading taste signals such as top tracks, top artists, recently played tracks, saved tracks, and local taste profiles.

辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。

printf '%s' '{"skill_action":""}' | python3 run.py

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

| 动作 | 用途 | |---|---| | status | Show local OAuth/config state without returning secrets. Optionally validate with Spotify. | | auth-url | Create a Spotify OAuth PKCE authorization URL. Add the returned redirecturi to the Spotify app first. | | finish-auth | Exchange a Spotify callback URL or authorization code for local tokens. Tokens are stored locally and not returned. | | current-playback | Return the current Spotify playback context and current track. | | search-track | Search Spotify tracks and return simplified results. | | list-playlists | List current user's playlists. | | top-tracks | Return the user's top Spotify tracks for short, medium, or long term taste signals. | | top-artists | Return the user's top Spotify artists and genre tags for short, medium, or long term taste signals. | | recently-played | Return recently played tracks, including playedat and playback context. | | saved-tracks | Return tracks saved in the user's Spotify library. | | taste-profile | Build a local taste profile from top tracks, top artists, recent plays, and saved tracks. | | add-track-to-playlist | Add one or more track URIs to a specific playlist ID, URI, URL, or owned playlist name. | | add-track-to-current-playlist | Add track URIs to the playlist that is currently the Spotify playback context. | | search-and-add-to-current-playlist | Search for a track, choose a result by index, and add it to the currently playing playlist context. | | add-to-queue | Add a track URI to the Spotify playback queue. Spotify Premium is usually required. |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: uvwt
• Source: uvwt/agentdock
• License: Apache-2.0
• Homepage: https://uvwt.github.io/agentdock-docs/

Install and usage instructions live in the source repository linked above.