SuperAPI AI 工具集

spotify-api

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:该技能直接调用 Spotify Web API,用于创建和管理歌单、搜索音乐、控制播放,并读取用户资料、热门曲目与收听历史。其独特能力是生成歌单封面图:Claude 本身不能生成图片,此技能通过生成 SVG 再转换为 PNG 来绕过该限制,封面采用适合缩略图查看的大号可读字体,并按主题动态配色。

主要能力:按艺人、主题、歌词关键词或指定歌曲列表创建歌单;歌单的创建、列出、更新、删除;搜索曲目、艺人、专辑、歌单;添加或移除曲目、获取推荐;播放、暂停、跳过、调节音量;访问已保存曲目、个人资料与收听历史。

使用方式:所有操作通过 scripts/spotify_client.py 中的 SpotifyClient 类完成,客户端负责 OAuth 认证。需先在 Claude Desktop 的 Settings → Developer → Allow network egress 中开启网络出口,允许 api.spotify.com;再执行 pip install -r requirements.txt 安装 requests、python-dotenv、cairosvg、pillow。凭据可通过环境变量(SPOTIFY_CLIENT_ID、SPOTIFY_CLIENT_SECRET、SPOTIFY_REDIRECT_URI、SPOTIFY_ACCESS_TOKEN、SPOTIFY_REFRESH_TOKEN)加载,也可在初始化时直接传入。生成封面图前必须先阅读 references/COVER_ART_LLM_GUIDE.md,上传封面需 ugc-image-upload 权限,否则会返回 401,但仍可在本地生成后手动上传。

适用场景:整理和扩充歌单、按情绪或年代批量选曲、查看个人收听统计、远程控制播放,以及为歌单制作封面。

限制:需网络访问与 Spotify 凭据;艺人热门曲目最多返回 10 首;搜索基于曲目名与元数据而非完整歌词;歌单列表需自行分页(每页最多 50);封面生成与上传依赖 cairosvg、pillow 及相应授权范围。版本 0.9.1,发布日期 2025 年 10 月 22 日。