WNBA 数据 API 与 CLI 工具 - 获取比分、排名、赛程、球员统计等

wnba-data by machina-sports/sports-skills

114 周安装量

65 GitHub Stars

GitHub

安装命令

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

数据分析体育 API

🇨🇳中文介绍

WNBA 数据

在编写查询之前，请查阅 references/api-reference.md 以了解端点、ID 约定和数据形状。

设置

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

which sports-skills || pip install sports-skills

如果 pip install 因 Python 版本错误而失败，该包需要 Python 3.10+。请找到兼容的 Python 版本：

python3 --version  # 检查版本
# 如果版本 < 3.10，尝试：python3.12 -m pip install sports-skills
# 在 macOS 上使用 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

关键：执行任何查询前

关键：在调用任何数据端点之前，请验证：

赛季年份来源于系统提示中的 —— 切勿硬编码。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

145,500 周安装

专业SEO审计工具：全面网站诊断、技术SEO优化与页面分析指南

70,100 周安装

Python PDF处理教程：合并拆分、提取文本表格、创建PDF文件

66,200 周安装

如果只提供了球队名称，请在使用特定球队的命令之前，先调用 get_teams 来解析球队 ID。

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

如果用户指定了赛季，则按原样使用。
如果用户说“当前”、“本赛季”或未指定：WNBA 赛季在五月至十月进行。如果当前月份是五月至十月，则使用 season = current_year。如果是十一月至四月（休赛期），则使用 season = current_year - 1。

