返回顶部
s

spotify-playlist-curatorSpotify歌单策展

Create and refine Spotify playlists using the Spotify Web API, with support for track search, recent and top listening lookups, queueing selected tracks, and curated playlist generation from vibes, seed tracks, and listening history. Use when a user wants a new playlist, wants tracks added to a playlist, wants songs similar to a song, artist, or mood, or wants a few selected songs queued.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.3
安全检测
已通过
106
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

spotify-playlist-curator

Spotify 播放列表策展人

使用此技能进行 Spotify 播放列表创建、歌曲选择、收听历史查询以及轻量级队列操作。

以下工具是理解音乐的手段,而非需要遵循的 API 文档。 首先理解音乐目标,将其转化为数据(音频特征、艺术家、时间过滤器),创造性地串联工具,并解释你的选择,让用户理解你的思考过程。

核心规则

  • - 优先创建新播放列表,而非修改现有播放列表。
  • 除非用户明确要求,否则不要修改现有播放列表。
  • 修改已生成的播放列表时,优先使用带版本号的副本,如 (v2)、(更柔和) 或 (更有舞曲感)。
  • 仅在用户明确请求队列操作时使用队列功能。
  • 诚实说明发现功能是基于启发式算法的。用它来补充策展,而非替代判断。
  • 在组合多步骤工作流时,始终使用 --json 模式。解析 JSON 输出,不要抓取文本。
  • 在首次调用推荐之前,运行 taste show 检查用户的品味档案。排除的艺术家会自动强制执行,但喜爱的流派和备注可能会影响你的种子/流派选择。
  • 当用户表达品味偏好时(我不喜欢 X、我喜欢 Y、永远不要包含 Z),将其保存到品味档案中,以便跨会话持久化。
  • 如果用户明确请求的艺术家出现在品味档案的排除列表中(例如,当 Taylor Swift 被排除时,用户说给我做一个 Taylor Swift 播放列表),告知用户存在冲突,并询问是否要为此播放列表破例。不要静默覆盖排除规则,也不要静默产生空结果或令人困惑的结果。

环境预检

在首次 CLI 调用之前,检查环境是否已设置:

  1. 1. 检查 .venv — 如果技能根目录中不存在 .venv 目录,告诉用户先运行设置:
bash bash scripts/setup.sh

不要自行创建虚拟环境或手动安装依赖项。设置脚本会处理所有事项,包括凭据提示。

  1. 2. 检查认证 — 一旦 .venv 存在,验证认证状态:
bash .venv/bin/python scripts/spotify_cli.py --json status

如果 authenticated 为 false,告诉用户运行认证流程:
bash
.venv/bin/python scripts/spotify_auth.py

在 status 返回 authenticated: true 之前,不要尝试其他命令。

常见设置错误

错误原因告知用户的内容
invalidclient 或客户端 ID 无效.env 文件包含占位值或错误的凭据打开技能根目录中的 .env,将 yourclientidhere / yourclientsecrethere 替换为来自 https://developer.spotify.com/dashboard 的真实凭据,然后重新运行 spotifyauth.py
credentials not found 或占位值
设置已运行但用户未编辑 .env | 同上 — 他们需要创建一个 Spotify 应用并粘贴凭据 | | no such file or directory: .venv/bin/python | .venv 不存在 | 首先在技能根目录运行 bash scripts/setup.sh | | redirecturimismatch | Spotify 应用的重定向 URI 不匹配 | 在 Spotify 开发者仪表板中,将重定向 URI 设置为 http://127.0.0.1:8888/callback |

Spotify API 限制(截至 2026 年 3 月)

