? 第一步:环境准备与安装
- 访问 Node.js 官网(nodejs.org),根据系统下载对应安装包。安装时记得勾选 “Add to PATH”,这样就能在命令行直接用了。
- 安装完后,打开终端输入
node -v和npm -v,要是能显示版本号,就说明安装成功了。
在终端输入
npm install -g play-a-ball,等着 npm 把依赖包都下载安装好。要是遇到权限问题,在命令前加个sudo试试(Linux/macOS 系统)。? 第二步:获取 MLB API 密钥
- 打开浏览器,访问the-odds-api.com,点击 “Sign Up” 注册账号。
- 登录后,在 “Dashboard” 里找到 “API Key”,把它复制下来。
- 在终端输入
play-a-ball config set api-key YOUR_API_KEY,把 YOUR_API_KEY 换成你的实际密钥。
- 去 SportRadar 的开发者网站(developer.sportradar.com)注册。
- 申请 MLB API 的访问权限,审核通过后会收到密钥。
- 同样在终端输入配置命令,把密钥存到 Play-a-ball 里。
? 第三步:基础操作与实时查询
play-a-ball 就能启动工具。启动后默认显示当天的比赛,包括对阵双方、时间和场地。要是想查看其他日期,输入
play-a-ball --date YYYY-MM-DD,比如 play-a-ball --date 2025-07-05 就能看 7 月 5 日的赛程。输入
play-a-ball --team TEAM_NAME,比如 play-a-ball --team Yankees,就能只显示洋基队的比赛。支持输入球队全称或者缩写,系统会自动匹配。看比赛的时候,按
R 键就能刷新比分。要是想自动刷新,输入 play-a-ball --auto-refresh 30,这样每 30 秒就会自动更新一次。? 第四步:个性化配置与界面优化
输入
play-a-ball config set color.theme dark 可以切换到深色主题,或者 play-a-ball config set color.team Yankees red 把洋基队的颜色设为红色。具体颜色代码可以参考终端颜色表。在配置文件里(通常在用户目录的.play-a-ball 文件夹),可以调整显示的信息顺序,比如先显示比分再显示球队数据。保存后重启 Play-a-ball 就能生效。
⚙️ 第五步:高级技巧与效率提升
在终端配置文件(比如.bashrc 或.zshrc)里添加别名,比如
alias mlb="play-a-ball --team Dodgers",以后输入 mlb 就能直接查看道奇队的比赛。输入
play-a-ball --export csv 可以把赛程数据导出为 CSV 文件,方便用 Excel 分析。或者用 --export json 导出 JSON 格式,供其他程序使用。输入
play-a-ball --notify "Giants vs Dodgers starts in 10 minutes",比赛开始前 10 分钟就会收到通知。需要先安装系统的通知工具,比如 Linux 的 notify-send。?️ 常见问题与解决方法
检查密钥是否正确,有没有过期。可以登录 API 提供商的网站,在控制台里重新生成一个。
这可能是字符编码的问题。在终端输入
export LANG=en_US.UTF-8,或者在 Play-a-ball 的配置文件里设置 encoding: utf-8。先检查网络连接,再看看 API 提供商的状态页面,有没有服务中断的情况。