nhl-data

US Sports Open source · MIT Read-only 23 commands 651 installs

NHL data via ESPN public endpoints and the official NHL API — scores, standings, rosters, schedules, game summaries, injuries, futures, leaders, and news, plus an analytics backend: play-by-play with on-ice coordinates, cross-league career rows, skater/goalie leaders, and history to 1917. Zero config, no API keys.

View source

Commands 23

get_scoreboard
[--date]

Live/recent NHL scores

get_standings
[--season]

Standings by conference and division

get_teams

All NHL teams

get_team_roster
--team_id

Full roster for a team

get_team_schedule
--team_id[--season]

Schedule for a specific team

get_game_summary
--event_id

Detailed box score and scoring plays

get_leaders
[--season]

NHL statistical leaders

get_news
[--team_id]

NHL news articles

get_play_by_play
--event_id

Full play-by-play for a game

get_schedule
[--date][--season]

Games on a specific date (no season filter; see get_team_schedule)

get_injuries

Injury reports across all teams

get_transactions
[--limit]

Recent transactions

get_futures
[--limit][--season_year]

Futures/odds markets

get_team_stats
--team_id[--season_year][--season_type]

Team statistical profile

get_player_stats
--player_id[--season_year][--season_type]

Player statistical profile

find_nhl_player
--name

Search the NHL's player registry by name

get_nhlstats_schedule
[--date][--season][--team]

Games via the NHL API — team seasons to the Original Six era, NHL game ids

get_nhlstats_player_stats
[--player_id][--player]

Career season-by-season across leagues via NHL API

get_nhlstats_player_game_log
[--player_id][--player][--season][--season_type][--sort_by][--descending][--limit][--fields]

One player's games in a season (opponent, home/away, result, stat line) via NHL API

get_nhlstats_play_by_play
--game_id[--limit]

Play-by-play with on-ice x/y coordinates, zone, shot type

get_nhlstats_boxscore
--game_id

Full box score (skaters + goalies) via NHL API

get_nhlstats_standings
[--date]

Standings, current or any historical date (back to 1917)

get_nhlstats_leaders
[--category][--position][--season][--season_type][--limit]

Skater and goalie leaders by category

Example Prompts

  • What are today's NHL scores?
  • Show me the Eastern Conference standings
  • Who's on the Maple Leafs roster?
  • Show me the full box score for last night's Bruins game
  • What are the Stanley Cup odds?

Quick Start

# CLI
sports-skills nhl get_scoreboard
# Python
from sports_skills import nhl
nhl.get_scoreboard()