wnba-data

Original：🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

WNBA data via ESPN public endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, win probability, injuries, transactions, futures, team/player stats, leaders, and news. Zero config, no API keys. Use when: user asks about WNBA scores, standings, team rosters, schedules, game stats, box scores, play-by-play, injuries, transactions, betting futures, team/player statistics, or WNBA news. Don't use when: user asks about NBA (use nba-data), college basketball (use cbb-data), or other sports.

2installs
Sourcemachina-sports/sports-skills
Added on

NPX Install

npx skill4agent add machina-sports/sports-skills wnba-data

Tags

Translated version includes tags in frontmatter
wnba-dataespn-public-endpointssports-statisticscli-tooldata-retrieval

SKILL.md Content

View Translation Comparison →

WNBA Data

Setup

Before first use, check if the CLI is available:
bash
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:
bash
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:
bash
sports-skills wnba get_scoreboard
sports-skills wnba get_standings --season=2025
sports-skills wnba get_teams

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
    (most recently completed season).
  • Never hardcode a season. Always derive it from the system date.

Commands

get_scoreboard

Get live/recent WNBA scores.
  • date
    (str, optional): Date in YYYY-MM-DD format. Defaults to today.
Returns 
events[]
with game info, scores, status, and competitors.

get_standings

Get WNBA standings by conference.
  • season
    (int, optional): Season year
Returns 
groups[]
with Eastern/Western conferences and team standings including W-L, PCT, GB, and streak.

get_teams

Get all WNBA teams. No parameters.
Returns 
teams[]
with id, name, abbreviation, logo, and location.

get_team_roster

Get full roster for a team.
  • team_id
    (str, required): ESPN team ID (e.g., "5" for Las Vegas Aces)
Returns 
athletes[]
with name, position, jersey number, height, weight, experience.

get_team_schedule

Get schedule for a specific team.
  • team_id
    (str, required): ESPN team ID
  • season
    (int, optional): Season year
Returns 
events[]
with opponent, date, score (if played), and venue.

get_game_summary

Get detailed box score and scoring plays.
  • event_id
    (str, required): ESPN event ID
Returns 
game_info
, 
competitors
, 
boxscore
(stats per player), 
scoring_plays
, and 
leaders
.

get_leaders

Get WNBA statistical leaders (points, rebounds, assists, etc.).
  • season
    (int, optional): Season year. Defaults to most recently completed season.
Returns 
categories[]
with leader rankings per stat category.

get_news

Get WNBA news articles.
  • team_id
    (str, optional): Filter by team
Returns 
articles[]
with headline, description, published date, and link.

get_play_by_play

Get full play-by-play data for a game.
  • event_id
    (str, required): ESPN event ID
Returns play-by-play detail including period, clock, team, play description, and scoring plays.

get_win_probability

Get win probability chart data for a game.
  • event_id
    (str, required): ESPN event ID
Returns timestamped home/away win probability percentages throughout the game.

get_schedule

Get WNBA schedule for a specific date or season.
  • date
    (str, optional): Date in YYYY-MM-DD format
  • season
    (int, optional): Season year (used only if no date provided)
Returns 
events[]
for the specified date.

get_injuries

Get current WNBA injury reports across all teams. No parameters.
Returns 
teams[]
with per-team injury lists including player name, position, status, injury type, and detail.

get_transactions

Get recent WNBA transactions (trades, signings, waivers).
  • limit
    (int, optional): Max transactions to return. Defaults to 50.
Returns 
transactions[]
with date, team, and description.

get_futures

Get WNBA futures/odds markets (Championship winner, MVP, etc.).
  • limit
    (int, optional): Max entries per market. Defaults to 25.
  • season_year
    (int, optional): Season year. Defaults to current.
Returns 
futures[]
with market name and entries (team/player name + odds value).

get_team_stats

Get full team statistical profile for a season.
  • team_id
    (str, required): ESPN team ID
  • season_year
    (int, optional): Season year. Defaults to current.
  • season_type
    (int, optional): 2=regular (default), 3=postseason.
Returns 
categories[]
with detailed stats including value, rank, and per-game averages.

get_player_stats

Get full player statistical profile for a season.
  • player_id
    (str, required): ESPN athlete ID
  • season_year
    (int, optional): Season year. Defaults to current.
  • season_type
    (int, optional): 2=regular (default), 3=postseason.
Returns 
categories[]
with detailed stats including value, rank, and per-game averages.

Team IDs (Common)

TeamID
Atlanta Dream3
Chicago Sky4
Connecticut Sun6
Dallas Wings8
Indiana Fever5
Las Vegas Aces9
Los Angeles Sparks14
Minnesota Lynx16
New York Liberty17
Phoenix Mercury21
Seattle Storm26
Washington Mystics30

Examples

User: "What are today's WNBA scores?"
bash
sports-skills wnba get_scoreboard
User: "Show me the WNBA standings"
bash
sports-skills wnba get_standings --season=2025
User: "Who's on the Indiana Fever roster?"
bash
sports-skills wnba get_team_roster --team_id=5
User: "Show me WNBA statistical leaders"
bash
sports-skills wnba get_leaders --season=2025
User: "Who's injured in the WNBA?"
bash
sports-skills wnba get_injuries
User: "What are the WNBA championship odds?"
bash
sports-skills wnba get_futures --limit=10
User: "Show me A'ja Wilson's stats"
bash
sports-skills wnba get_player_stats --player_id=3149391

Error Handling

When a command fails, do not surface raw errors to the user. Instead:
  1. Catch silently and try alternatives
  2. If team name given instead of ID, use 
    get_teams
    to find the ID first
  3. Only report failure with a clean message after exhausting alternatives

Troubleshooting

  • sports-skills
    command not found    : Run 
    pip install sports-skills
  • Team not found: Use 
    get_teams
    to list all teams and find the correct ID
  • No data for future games: ESPN only returns data for completed or in-progress games
  • Offseason (Nov–Apr): 
    get_scoreboard
    returns 0 events — expected. Use 
    get_standings --season=2025
    or 
    get_news
    instead.