核心用法
Baseball 是一款调用 MLB Stats API 的 Python 脚本工具，专为美职棒（MLB）赛事信息查询设计。用户可通过命令行快速获取今日赛程、实时战况与详细比分数据。
主要功能模块
| 命令 | 用途 | 示例 |
|:---|:---|:---|
| `games` | 查询赛程（支持日期范围、球队筛选） | `baseball.py games --team PHI --days 7` |
| `live` | 实时战况（球数、跑垒、打者/投手对决） | `baseball.py live PHI` |
| `score` | 详细比分（逐局得分、安打、失误） | `baseball.py score 718415` |
| `teams` | 列出全部球队缩写 | `baseball.py teams` |
输出支持 文本表格（默认）与 JSON 两种格式，便于直接阅读或下游程序处理。
---
显著优点
1. 数据源权威：直接对接 MLB 官方 Stats API，非第三方聚合，数据延迟低、准确性高
2. 零成本使用：无需 API Key、无认证门槛，开箱即用
3. 查询维度灵活：支持球队缩写、日期范围、Game PK 等多种检索方式，双赛日可用 ID 精确区分
4. 实时性较好：可获取当前球数、出局数、跑垒状态等细粒度现场数据
---
潜在缺点与局限性
- 速率限制未明确：文档提示"过度请求可能导致 IP 被封"，但无明确 QPS 上限，需自行保守轮询（建议≥15秒/次）
- 依赖网络稳定性：MLB API 偶有维护或区域访问波动
- 功能边界清晰：仅覆盖 MLB，不支持日职、韩职等其他棒球联赛
- 无历史统计深度：以单场比赛为核心，不提供球员赛季数据、高级 sabermetrics 分析
---
适合人群
- MLB 球迷快速查比分、追直播战况
- 开发者搭建轻量级赛事信息 Bot/插件
- 体育自媒体获取一手结构化数据
---
常规风险
| 风险类型 | 说明 | 缓解建议 |
|:---|:---|:---|
| 服务可用性 | 官方 API 策略变更或 IP 封禁 | 控制请求频率，避免高频轮询 |
| 时区混淆 | 赛程时间为美国东部时区 | 注意本地化转换 |
| 双赛歧义 | 同一日双赛时球队缩写可能匹配多场 | 使用 Game PK 精确查询 |