用途:该技能用于与 Strava 交互,加载活动、分析训练并追踪健身数据。
主要能力:通过 Strava API 获取最近活动列表、按日期筛选活动、查看单次活动详情、获取认证运动员资料、获取指定运动员统计数据,并支持分页浏览。返回的活动字段包含名称、距离(米)、移动时间与总用时(秒)、爬升(米)、类型与运动类型、开始时间、平均与最大速度、平均与最大心率、点赞数等。
使用方式:先前往 https://www.strava.com/settings/api 创建 API 应用并记录 Client ID 与 Client Secret,用回调 http://localhost 测试;再在浏览器访问授权 URL 获取授权码,通过 curl 向 https://www.strava.com/oauth/token 交换 access_token 与 refresh_token。凭据可写入 ~/.clawdbot/clawdbot.json 的 skills.entries.strava.env,或设置为环境变量 STRAVA_ACCESS_TOKEN、STRAVA_REFRESH_TOKEN、STRAVA_CLIENT_ID、STRAVA_CLIENT_SECRET。
调用时以 Bearer 令牌请求 https://www.strava.com/api/v3/athlete/activities,可用 per_page、page、after、before 参数;活动详情请求 https://www.strava.com/api/v3/activities/ACTIVITY_ID;运动员资料请求 https://www.strava.com/api/v3/athlete;统计数据请求 https://www.strava.com/api/v3/athletes/ATHLETE_ID/stats。
限制:访问令牌每 6 小时过期,需用脚本 bash {baseDir}/scripts/refresh_token.sh 或手动刷新并更新两个令牌;速率限制为每 15 分钟 200 次、每天 2000 次,超限响应会带 X-RateLimit-* 头;401 错误表示令牌过期。时间戳与单位可在本地用 date、除法等命令转换,JSON 可用 jq 解析。其余细节资料暂未提供。