usc-booking-api

🏋️ USC 智能课程扫描与自动预订

基于 Playwright 的 USC 自动化工具,支持课程扫描、一键预订与取消,需本地配置凭证,帮助会员高效管理健身日程。

收藏
5.5k
安装
1.8k
版本
v1.0.1
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Urban Sports Club Scanner 是一款专为 USC 会员设计的 Python 自动化工具,基于 Playwright 浏览器自动化框架开发,旨在简化健身课程的查询、预订与管理流程。

核心用法方面,用户需先配置 Python 虚拟环境并安装 Playwright 及 Chromium 依赖,随后在 credentials.json 中填入 USC 账号密码,并在 config.py 中定义目标场馆(Venue)信息。完成配置后,通过命令行界面可执行多种操作:使用 scan.py 扫描特定日期或场馆的课程安排,获取带直接预订链接的课表;通过 --book 参数配合课程 ID 实现一键预订;使用 --cancel 参数取消已有预订;或通过 --bookings 查看当前所有有效预订。工具支持 JSON 格式输出,便于与其他系统集成。

显著优点包括高度自动化带来的时间节省,用户无需手动浏览网页即可完成课程监控和预订;支持多场馆配置和关键词过滤,可精准定位目标课程;直接提供官方预订链接,确保操作安全合规;CLI 设计适合技术用户进行脚本化或定时任务集成,可轻松实现每日课程监控自动化。

潜在局限性主要体现在技术门槛上,需要用户具备基础的 Python 环境和命令行操作知识;作为浏览器自动化方案,其稳定性受目标网站结构变化影响,若 USC 官网更新可能导致脚本失效;目前仅支持单一账号配置,不适合多用户共享使用;且仅限 Urban Sports Club 平台使用,不具备跨平台通用性。

该工具适合熟悉技术操作的 USC 会员,特别是需要频繁预订热门课程、希望自动化管理健身日程的用户,以及需要将课程数据集成到其他系统(如日历应用)的开发者。对于非技术用户,配置 Python 环境和 Playwright 依赖可能存在一定学习成本。

使用风险方面,尽管代码本身通过安全审计,但用户需注意 credentials.json 文件包含明文存储的登录凭证,虽有 .gitignore 保护但仍需确保本地文件系统安全;Playwright 依赖的 Chromium 浏览器占用较多系统资源;自动化操作可能因网络延迟或网站反爬机制而失败;预订和取消操作会直接影响实际账户状态,建议首次使用前充分测试,避免误操作导致不必要的预订或取消费用。

安全解读

核心用法

Urban Sports Scanner 是一个针对德国 Urban Sports Club 会员的 Python 命令行工具,通过 Playwright 浏览器自动化实现以下功能:

1. 课程扫描:扫描配置的场馆当日或指定日期的课程表,显示课程时间、名称、时长及直接预订链接
2. 一键预订/取消:通过课程 ID 快速完成预订或取消操作

3. 预订管理:查看当前所有待上课的预订列表

配置流程:安装 Python 依赖 → 填写 USC 登录凭证 → 配置关注场馆(支持关键词过滤课程类型)→ 运行扫描命令。

显著优点

  • 效率提升:告别手动浏览多个场馆页面,一次性获取所有关注场馆的课程信息
  • 直达预订:每个课程附带官方预订链接,点击即可跳转
  • 灵活配置:支持按日期、场馆筛选,JSON 输出便于与其他工具集成
  • 隐私友好:凭证本地存储,不上传第三方服务器
  • 开源透明:MIT 协议,代码可审计

潜在缺点与局限性

  • 技术门槛:需具备基础 Python/命令行知识,非技术用户上手困难
  • 依赖较重:需安装 Chromium 浏览器及系统依赖,占用存储空间
  • 无图形界面:纯 CLI 工具,移动端使用不便
  • 仅限德国 USC:功能绑定特定健身平台,无国际化支持
  • 凭证明文存储:登录信息以明文 JSON 保存,虽有 .gitignore 保护但无加密

适合人群

  • 德国 Urban Sports Club 活跃会员(Classic/Premium 等中高等级)
  • 需要同时跟踪 2-5 个不同场馆课程安排的用户
  • 习惯命令行工具的技术工作者
  • 希望自动化重复性预订操作的效率追求者

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 账号安全 | 自动化登录存在被平台检测风险 | 遵守 USC 使用条款,避免高频请求 |
| 凭证泄露 | credentials.json 明文存储 | 设置文件权限 600,避免共享设备使用 |
| 依赖安全 | Playwright 需系统级浏览器权限 | 仅从官方 PyPI 安装,保持更新 |
| 功能失效 | USC 网站改版可能导致脚本失效 | 关注项目更新,做好手动备份方案 |
| 预订冲突 | 自动化可能产生意外预订 | 使用前确认课程 ID,及时检查 `--bookings` 输出 |

usc-booking-api 内容

手动下载zip · 6.3 kB
config.pytext/plain
请选择文件