Nfl Scores
Real NFL game scores, schedules, standings, and team reference data from ESPN's public, unauthenticated endpoints. Complements @dougschaefer/sleeper (fantasy league state) — this model reads the actual games, not fantasy rosters.
Three read-only methods: scoreboard (games for a week, defaults to the current week), standings (conference/division standings for a season), and teams (factory method — one resource per NFL team). Host-locked to site.api.espn.com and cdn.espn.com, no auth or secrets required.
Quick Start
bash swamp extension pull @hmcrum/nfl-scores swamp model create @hmcrum/nfl-scores nfl swamp model method run nfl scoreboard swamp model method run nfl scoreboard --input week=5 --input seasonType=regular swamp model method run nfl standings swamp model method run nfl teams
Global Arguments
| Argument | Type | Description |
|---|---|---|
| userAgent | string | User-Agent sent to ESPN's endpoints — identify yourself honestly |
| Argument | Type | Description |
|---|---|---|
| week? | number | Week number within the season type — omit for the current week |
| seasonType? | enum | pre, regular, or post — omit for whatever is currently in progress |
| year? | number | Season year, e.g. 2026 — omit for the current season |
| Argument | Type | Description |
|---|---|---|
| season? | number | Season year, e.g. 2025 — omit for the current season |
Resources
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned