fifa-world-cup-cli

Live scores, standings, fixtures, results, and player stats for FIFA World Cup 2026 — right in your terminal.

No API key required. Powered by ESPN's public soccer JSON endpoints.

Install

npm install -g fifa-world-cup-cli

Usage

fifa-wc live                        Live World Cup scores
fifa-wc today                       Today's matches
fifa-wc fixtures                    Upcoming fixtures
fifa-wc fixtures --next 10          Show next 10 upcoming matches
fifa-wc results                     Past match results (most recent first)
fifa-wc results --team BR           Results for a team (ISO code or name)
fifa-wc results --group A           Results for Group A
fifa-wc standings                   Group standings tables
fifa-wc scorers                     Top scorers / assists / clean sheets
fifa-wc scorers --next 5            Show top 5 per stat category
fifa-wc favorite                    View current favorite team
fifa-wc favorite set BR             Set favorite by ISO code
fifa-wc favorite set "Brazil"       Set favorite by full name
fifa-wc favorite clear              Clear favorite team
fifa-wc doctor                      Verify ESPN provider access
fifa-wc banner                      Print the ASCII banner

Options

| Flag | Description | |------|-------------| | --season YEAR | Season year (default: 2026) | | --next N | Limit number of results shown | | --team CODE | ISO code or team name (for results) | | --group LETTER | Group letter A–L (for results) |

Bordered tables

All output uses Unicode box-drawing characters for clean, readable tables:

┌──────────────────────────────────────────────────────────────────────────────┐
│ ★ Brazil                 2 - 1    Croatia                                    │
│   FT    | Jun 14, 2026, 3:00 PM  |  MetLife Stadium, New York, USA          │
│   Group Stage - Match 3                                                      │
│   Highlights: https://espn.com/video/...                                     │
├──────────────────────────────────────────────────────────────────────────────┤
│   France                 1 - 0    Germany                                    │
│   NS    | Jun 15, 2026, 6:00 PM  |  SoFi Stadium, Los Angeles, USA          │
└──────────────────────────────────────────────────────────────────────────────┘

┌───┬────────────────────────────┬───┬───┬───┬───┬───┬───┬────┬────┐
│ Group A                                                          │
├───┬────────────────────────────┬───┬───┬───┬───┬───┬───┬────┬────┤
│  #│ Team                       │  P│  W│  D│  L│ GF│ GA│  GD│ Pts│
├───┼────────────────────────────┼───┼───┼───┼───┼───┼───┼────┼────┤
│  1│ ★ Brazil                   │  3│  3│  0│  0│  9│  1│   8│   9│
├───┼────────────────────────────┼───┼───┼───┼───┼───┼───┼────┼────┤
│  2│   Croatia                  │  3│  1│  1│  1│  3│  4│  -1│   4│
└───┴────────────────────────────┴───┴───┴───┴───┴───┴───┴────┴────┘

ISO country codes

Use standard ISO 3166-1 codes instead of typing full team names:

fifa-wc favorite set BR          # Brazil
fifa-wc favorite set ENG         # England
fifa-wc results --team DE        # Germany
fifa-wc results --team KSA       # Saudi Arabia

Supported formats:

• Alpha-2 — BR, FR, DE, AR, US, JP …
• Alpha-3 / FIFA codes — BRA, FRA, GER, ARG, USA, JPN …
• Special cases — ENG, SCO, WAL, NIR

Past results

See completed matches, optionally filtered by team or group:

fifa-wc results                  # All past results (most recent first)
fifa-wc results --team ARG       # Argentina's matches
fifa-wc results --group B        # Group B results
fifa-wc results --team ARG --next 3

Match highlights links are shown automatically when available from ESPN.

Player leaderboard

fifa-wc scorers                  # Top 10 per category
fifa-wc scorers --next 5         # Top 5 per category

Categories include goals, assists, and clean sheets.

Personalization

Set your favorite team and it gets highlighted with a ★ in scores, results, and standings:

fifa-wc favorite set "Brazil"
fifa-wc favorite set BR          # same thing via ISO code

You'll also be prompted during your first run.

Requirements

Node.js 18 or later.

Data source

Public ESPN JSON endpoints for soccer/fifa.world. No API key, no registration.