Baseball_知识管理 skill-PHP中文网

Baseball

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过MLB Stats API获取赛程、实时比分、技术统计、球员搜索及赛季数据。适用于用户询问棒球比赛相关问题时使用。

棒球——MLB游戏追踪器.

功能概述

棒球——MLB游戏追踪器.是一项面向实际任务的技能，主要用于Fetch实时MLB游戏时刻表,现场游戏状态,盒数,玩家搜索,以及季统计通过MLB Stats API.；XQ快速启动.；

核心要点

List Teams.；
List Games.；
Live Ga.。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

结果检查与注意事项

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

棒球 — MLB 比赛追踪器

通过 MLB Stats API 获取实时 MLB 赛程、比赛进行状态、技术统计（Box Score）、球员搜索及赛季统计数据。

快速开始

# 列出今日比赛
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games

# 费城费城人队（PHI）当前比赛状态
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live PHI

# 特定比赛的技术统计
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score 718415

# 上周二费城人队比赛的技术统计
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI --date 02/15/2026

# 搜索球员
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Judge

# 带球队筛选的球员搜索
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Wheeler --team PHI

# 按球员 ID 查询赛季统计数据
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats 592450

# 按球员姓名查询赛季统计数据
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats Aaron Judge --season 2025

使用方法

列出球队

# 显示全部球队缩写
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py teams

列出比赛

# 今日比赛
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games

# 指定日期的比赛
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --date 09/15/2025

# 未来 7 天的比赛
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --days 7

# 特定球队未来一周赛程
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --team PHI --days 7

# 按球队筛选
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --team PHI

# JSON 格式输出
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py games --format json

实时比赛状态

显示正在进行中的比赛的当前局数与出局数、垒上跑垒员情况、击球员与投手对战信息，以及逐局得分表（Line Score）。

# 通过球队缩写（默认查找今日该队比赛）
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live PHI

# 通过比赛 PK（game_pk）
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live 718415

# 查询指定日期的比赛状态
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live NYY --date 02/10/2026

# JSON 格式输出
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py live PHI --format json

技术统计（Box Score）

显示任意比赛（进行中或已结束）的逐局得分表（Line Score）。

# 通过球队缩写（默认为今日该队比赛）
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI

# 通过比赛 PK（适用于任何过去或当前比赛）
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score 718415

# 通过球队缩写并指定历史日期
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI --date 02/15/2026

# JSON 格式输出
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py score PHI --format json

球员搜索

# 按姓氏搜索
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Judge

# 按全名搜索
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Aaron Judge

# 按球队筛选
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Wheeler --team PHI

# JSON 格式输出
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py player Judge --format json

球员统计数据

# 按球员 ID（来自球员搜索结果）
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats 592450

# 按球员姓名（若唯一匹配则自动解析）
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats Aaron Judge

# 指定赛季
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats Aaron Judge --season 2024

# JSON 格式输出
python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py stats 592450 --format json

输出格式

文本格式（默认）

games：

MLB 比赛 — 09/15/2025
客场              战绩       主场              战绩       时间       状态                 比赛 ID
-----------------------------------------------------------------------------------------------
PHI 费城人队      85-62      NYM 纽约大都会队  80-67      7:10 PM    进行中               718415
BOS 波士顿红袜队  72-75      TB 坦帕湾光芒队   78-69      6:40 PM    结束（5-3）          718420

live：

PHI 费城人队 3  @  NYM 纽约大都会队 5
  上半局第 6 局  |  1 个出局  |  2-1 球数
  垒上情况：一垒 [X]  二垒 [ ]  三垒 [X]
  当前打席：Kyle Schwarber  vs  投手：Sean Manaea
  上一球：Trea Turner 击出左外野平飞安打。

       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：

结束：PHI 费城人队 6  @  NYM 纽约大都会队 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：

球员搜索："Judge"
ID         姓名                      位置   球队                 号码    击球/投球   年龄
--------------------------------------------------------------------------------
592450     Aaron Judge               RF    NYY 纽约洋基队         99    R/R   33

stats（打击数据）：

Aaron Judge  #99  RF  |  纽约洋基队  |  R/R  |  33 岁
2025 赛季打击统计数据
  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（投球数据）：

Zack Wheeler  #45  P  |  费城费城人队  |  L/R  |  35 岁
2025 赛季投球统计数据
  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 格式

{
  "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"
    }
  ]
}

球员搜索（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
    }
  ]
}

输出字段说明

game_pk — MLB 比赛唯一标识符
status — 比赛状态：Scheduled（已安排）、Pre-Game（赛前）、Warmup（热身）、In Progress（进行中）、Final（结束）、Postponed（延期）等
away_team / home_team — 球队 ID、全称及缩写
away_record / home_record — 胜负战绩（仅限 games 输出）
away_score / home_score — 当前或最终比分
inning / inning_half — 当前局数及半局（Top/Bottom）
balls / strikes / outs — 当前球数、好球数与出局数
runners — 垒上情况：一垒、二垒、三垒（true/false）
matchup — 当前击球员与投手姓名
last_play — 上一完成动作的描述
line_score — 逐局得分及 R/H/E 总计
venue — 球场名称
start_time — 计划开赛时间（本地时区，ISO 8601 格式）
id — MLB 球员唯一标识符（可用于 stats 命令）
full_name — 球员全名
position — 位置缩写（如 RF、P、C、SS 等）
primary_number — 球衣号码
bats / throws — 击球侧与投球手（R、L、S）
batting — 赛季打击数据（AVG、OBP、SLG、OPS、HR、RBI 等）
pitching — 赛季投球数据（ERA、胜场、败场、WHIP、三振数等）

球队缩写列表

运行 python3 /home/claw/.openclaw/workspace/skills/baseball/scripts/baseball.py teams 可列出全部缩写。亦支持部分球队全名（例如 “Phillies”、“Dodgers”、“Red Sox”）。

ARI、ATL、BAL、BOS、CHC、CWS、CIN、CLE、COL、DET、HOU、KC、LAA、LAD、MIA、MIL、MIN、NYM、NYY、OAK、PHI、PIT、SD、SF、SEA、STL、TB、TEX、TOR、WSH

注意事项

数据来源于 MLB Stats API，请参阅相关版权说明。
MLB Stats API 免费开放，无需 API Key 或身份验证。请勿滥用：高频轮询、批量爬取等行为可能导致您的 IP 被封禁。在监控实时比赛时，请确保轮询间隔不少于 15 秒一次。
live 和 score 命令均接受数字形式的 game PK 或球队缩写。使用缩写时，脚本会查找当日赛程以定位该队比赛；如需查询其他日期，请使用 --date MM/DD/YYYY 参数。
games 的文本输出包含“比赛 ID”列，可将该 ID 用于 score 或 live 命令以精确查看某场比赛——尤其适用于双赛（doubleheader）场景，此时单靠球队缩写可能产生歧义。
player 命令仅搜索现役 MLB 球员。请使用搜索结果中返回的球员 ID 配合 stats 查看其赛季统计数据。
stats 命令支持输入数字型球员 ID 或球员姓名。若姓名匹配多个球员，系统将提示您选择具体 ID。
休赛期可使用 --season 参数查看往年数据（例如 --season 2025）。