核心功能
stats.fm CLI 是一款基于 Python 的命令行工具，通过 stats.fm API 获取 Spotify/Apple Music 听歌数据。无需 pip 安装，仅依赖 Python 3.6+ 标准库即可运行。
数据维度覆盖：
- 个人档案：用户资料、会员状态（Plus/Free）
- 排行榜单：曲目、艺人、专辑、曲风多维度 TOP 榜单
- 实时状态：当前播放、最近播放记录
- 深度统计：指定艺人/曲目/专辑的详细播放数据，含月度拆解
- 全局榜单：全球热门曲目、艺人、专辑排行
- 内容检索：艺人、曲目、专辑的 ID 搜索
灵活的时间范围控制是核心亮点：支持预设周期（今日/四周/半年/终身）或自定义日期（精确到年月日），便于纵向对比不同时期的听歌偏好变迁。
显著优点
1. 零依赖部署：单文件脚本，无第三方包依赖，开箱即用
2. 数据颗粒度细：月度自动拆解揭示听歌行为的季节性波动
3. 叙事导向设计：官方文档强调"不要只报数字，要讲故事"——如发现某月播放量激增，提示这可能是用户生活变化的印记
4. 免费用户友好：即使无 Plus 订阅，仍可获取排名、月度趋势、搜索等核心功能
5. ID 驱动查询：通过搜索获取数字 ID 后，可精准查询任意公开档案
潜在局限
- 仅限公开档案：私有/受限用户数据无法获取
- 第三方服务依赖：stats.fm 本身依赖 Spotify/Apple Music 的数据授权
- Apple Music 支持待验证：文档明确标注 AM 功能"未测试"
- Plus 功能受限：播放次数、总收听时长等需付费解锁
- 速率限制：文档建议避免每秒超过 10 次调用
适合人群
- 音乐爱好者：量化分析个人听歌习惯，制作年度音乐总结
- 数据控：追踪特定艺人/专辑的收听轨迹，发现"入坑"时间点
- 内容创作者：获取真实听众数据，制作音乐趋势分析内容
- 开发者：学习无鉴权 API 调用、CLI 工具设计的参考案例
常规风险
- 隐私边界：工具可查询任意公开档案，需注意不越界分析他人数据
- API 稳定性：非官方 stats.fm 客户端，API 变更可能导致功能失效
- 数据准确性：第三方统计存在与 Spotify 官方 Wrapped 的差异可能