baseball
获取 MLB 比赛时间表、实时比赛状态、比分、球员搜索和赛季 通过 MLB Stats API 进行统计。当用户询问棒球比赛时使用， 比分、今天谁在比赛、比赛结果、实时更新、投球比赛、 MLB 赛程信息、球员查找或球员统计数据。
安装 / 下载方式
TotalClaw CLI推荐
totalclaw install totalclaw:totalclaw~khaney64-baseballcURL直接下载，无需登录
curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~khaney64-baseball/file -o khaney64-baseball.md## 概述（中文）
获取 MLB 比赛时间表、实时比赛状态、比分、球员搜索和赛季
通过 MLB Stats API 进行统计。当用户询问棒球比赛时使用，
比分、今天谁在比赛、比赛结果、实时更新、投球比赛、
MLB 赛程信息、球员查找或球员统计数据。
## 原文
# Baseball — MLB Game Tracker
Fetch real-time MLB game schedules, live game status, box scores, player search, and season statistics via the MLB Stats API.
## Quick Start
```bash
# List today's games
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games
# Live game status for the Phillies
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live PHI
# Box score for a specific game
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score 718415
# Box score for last Tuesday's Phillies game
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI --date 02/15/2026
# Search for a player
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Judge
# Search with team filter
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Wheeler --team PHI
# Player season stats by ID
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats 592450
# Player season stats by name
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats Aaron Judge --season 2025
```
## Usage
### List Teams
```bash
# Show all team abbreviations
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py teams
```
### List Games
```bash
# Today's games
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games
# Games on a specific date
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --date 09/15/2025
# Next 7 days of games
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --days 7
# Upcoming week for a specific team
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --team PHI --days 7
# Filter by team
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --team PHI
# JSON output
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --format json
```
### Live Game Status
Show live count, runners, batter/pitcher matchup, and line score for an in-progress game.
```bash
# By team abbreviation (finds today's game)
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live PHI
# By game PK
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live 718415
# Game status from a specific date
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live NYY --date 02/10/2026
# JSON output
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live PHI --format json
```
### Box Score
Show the line score for any game (in-progress or final).
```bash
# By team abbreviation (today's game)
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI
# By game PK (works for any game, past or present)
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score 718415
# By team abbreviation for a past date
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI --date 02/15/2026
# JSON output
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI --format json
```
### Search Players
```bash
# Search by last name
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Judge
# Search by full name
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Aaron Judge
# Filter by team
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Wheeler --team PHI
# JSON output
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Judge --format json
```
### Player Stats
```bash
# By player ID (from player search results)
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats 592450
# By player name (auto-resolves if unique match)
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats Aaron Judge
# Specific season
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats Aaron Judge --season 2024
# JSON output
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats 592450 --format json
```
## Output Format
### Text (Default)
**games:**
```
MLB Games - 09/15/2025
Away Record Home Record Time Status Game ID
-----------------------------------------------------------------------------------------------
PHI Phillies 85-62 NYM Mets 80-67 7:10 PM In Progress 718415
BOS Red Sox 72-75 TB Rays 78-69 6:40 PM Final (5-3) 718420
```
**live:**
```
PHI Phillies 3 @ NYM Mets 5
Top 6th | 1 out | 2-1 count
Bases: 1B [X] 2B [ ] 3B [X]
AB: Kyle Schwarber vs P: Sean Manaea
Last: Trea Turner singled on a line drive to left field.
1 2 3 4 5 6 7 8 9 R H E
PHI 0 1 0 2 0 0 - - - 3 7 1
NYM 2 0 0 1 2 0 - - - 5 9 0
```
**score:**
```
Final: PHI Phillies 6 @ NYM Mets 4
1 2 3 4 5 6 7 8 9 R H E
PHI 0 1 0 2 0 0 2 0 1 6 11 0
NYM 2 0 0 1 2 0 0 0 0 4 9 1
```
**player:**
```
Player Search: "Judge"
ID Name Pos Team # B/T Age
--------------------------------------------------------------------------------
592450 Aaron Judge RF NYY Yankees 99 R/R 33
```
**stats (batting):**
```
Aaron Judge #99 RF | New York Yankees | R/R | Age 33
2025 Season Batting Statistics
G AB R H 2B 3B HR RBI SB BB K AVG OBP SLG OPS
152 541 137 179 30 2 53 114 12 124 160 .331 .457 .688 1.145
```
**stats (pitching):**
```
Zack Wheeler #45 P | Philadelphia Phillies | L/R | Age 35
2025 Season Pitching Statistics
G GS W L ERA IP H R ER HR SO BB SV HLD WHIP K/9 BB/9
30 30 14 6 2.85 198.1 155 68 63 18 210 42 0 0 0.99 9.55 1.91
```
### JSON
```json
{
"date": "09/15/2025",
"games": [
{
"game_pk": 718415,
"status": "In Progress",
"away_team": {"id": 143, "name": "Philadelphia Phillies", "abbreviation": "PHI"},
"home_team": {"id": 121, "name": "New York Mets", "abbreviation": "NYM"},
"away_record": "85-62",
"home_record": "80-67",
"away_score": 3,
"home_score": 5,
"venue": "Citi Field",
"start_time": "2025-09-15T19:10:00-04:00"
}
]
}
```
**player search (JSON):**
```json
{
"query": "Judge",
"players": [
{
"id": 592450,
"full_name": "Aaron Judge",
"position": "RF",
"position_name": "Right Fielder",
"primary_number": "99",
"bats": "R",
"throws": "R",
"age": 33,
"team": "New York Yankees",
"team_abbreviation": "NYY",
"active": true
}
]
}
```
## Output Fields
- **game_pk** — Unique MLB game identifier
- **status** — Game state: Scheduled, Pre-Game, Warmup, In Progress, Final, Postponed, etc.
- **away_team / home_team** — Team id, full name, and abbreviation
- **away_record / home_record** — Win-loss record (schedule only)
- **away_score / home_score** — Current or final score
- **inning / inning_half** — Current inning number and half (Top/Bottom)
- **balls / strikes / outs** — Current count
- **runners** — Base occupancy: first, second, third (true/false)
- **matchup** — Current batter and pitcher names
- **last_play** — Description of the last completed play
- **line_score** — Inning-by-inning runs with R/H/E totals
- **venue** — Ballpark name
- **start_time** — Scheduled start in local time