nfl-data

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

NFL data via ESPN public endpoints plus an nflverse backend for schedules, weekly rosters, play-by-play, and normalized player/team stat tables. Zero config, no API keys.

View source

Commands 23

get_scoreboard

[--date][--week][--season]

Live/recent NFL scores

get_standings

[--season]

Standings by conference and division

get_teams

All 32 NFL teams

get_team_roster

--team_id

Full roster for a team

get_team_schedule

--team_id[--season]

Schedule for a specific team; reports coverage limits

get_game_summary

--event_id

Detailed box score and scoring plays

get_leaders

[--season]

NFL statistical leaders

get_news

[--team_id]

NFL news articles

get_play_by_play

--event_id

Full play-by-play for a game

get_win_probability

--event_id

Win probability chart data

get_schedule

[--season][--week]

One season week or ESPN's current window; never a whole season

get_injuries

Injury reports with provider-native or unresolved identity

get_transactions

[--limit]

Recent transactions

get_futures

[--limit][--season_year]

Futures/odds markets

get_depth_chart

--team_id

Depth chart for a team

get_team_stats

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

Team statistical profile

get_player_stats

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

Player statistical profile

get_nflverse_schedule

[--season][--week][--sort_by][--descending][--limit][--fields]

nflverse-backed schedules/results table (carries espn_event_id)

get_nflverse_weekly_rosters

[--season][--week][--team][--sort_by][--descending][--limit][--fields]

nflverse-backed weekly rosters

get_nflverse_player_stats

[--season][--player_id][--team][--position][--week][--summary_level][--sort_by][--descending][--limit][--fields]

nflverse-backed player stats — season totals by default

get_nflverse_team_stats

[--season][--team][--week][--summary_level][--sort_by][--descending][--limit][--fields]

nflverse-backed team stats — season totals by default

get_nflverse_play_by_play

[--season][--week][--team][--game_id][--sort_by][--descending][--limit][--fields]

nflverse-backed play-by-play rows

get_fantasy_trending

[--trend_type][--lookback_hours][--limit]

Sleeper fantasy trending adds/drops (popularity counts, Sleeper player IDs)

Example Prompts

What are today's NFL scores?
Show me the AFC standings
Who's on the Chiefs roster?
How did the Super Bowl go?
Who's injured on the Chiefs?

Quick Start

# CLI

sports-skills nfl get_scoreboard

# Python

from sports_skills import nfl
nfl.get_scoreboard()

nfl-data

Commands 23

Example Prompts

Quick Start

More in US Sports