在调用任何 CLI 命令之前,请注意这些当前存在的 Spotify API 回归问题。如果忽略它们,将导致静默失败或 403/400 错误

  1. 1. 搜索限制上限为 10。 search 命令中 --limit 值超过 10 会返回 400 Invalid limit。CLI 内部会处理此问题,但不要期望单次搜索调用能返回超过 10 个结果。
  2. 批量艺术家端点(GET /artists?ids=)返回 403。 代码会自动回退到单个 GET /artists/{id} 调用。
  3. 播放列表响应将 tracks 重命名为 items,将 track 重命名为 item。 代码会自动规范化这两种重命名。
  4. GET /playlists/{id}/items 对某些第三方播放列表返回 403(非认证用户拥有的播放列表)。用户拥有的播放列表正常工作。
  5. GET /recommendations、GET /audio-features 和 GET /artists/{id}/related-artists 已完全移除。 recommend 命令通过使用 ReccoBeats 作为主要推荐 + 音频特征后端,并辅以 Spotify 专属回退来绕过此限制。
  6. 推荐和音频特征现在来自 ReccoBeats(api.reccobeats.com)。无需认证。Spotify 处理播放列表、搜索、播放和收听历史。ReccoBeats 处理推荐和音频特征。如果 ReccoBeats 不可用,系统会回退到仅使用 Spotify 的推荐(搜索 + 艺术家热门曲目 + 流派评分)。
  7. 艺术家端点不再返回流派数据。 批量和个人艺术家端点都返回 null 作为流派。blend-dna 中的流派过滤使用 MusicBrainz 作为主要流派来源(免费,无需 API 密钥,缓存到磁盘 30 天),当 MusicBrainz 没有艺术家的数据时,使用 Spotify 流派搜索成员资格作为回退。
  8. GET /artists/{id}/top-tracks 返回 403。 artist-top-tracks 命令会自动回退到搜索。

有关每个回归问题和解决方法的完整详细信息,请参阅 references/implementation-notes.md。

快速参考表

对于较简单的情况:

请求类型方法
将 [特定歌曲] 添加到 [播放列表]search → add-to-playlist
根据我最近的收听记录创建播放列表
create-from-recent(一个命令) |
| 根据我的热门曲目创建播放列表 | create-from-top(一个命令) |
| 将 [歌曲] 加入队列 | 如果需要则 search → queue |
| 我最近在听什么? | recent / top-tracks / top-artists |
| [艺术家] 的最新歌曲 | artist-releases → add-to-playlist 或 queue |
| 仅包含 X 和 Y 的播放列表 | artist-top-tracks + artist-releases → create-playlist + add-to-playlist |
| 以艺术家为中心 / 基于氛围 / 融合 | 使用下面的 6 步工作流 |

选择合适的推荐工具

根据请求的形式选择工具:

请求类型工具原因
类似 X 的歌曲 / 更多这种氛围recommend --seed-uris最适合从已知曲目扩展
类似 X、Y、Z 的艺术家 / 基于场景
recommend --artists | 发现合作者网络 + 从这些艺术家播种 |
| X 和 Y 的融合 / 两种美学的融合 | blend-dna | 分析双方并找到重叠区域。对于融合请求,首先使用此工具 — 不要从 recommend 开始 |
| 从单首曲目快速进行声音探索 | discover | 轻量级封装:返回相似曲目,不带评分。适合同心圆发现中的第 1 环 |
| 手动策展 / 填补空白 | search + audio-features | 当你需要特定曲目并想验证它们是否合适时 |

关键区别:recommend 返回带评分的曲目及原因(有助于解释选择)。discover 返回原始相似曲目,不带评分(更快,适合串联使用)。blend-dna 是唯一一个分析两个不同群体并找到中间地带的工具。

限制条件和杠杆

将用户语言映射到 CLI 标志:

用户说标志效果
不要 X--exclude-artists X完全过滤掉 X
A 和 B 的融合
--max-per-artist 2 | 防止一个艺术家主导 |
| 更强调 Y | --boost-artists Y | +0.15 评分提升 |
| 冷门曲目 / 小众 | --popularity-target 25 | 偏向不太流行的曲目 |
| 劲爆歌曲 / 热门歌曲 | --popularity-target 75 | 偏向流行曲目 |
| 充满活力的 / 欢快的

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 spotify-playlist-curator-1775938941 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 spotify-playlist-curator-1775938941 技能

通过命令行安装

skillhub install spotify-playlist-curator-1775938941

下载

⬇ 下载 spotify-playlist-curator v1.0.3(免费)

文件大小: 54.1 KB | 发布时间: 2026-4-12 11:30

v1.0.3 最新 2026-4-12 11:30
Improve first-run diagnostics: detect placeholder Spotify credentials earlier, clarify invalid_client auth errors, and document common setup failures.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部