usc-booking-api

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 浏览器占用较多系统资源；自动化操作可能因网络延迟或网站反爬机制而失败；预订和取消操作会直接影响实际账户状态，建议首次使用前充分测试，避免误操作导致不必要的预订或取消费用。