FBS CLI

Unofficial · 71 read-only routes · agent-ready

The shortest path from question to kickoff data.

FBS CLI is an independent command line interface for CollegeFootballData. It covers all 71 GET routes in the pinned cfbd 5.21.0 client, including historical lines and team ATS records, and returns every result as clean YAML.

Start in three steps View and star on GitHub Open npm 
$ fbs games --year 2024 --week 1 --team "Florida State"

command: games
endpoint: /games
query:
  year: 2024
  week: 1
  team: Florida State
count: 1
games:
  - season: 2024
    week: 1
    matchup: Boston College at Florida State
    status: completed

Up and running in three steps.

Install the cross-platform npm package, configure your key, then make a focused first query.

01

Install the CLI

Use Node.js >=22.12.0 on Windows, macOS, or Linux. For occasional use, run it directly with npx @jvorndran/fbs-cli.

npm install --global @jvorndran/fbs-cli
02

Configure access

Request a free CFBD key, then run this command. It explains the validation and project-local save before asking for the key at a masked prompt.

fbs auth
03

Make a first call

Run fbs --help, start with teams or games, then reuse returned IDs for deeper queries.

fbs teams fbs --year 2026

One predictable surface, across every research domain.

Command families stay close to CFBD REST paths. Use built-in help for the exact flags on any of the 71 endpoint commands.

Teams & reference

teams · roster · records

Discover programs, conferences, venues, talent, calendars, rosters, historical series, and ATS records.

Games & live

games · lines · live

Find schedules and IDs, then retrieve box scores, historical provider lines, media, weather, scoreboards, and live plays.

Possessions

drives · plays

Trace possessions, play-by-play, play types, and explicit athlete-to-play stat associations.

Performance

stats · player

Query team and player production, advanced efficiency, havoc, usage, transfers, and success rates.

Analytics

ppa · metrics · wepa

Explore predicted points, win probability, field-goal EP, and opponent-adjusted team or player metrics.

History & context

ratings · recruiting · more

Cover polls, ratings, recruiting, playoffs, draft history, coaches, and returning production.

Designed for reliable handoffs

One quiet, predictable YAML document.

Successful requests write only structured YAML to stdout. Errors use the same approach on stderr, with stable codes and useful hints. The structural example is abridged.

  • Snake-case keys
  • Null values removed
  • Provider IDs preserved
  • No banners, spinners, or color codes
command: games teams
endpoint: /games/teams
query:
  id: 401752731
count: 1
games:
  - game_id: 401752731
    teams:
      - team: Florida State
        home_away: home
        stats:
          total_yards: 412
          rushing_yards: 156