SuperAPI AI 工具集

peloton

办公与效率

查看项目

更新于 10-26 18:14

技能介绍

用途 该技能连接 Peloton 健身平台,用于浏览点播和直播健身课程、管理课程日程以及预约锻炼。

主要能力

  • 课程浏览:使用 peloton ride-archived 浏览归档课程,支持按健身项目、时长、排序方式、难度等级、字幕、类别、教练等过滤;使用 peloton ride-live 浏览直播课程,默认查看未来 7 天且排除已结束的课程。
  • 课程搜索:使用 peloton search-class 按自然语言或合作方提供的术语搜索课程,搜索不支持 API 分页,--limit 和 --page 仅在本地结果集上切片。
  • 过滤元数据:使用 peloton metadata-mappings 获取所有过滤分类(教练、课程类型、设备、健身项目、难度等级、内容格式)的 ID,用于过滤参数。
  • 日程管理:使用 peloton schedule-event 预约点播课程(通过 --ride-id 和 --scheduled-start-time)或直播课程(通过 --join-token);使用 peloton delete-scheduled-event 删除预约;使用 peloton reschedule-event 修改预约时间。
  • 生成链接:使用 peloton deeplink --class-id 生成在 Peloton 中查看课程的链接。

使用方式 工具以 CLI 形式安装在 PATH 中,直接调用相应命令。课程浏览命令返回 body.classes[] 数组,包含课程信息;展示时使用 widget.create 创建列表,包含标题、教练、时长和课程时间,并附上缩略图和链接(若有)。对于直播课程,默认使用 --days 7 --exclude-complete true。课程时长使用 CLI 提供的 duration_minutes 字段。

认证 Peloton 是 OAuth 支持的技能。正常读取课程时直接调用读取命令,无需预先检查状态。若命令报告 not_connected 或用户要求管理连接,则运行 peloton status。若未连接,需先完成链接流程:运行 peloton authorize-url 前需获得用户明确确认,说明提供方名称并警告将存储持久访问令牌。授权链接以 Markdown 链接形式分享。等待用户批准期间不要重复调用 authorize-url,可使用 peloton status 检查待连接状态。回调完成后再次运行 peloton status,仅在状态为 connected 时继续。凭证存储方面,切勿打印 client_secret、access_token 或 refresh_token。令牌过期错误会自动刷新;若自动刷新后 API 调用仍失败,重新检查状态并重新链接。

适用场景 适用于需要浏览 Peloton 课程库、查找特定课程、查看直播时间表、预约或调整锻炼日程的用户。也可用于快速获取课程链接以便在 Peloton 应用中查看。

限制 搜索功能不支持 API 分页,--limit 和 --page 仅对返回结果进行本地切片,如需不同结果应优化查询而非获取其他页。用户界面展示时不应显示原始内部标识符、难度分数、星级评分、评分数量或课程 URL,除非用户明确要求技术或调试细节。不要自行构造课程 URL。日程的创建和删除可在用户明确请求下直接进行,无需额外确认。