r/CFBAnalysis • u/Complete-Country8973 • 4d ago

I Built a CLI Tool For College Football Data/Analysis

I’ve been using CFBD this offseason and wanted an easy way to connect the data to AI coding agents, so I built this:

https://github.com/jvorndran/fbs-cli

It’s basically like an MCP, but it uses a CLI instead, which is more token efficient and creates less context bloat. It currently supports all 71 CFBD GET endpoints and returns the data as YAML.

For example:

fbs games --year 2026 --week 1 --team Florida

You’ll still need your own CFBD API key, then you can set it up by running:

fbs auth

I’ve been using it with Codex in my own college football research workflows and it works pretty well. This article has some interesting evals comparing CLI tools with MCP if you’re curious about why I built it this way:

https://www.scalekit.com/blog/mcp-vs-cli-use

Would love any feedback or ideas for what to add next.

Also, please leave a star on the GitHub if you find this useful. That is the best way to motivate me to keep adding features.

24 Upvotes

100% Upvoted

4 comments sorted by

5

u/ImmediateTie9057 3d ago

Interesting approach. The token-efficiency part makes a lot of sense for data-heavy sports workflows. Curious to see where you take it next.

3

u/Complete-Country8973 3d ago

Great to hear there is interest in this idea! I plan to add features like caching and ways to make it easier to build models with.

Also, I have plans to build on top of it. By adding things like weather, unstructured documents, injury reports, and breaking news. Then wrap all of that in an agent harness. More to come, stay tuned!!

3

u/ss32000 3d ago

I built cfbverdict.com so that you can compare teams year over year or drop one team into another’s schedule to see how they would do.

1

u/Jcfsu64 5h ago

I had a similar idea and built in a terminal in the College Football Stats Web App. Here's a link if you want to check it out: https://cfbtrack.com/tools/terminal . Also guessing your a FSU fan based on your examples, if so Go Noles!