mcpField
W
wnba-data

wnba-data

github.com/machina-sports数据与数据库261672 次安装今天更新
代码仓库

关于 wnba-data

wnba-data 是通过 `sports-skills` 命令行查询 WNBA 信息的 skill，涵盖比赛数据、球队与球员统计、伤病和球员交易，并说明赛季选择及球队 ID 的查询方法。

主要功能

  1. 01赛况、赛程与排名
  2. 02球队名单和统计数据
  3. 03球员统计与数据领先者
  4. 04伤病报告和球员交易
  5. 05新闻、逐回合记录与胜率

适用场景

  1. 01查询近期 WNBA 赛况
  2. 02查看球队排名或赛程
  3. 03查找球员统计数据
  4. 04检查伤病报告和球员交易

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/machina-sports/sports-skills --skill wnba-data

安装后在 Claude Code 中输入/wnba-data确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api-reference.md
team-ids.md
scripts/
validate_params.sh

详细介绍

WNBA 数据

编写查询前，请先查阅 references/api-reference.md，了解端点、ID 约定和数据结构。

设置

首次使用前，请检查 CLI 是否可用：

which sports-skills || pip install sports-skills

如果 pip install 因 Python 版本错误而失败，则说明该软件包需要 Python 3.10 或更高版本。请查找兼容的 Python 版本：

python3 --version  # check version
# If < 3.10, try: python3.12 -m pip install sports-skills
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills

无需 API 密钥。

快速开始

优先使用 CLI，可避免 Python 导入路径问题：

sports-skills wnba get_scoreboard
sports-skills wnba get_standings --season=2025
sports-skills wnba get_teams

重要：执行任何查询前

重要：调用任何数据端点前，请确认：

  • 赛季年份根据系统提示中的 currentDate 推导，绝不可硬编码。
  • 如果只提供了球队名称，先调用 get_teams 获取球队 ID，再使用针对球队的命令。

选择赛季

根据系统提示中的日期推导当前年份（例如，currentDate: 2026-02-18 → 当前年份为 2026）。

  • 如果用户指定了赛季，按原样使用。
  • 如果用户说“当前”“本赛季”或未指定赛季：WNBA 赛季从 5 月持续到 10 月。如果当前月份为 5 月至 10 月，使用 season = current_year。如果当前月份为 11 月至 4 月（休赛期），使用 season = current_year - 1。

命令

命令描述
get_scoreboardWNBA 实时和近期比分
get_standings按联盟查看排名
get_teams所有 WNBA 球队
get_team_roster某支球队的完整阵容
get_team_schedule指定球队的赛程
get_game_summary详细技术统计和得分回合
get_leadersWNBA 统计数据领先者
get_newsWNBA 新闻文章
get_play_by_play某场比赛的完整逐回合记录
get_win_probability胜率图表数据
get_schedule指定日期或赛季的赛程
get_injuries所有球队的伤病报告
get_transactions近期球员交易
get_futures期货／赔率市场
get_team_stats球队统计资料
get_player_stats球员统计资料

完整的参数列表和返回结构请参阅 references/api-reference.md。

示例

示例 1：今天的比分 用户说：“今天 WNBA 的比分是多少？” 操作：

  1. 调用 get_scoreboard() 结果：所有正在进行和近期 WNBA 比赛的比分及状态

示例 2：排名 用户说：“给我看看 WNBA 排名。” 操作：

  1. 根据 currentDate 推导赛季年份
  2. 调用 get_standings(season=<derived_year>) 结果：东部和西部联盟排名，包含胜负场数、胜率和与榜首的胜场差

示例 3：球队阵容 用户说：“印第安纳狂热队阵容有哪些人？” 操作：

  1. 调用 get_team_roster(team_id="5") 结果：印第安纳狂热队完整阵容，包含姓名、位置和球衣号码

示例 4：统计数据领先者 用户说：“给我看看 WNBA 的统计数据领先者。” 操作：

  1. 根据 currentDate 推导赛季年份
  2. 调用 get_leaders(season=<derived_year>) 结果：按统计类别排名的领先者（得分、篮板、助攻等）

示例 5：冠军赔率 用户说：“WNBA 冠军赔率是多少？” 操作：

  1. 调用 get_futures(limit=10) 结果：WNBA 冠军的热门竞争者及其赔率

示例 6：球员统计数据 用户说：“给我看看阿贾·威尔逊的统计数据。” 操作：

  1. 根据 currentDate 推导赛季年份
  2. 调用 get_player_stats(player_id="3149391", season_year=<derived_year>) 结果：按类别列出的赛季统计数据，包含数值、排名和场均数据

不存在的命令——绝不可调用

  • get_odds / get_betting_odds——不可用。要查询预测市场赔率，请使用 polymarket 或 kalshi skill。
  • search_teams——不存在。请改用 get_teams。
  • get_box_score——不存在。请改用 get_game_summary。
  • get_player_ratings——不存在。请改用 get_player_stats。

如果某个命令未列在上方的“命令”表中，则该命令不存在。

错误处理

命令失败时，不要向用户展示原始错误。请改为：

  1. 静默捕获错误并尝试其他方法
  2. 如果提供的是球队名称而非 ID，请先使用 get_teams 查找 ID
  3. 只有在尝试所有替代方法后，才用清晰的消息报告失败

故障排除

错误：找不到 sports-skills 命令
原因：未安装软件包
解决方案：运行 pip install sports-skills

错误：通过 ID 找不到球队
原因：使用了错误或过时的 ESPN 球队 ID
解决方案：调用 get_teams，获取包含 ID 的当前所有 WNBA 球队列表

错误：未返回未来比赛的数据
原因：ESPN 只返回已结束或正在进行的比赛数据
解决方案：使用 get_schedule 查看即将举行的比赛详情；get_scoreboard 只涵盖正在进行或近期的比赛

错误：休赛期（11 月至 4 月）——记分牌返回 0 场赛事
原因：休赛期没有安排比赛
解决方案：改用 get_standings(season=<prior_year>) 或 get_news

评论

支持 Markdown