用途：通过 curl 调用 Spotify Web API，完成账户信息查询、内容搜索、个人化数据读取、歌单管理与播放控制。所有请求使用 Authorization: Bearer $SPOTIFY_TOKEN 头。
主要能力：查询当前用户资料（/v1/me）；搜索曲目、艺人、专辑、歌单（/v1/search）；读取用户热门曲目与艺人（/me/top，需 user-top-read，time_range 取 short_term、medium_term 或 long_term）、最近播放（/me/player/recently-played，需 user-read-recently-played）；列出用户歌单与歌单曲目；创建歌单（/users/<user-id>/playlists，需 playlist-modify-public 或 playlist-modify-private）并添加曲目（/playlists/<playlist-id>/tracks）；获取专辑、艺人及其热门曲目。
播放控制：获取播放状态、播放或恢复、暂停、上一首/下一首、设置音量等接口位于 /me/player 路径下。控制接口需 Spotify Premium，且需有活跃的 Spotify 客户端在设备上运行，并需 user-modify-playback-state 或 user-read-playback-state 权限。
使用方式：先写入临时文件（如 /tmp/spotify_query.txt、/tmp/spotify_playlist.json），再用 curl 发送请求，并可通过 jq 过滤字段。资源可用 URI（spotify:track:<id>）或裸 ID 引用，搜索结果同时返回 id 与 uri。
限制：访问令牌 1 小时过期，401 需在连接器设置中刷新；各接口需对应 OAuth 权限；遇 429 需按 Retry-After 秒数退避重试。故障排查可运行 zero doctor check-connector --env-name SPOTIFY_TOKEN 或 zero doctor check-connector --url https://api.spotify.com/v1/me --method GET。费用、价格等其余信息暂未提供。