cfb-data

College Open source · MIT Read-only 22 commands 658 installs

College Football (CFB) data via ESPN public endpoints and the NCAA's official endpoints — scores, standings, rosters, schedules, game summaries, play-by-play, rankings, injuries, futures, team/player stats, and news for FBS, plus official FCS scoreboards, NCAA game detail with drive context, and the schools index. Zero config, no API keys.

View source

Commands 22

get_scoreboard
[--date][--week][--group][--limit]

Live/recent college football scores

get_standings
[--season][--group]

Standings by conference (use group parameter)

get_teams

All 750+ FBS college football teams

get_team_roster
--team_id

Full roster for a team

get_team_schedule
--team_id[--season][--season_type]

Schedule for a specific team

get_game_summary
--event_id

Detailed box score and scoring plays

get_rankings
[--season][--week]

AP Top 25, Coaches Poll, CFP rankings

get_news
[--team_id]

College football news

get_play_by_play
--event_id

Full play-by-play for a game

get_win_probability
--event_id

Win probability timeline for a completed game

get_schedule
[--season][--week][--group]

Season schedule by week

get_injuries

Injury reports across all teams

get_futures
[--limit][--season_year]

Futures/odds markets (National Championship, Heisman, etc.)

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_ncaa_scoreboard
--week[--division][--season]

Official NCAA scoreboard — FBS and FCS

get_ncaa_schedule
[--division][--season]

Which weeks have games (official index)

get_ncaa_game
--game_id

Official NCAA game information

get_ncaa_boxscore
--game_id

Official NCAA box score

get_ncaa_play_by_play
--game_id[--limit]

Official play-by-play with drive context

get_ncaa_scoring_summary
--game_id

Official scoring summary

get_ncaa_schools
[--query]

NCAA schools index (all divisions)

Example Prompts

  • What are the college football rankings?
  • Show me SEC football standings
  • What's Alabama's schedule this season?
  • Show me this week's college football scores
  • Who's the Heisman favorite?

Quick Start

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