核心用法
Urban Sports Scanner 是一款面向德国健身平台 Urban Sports Club 的自动化 CLI 工具。用户通过 Python 环境部署后，配置目标场馆（Venue）URL 和关键词，即可扫描指定日期的课程列表，获取带直接预订链接的结构化数据。工具支持三大核心操作：扫描课程（--date、--venue、--json 筛选）、自动预订（--book <class-id>）和取消预约（--cancel <class-id>），同时可查询当前预约状态（--bookings）。
显著优点
1. 端到端自动化：从课程发现到预订完成全流程无需人工登录网页，Playwright 驱动 Chromium 模拟浏览器操作。
2. 直接预订链接：每个课程返回可点击的直达链接，省去在 USC 网站层层导航的时间。
3. 灵活配置：支持多场馆管理、关键词过滤、JSON 输出便于集成其他工具或通知系统。
4. credential 隔离：登录信息独立存储于 credentials.json 并默认排除在版本控制外，降低泄漏风险。
潜在缺点与局限性
- 依赖 Playwright 与 Chromium：环境部署较重（需安装浏览器及系统依赖），对非技术用户门槛较高。
- 无官方 API：基于网页爬取，USC 前端结构变更可能导致工具失效，维护依赖性大。
- 账户安全风险：密码明文存储于本地 JSON，虽
.gitignore保护但无加密，设备丢失即泄漏。 - 地域限制：仅适配德国 Urban Sports Club 平台，其他市场不可用。
适合人群
- 高频使用 USC 的健身爱好者（需技术背景）
- 希望自动化课程监控与抢课的用户
- 开发者希望集成 USC 数据到自建通知系统
常规风险
1. 违反 ToS 风险：自动化登录与预订可能违反 USC 用户协议，存在封号可能。
2. 密码明文存储：credentials.json 无加密机制，建议配合系统级密钥管理或环境变量替代。
3. Session 劫持：Playwright 管理的浏览器状态若未妥善隔离，可能残留敏感会话数据。