核心用法
Strava CLI 是一款面向命令行用户的非官方 Strava 数据管理工具，基于 Python 封装 Strava REST API，提供无需打开浏览器或手机 App 即可快速查询、筛选、导出运动记录的能力。
安装与配置：推荐通过 uvx 零依赖运行或 uv tool install 持久化安装。使用前需完成三步 OAuth 2.0 授权：创建 Strava 账户 → 在官网申请 API Application（获取 Client ID/Secret）→ 执行 strava auth 完成浏览器授权或手动 Token 交换。令牌每 6 小时自动刷新，配置存储于 ~/.config/strava-cli/。
功能覆盖：
strava profile/stats：快速查看运动员档案与跑/骑/游统计摘要strava activities：支持按类型（Run/Ride 等）、日期范围筛选，可限制返回数量strava activity <id>：获取单条活动的详细元数据strava export：批量导出 JSON/其他格式，便于本地数据分析或备份
显著优点
- 零 GUI 开销，适合服务器/CI 环境或偏好终端的极客用户
- 结构化输出（JSON）便于与 pandas、jq 等数据处理工具链整合
- 支持无浏览器场景的手动 OAuth 流程，兼顾自动化脚本需求
潜在局限
- API 限制：新注册应用仅允许 1 名授权用户，切换账户需手动撤销再授权
- 非官方：由社区维护（geodeterra/strava-cli），功能更新依赖作者节奏，无 Strava 官方 SLA 保障
- 速率限制：受 Strava API 配额约束（默认 100 requests/15min），大规模导出需自行限速
- 数据隐私：令牌以明文 JSON 存储于本地目录，多用户系统需注意文件权限
适合人群
- 需要将 Strava 数据导入本地分析 pipeline 的数据工程师/科学家
- 追求效率、反感移动端频繁弹窗的硬核跑者/骑行者
- 希望定期自动备份运动记录的技术爱好者
常规风险
- OAuth 令牌泄露可导致他人读取你的私密活动与位置轨迹，务必保管
tokens.json - 自动化脚本若未处理 Token 过期或 API 限流，可能触发账号临时封禁
- 项目处于早期阶段，存在作者弃坑或 API 变更导致功能失效的可能性