核心用法
statsfm 是一个基于 stats.fm API 的 Python 命令行工具，用于查询 Spotify 音乐收听数据。工具分为两大功能模块：
公开数据（无需账号）：专辑曲目查询、艺人作品目录、全局排行榜、搜索功能
个人数据（需 stats.fm 账号）：收听历史、播放次数统计、TOP 榜单、月度趋势分析、正在播放
核心命令结构为 ./statsfm.py <command>，支持丰富的日期范围参数（--range 4w/6m/lifetime 或自定义 --start/--end）和颗粒度控制（monthly/weekly/daily）。
显著优点
1. 零依赖部署：纯 Python 标准库实现，Python 3.6+ 即可运行，无需 pip 安装
2. 数据维度丰富：支持艺人/曲目/专辑三级统计，含月度细分、收听时长、播放次数
3. 灵活的时间分析：自定义日期范围 + 颗粒度，适合长期趋势追踪
4. 智能降级处理：自动识别免费/付费用户，对缺失数据标注 [Plus required]
5. AI 友好设计：内置面向智能体的使用指南，强调"数据讲故事"而非单纯罗列
潜在局限
1. 数据源单一：仅支持 Spotify（Apple Music 未充分测试），非全平台覆盖
2. 依赖第三方服务：stats.fm API 稳定性、速率限制（建议≤10次/秒）受外部约束
3. Plus 功能门槛：播放次数、收听时长等核心指标需付费订阅
4. 隐私限制：私有档案无法查询，部分用户数据可能不完整
适合人群
- 音乐数据爱好者：想深度分析个人收听习惯的 Spotify 用户
- 内容创作者：需要音乐趋势数据支持的播客主、乐评人
- 开发者/研究者：需要结构化音乐数据的分析师
常规风险
- 隐私敏感：涉及个人收听历史，需妥善保管用户名参数
- API 稳定性：第三方服务变更可能导致功能失效
- 数据准确性：依赖 Spotify 同步频率，可能存在延迟