核心用法
Baseball Skill 通过调用 MLB Stats API 提供三大核心功能：
1. 赛程查询 (games) — 支持按日期、球队、天数范围筛选，查看今日或未来7天的对阵安排
2. 实时战况 (live) — 获取进行中比赛的实时数据：球数、出局数、跑者位置、当前打者vs投手 matchup、上一球描述、逐局比分
3. 全场数据 (score) — 查看任意比赛（进行中或已结束）的完整 line score 及 R/H/E 统计
支持文本与JSON双格式输出，可通过球队缩写（如 PHI、NYY）或比赛ID（game_pk）快速定位。
显著优点
- 零门槛接入：MLB Stats API 完全免费开放，无需注册或 API Key
- 实时性强：官方数据源，延迟低，适合追踪直播比赛
- 输出灵活：终端友好的表格格式 + 结构化JSON，便于脚本集成
- 模糊匹配：支持球队全称模糊查询（如 "Phillies" 可匹配 PHI）
- 轻量依赖：仅需 Python3，无额外复杂依赖
潜在缺点与局限性
- 地域限制：MLB 官方 API 可能对部分非美国IP有访问限制或延迟
- 速率限制：官方建议 live 查询间隔不低于15秒，高频调用可能导致IP被封
- 赛季局限：仅覆盖 MLB 常规赛及季后赛，不含春训、小联盟或国际赛事
- 无历史深度：未明确支持跨赛季历史数据查询
- 版权标注：输出数据需保留MLB官方版权声明确认
适合人群
- 北美棒球球迷需快速查比分、追直播
- 数据分析师构建轻量 MLB 数据流水线
- 开发者集成体育数据到个人项目或自动化工作流
常规风险
- IP封禁风险：违反速率限制（<15秒/次）可能导致临时或永久封禁
- 数据准确性：依赖第三方官方API，极端情况下存在数据延迟或错误
- 隐私泄露：脚本运行日志可能暴露关注的球队偏好（无敏感个人信息）
- 服务可用性：MLB 有权随时调整或关闭公共API端点