命令	描述
`get_scoreboard`	实时/最近的 WNBA 比分
`get_standings`	按赛区排列的排名
`get_teams`	所有 WNBA 球队
`get_team_roster`	球队的完整阵容名单
`get_team_schedule`	特定球队的赛程
`get_game_summary`	详细的比赛统计和得分过程
`get_leaders`	WNBA 数据领先者
`get_news`	WNBA 新闻文章
`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：今日比分用户说："What are today's WNBA scores?" 操作：

调用 get_scoreboard() 结果：所有实时和最近的 WNBA 比赛，包含比分和状态

示例 2：排名用户说："Show me the WNBA standings" 操作：

从 currentDate 推导赛季年份
调用 get_standings(season=<derived_year>) 结果：东部和西部赛区排名，包含胜-负、胜率、胜场差

示例 3：球队阵容用户说："Who's on the Indiana Fever roster?" 操作：

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

示例 4：数据领先者用户说："Show me WNBA statistical leaders" 操作：

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

示例 5：冠军赔率用户说："What are the WNBA championship odds?" 操作：

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

示例 6：球员数据用户说："Show me A'ja Wilson's stats" 操作：

从 currentDate 推导赛季年份
调用 get_player_stats(player_id="3149391", season_year=<derived_year>) 结果：按类别划分的赛季数据，包含数值、排名和场均平均值

不存在的命令 —— 切勿调用这些

~~get_odds~~ / ~~get_betting_odds~~ —— 不可用。对于预测市场赔率，请使用 polymarket 或 kalshi 技能。
~~search_teams~~ —— 不存在。请改用 get_teams。
~~get_box_score~~ —— 不存在。请改用 get_game_summary。
~~get_player_ratings~~ —— 不存在。请改用 get_player_stats。

如果某个命令未在上面的命令表中列出，则它不存在。

当命令失败时，不要向用户显示原始错误信息。而是：

静默捕获错误并尝试替代方案
如果给出的是球队名称而非 ID，请先使用 get_teams 查找 ID
只有在尝试所有替代方案后，才用简洁的消息报告失败

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

错误：按 ID 未找到球队原因：使用了错误或过时的 ESPN 球队 ID 解决方案：调用 get_teams 获取当前所有 WNBA 球队及其 ID 的列表

错误：未来比赛无数据返回原因：ESPN 只返回已完成或正在进行的比赛数据解决方案：使用 get_schedule 查看即将到来的比赛详情；get_scoreboard 仅涵盖活动/最近的比赛

错误：休赛期（十一月至四月）—— 比分板返回 0 个事件原因：休赛期没有比赛安排解决方案：改用 get_standings(season=<prior_year>) 或 get_news

🇺🇸English

WNBA Data

Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes.

Setup

Before first use, check if the CLI is available:

which sports-skills || pip install sports-skills

If pip install fails with a Python version error, the package requires Python 3.10+. Find a compatible 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

No API keys required.

Quick Start

Prefer the CLI — it avoids Python import path issues:

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

CRITICAL: Before Any Query

CRITICAL: Before calling any data endpoint, verify:

Season year is derived from the system prompt's currentDate — never hardcoded.
If only a team name is provided, call get_teams to resolve the team ID before using team-specific commands.

Choosing the Season

Derive the current year from the system prompt's date (e.g., currentDate: 2026-02-18 → current year is 2026).

If the user specifies a season , use it as-is.
If the user says "current", "this season", or doesn't specify : The WNBA season runs May–October. If the current month is May–October, use season = current_year. If November–April (offseason), use season = current_year - 1.

Commands

Command	Description
`get_scoreboard`	Live/recent WNBA scores
`get_standings`	Standings by conference
`get_teams`	All WNBA teams
`get_team_roster`	Full roster for a team
`get_team_schedule`	Schedule for a specific team
`get_game_summary`	Detailed box score and scoring plays

See references/api-reference.md for full parameter lists and return shapes.

Examples

Example 1: Today's scores User says: "What are today's WNBA scores?" Actions:

Call get_scoreboard() Result: All live and recent WNBA games with scores and status

Example 2: Standings User says: "Show me the WNBA standings" Actions:

Derive season year from currentDate
Call get_standings(season=<derived_year>) Result: Eastern and Western conference standings with W-L, PCT, GB

Example 3: Team roster User says: "Who's on the Indiana Fever roster?" Actions:

Call get_team_roster(team_id="5") Result: Full Indiana Fever roster with name, position, jersey number

Example 4: Statistical leaders User says: "Show me WNBA statistical leaders" Actions:

Derive season year from currentDate
Call get_leaders(season=<derived_year>) Result: Leaders ranked by stat category (points, rebounds, assists, etc.)

Example 5: Championship odds User says: "What are the WNBA championship odds?" Actions:

Call get_futures(limit=10) Result: Top WNBA championship contenders with odds values

Example 6: Player statistics User says: "Show me A'ja Wilson's stats" Actions:

Derive season year from currentDate
Call get_player_stats(player_id="3149391", season_year=<derived_year>) Result: Season stats by category with value, rank, and per-game averages

Commands that DO NOT exist — never call these

~~get_odds~~ / ~~get_betting_odds~~ — not available. For prediction market odds, use the polymarket or kalshi skill.
~~search_teams~~ — does not exist. Use get_teams instead.
~~get_box_score~~ — does not exist. Use get_game_summary instead.
~~get_player_ratings~~ — does not exist. Use get_player_stats instead.

If a command is not listed in the Commands table above, it does not exist.

Error Handling

When a command fails, do not surface raw errors to the user. Instead:

Catch silently and try alternatives
If team name given instead of ID, use get_teams to find the ID first
Only report failure with a clean message after exhausting alternatives

Troubleshooting

Error: sports-skills command not found Cause: Package not installed Solution: Run pip install sports-skills

Error: Team not found by ID Cause: Wrong or outdated ESPN team ID used Solution: Call get_teams to get the current list of all WNBA teams with their IDs

Error: No data returned for a future game Cause: ESPN only returns data for completed or in-progress games Solution: Use get_schedule to see upcoming game details; get_scoreboard only covers active/recent games

Error: Offseason (November–April) — scoreboard returns 0 events Cause: No games scheduled during the offseason Solution: Use get_standings(season=<prior_year>) or get_news instead

Weekly Installs

Repository

machina-sports/…s-skills

GitHub Stars

First Seen

Feb 18, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex82

opencode81

gemini-cli80

cursor80

github-copilot78

amp76

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

52,800 周安装