# Team stats

**Job:** `NFL: team season stats` — 7:40 ET daily.
**Command:** `football_sync team_stats [--season YYYY]`

nflverse's `stats_team_reg_<season>.csv` holds regular-season totals for all 32
teams: passing, rushing, receiving, defense, returns, kicking, punting,
penalties. One `TeamSeasonStats` row per team per season stores:

- typed headline columns (total / passing / rushing yards and TDs, first downs,
  turnovers, sacks allowed, sacks, takeaways, interceptions, tackles for loss,
  penalties, penalty yards) for lists, filters and the API's aggregates;
- `stats`: every nflverse column, numeric;
- `ranks`: the 1–32 league rank for each of those stats, 1 = best. Stats where
  less is better (turnovers, sacks allowed, penalties, fumbles…) rank ascending.

Staff pages at `/football/team-stats/`; REST at `/api/football/team-stats/`
(`?season=2026&ordering=-total_yards`); MCP tools likewise. Conference and
division comparisons are a filter away: join on the team's conference.

