用途：把 Spotify 或 YouTube 中标记的曲目（crate）转成 Beatport 可购买清单，并整理成 Ableton 可用的文件夹与和谐排序歌单。仅生成经人工审核的计划和 URL 列表，不执行任何购买，也不提供购买命令或浏览器结账自动化；不处理 Beatport 密码，认证使用粘贴的 bearer token 或 PKCE。
主要能力：search 搜索曲目/发行/艺人；track 获取 BPM、调性、Camelot、厂牌、价格、URL；library、purchases、downloads 读取已保存、已购与下载权益；match 按 ISRC 优先、其次艺人+标题+mix 模糊匹配；plan 输出逐曲价格与总额（不购买）；report 生成 Camelot 贪心排序与过渡提示；organize 匹配下载文件并写出 .m3u8；camelot 转换调性；probe 与 spec 发现账户可用的 /my/* 端点。
使用方式：先 setup 配置 token，再用 auth-status 确认，probe 探测端点，随后执行 library/purchases/downloads。典型流程为导出 crate（由 spotify-skill/youtube-skill 生成）、match、plan，之后由用户自行结账下载，再运行 organize 与 report。命令如：python3 ~/.claude/skills/beatport-skill/beatport_skill.py setup --token 'eyJ...'；probe；match CRATE.json；plan CRATE.json；organize CRATE.json --dir ~/Music/friday-set。
适用场景：舞曲购买规划、周五演出歌单准备、已有曲库核对以防重复购买。
限制：api.beatport.com/v4 可脚本化，而 www.beatport.com 受 Cloudflare 拦截，需真实浏览器；/my/* 未公开文档，需探测；plan 的价格单位可能不一致，若 estimated_total 与 estimated_total_raw_sum 不同须标注总额未核实；模糊或不确定匹配需人工复核；ISRC 仅 Spotify 有，YouTube crate 只能模糊匹配；盗版、编辑版与非舞曲常不在 Beatport，unmatched_on_beatport 属正常结果；仅用标准库，match 默认每查询间隔 0.25s。