核心功能
strava-python 是一款面向开发者的 Strava 数据查询工具,基于 Python 的 stravalib 库构建,主打「零配置门槛」体验。与需要手动编辑 JSON 的 curl 方案不同,它提供交互式 setup.py 向导,自动完成 OAuth 授权流程并将凭证保存至 ~/.strava_credentials.json。
显著优点
- 低门槛配置:图形化向导替代繁琐的手动 API 密钥配置
- 语义化命令:
recent/stats/last等直观指令,无需记忆 API 端点 - 生态兼容:基于官方 stravalib 库,与 Strava API v3 同步更新
- 隐私本地化:凭证本地存储,不依赖第三方云服务
潜在局限
- 环境依赖:必须预装 Python 3.7+ 及 pip 生态,非 Python 用户需额外配置
- 速率限制:受 Strava 免费 API 约束(100/15min,1000/天),高频查询场景受限
- 无实时推送:仅支持拉取模式,无法订阅实时活动通知
- CLI 交互边界:复杂数据筛选需自行扩展脚本,原生不支持 SQL 式查询
适合人群
- 已熟悉 Python 的健身数据分析师
- 希望自动化周报/月报生成的 Strava 重度用户
- 需要快速搭建原型而不想处理 OAuth 细节的开发者
常规风险提示
- 凭证安全:
~/.strava_credentials.json包含 OAuth token,需确保文件权限(建议 600)并避免提交至 Git - API 稳定性:Strava 免费 API 存在变更可能,需关注 stravalib 版本更新
- 数据隐私:运动轨迹等敏感数据本地处理,但 API 传输过程依赖 TLS