用途：从 Spotify 读取歌曲库（只读权限，不含播放控制或播放列表修改），导出为共享 crate 格式供 beatport-skill 匹配。
主要能力：读取用户信息、喜欢的歌曲、播放列表及其内容、热门曲目、最近播放、搜索；导出 crate 到 ~/.claude/skills/beatport-skill/crates/<name>.json。所有命令输出 JSON，曲目对象已含 source、source_id、artist、title、mix、isrc、duration_ms、url 字段。
使用方式：
- CSV 导入（当前可用）：从 https://exportify.net 导出 CSV，然后运行 python3 ~/.claude/skills/spotify-skill/spotify_skill.py import-csv ~/Downloads/friday.csv --name friday。
- 粘贴网页播放器 token：python3 ~/.claude/skills/spotify-skill/spotify_skill.py setup --token 'BQ...'，约一小时过期且无刷新。
- 注册应用 + PKCE：创建应用并添加回调 http://127.0.0.1:8899/callback，然后 setup --client-id 与 login。 主要命令：me、liked、playlists、playlist、top-tracks、recently-played、search、logout；加 --all 翻页到底。导出示例：export-crate --name friday --liked --all。
限制：Spotify 自 2024-11-27 起对新应用停用 audio-features 等接口，crate 中 bpm 与 key 为 null，BPM 与调性由 Beatport 匹配阶段提供；label 也不可用。新开发者应用创建自 2025 年 12 月起冻结。仅用标准库，无需 pip 安装；遇 429 会停止；播放列表中的播客单集会被跳过。