---
name: World Cup CLI
slug: world-cup-cli
category: Automation
description: World Cup CLI provides read-only FIFA World Cup 2026 data from the command line, including fixtures, qualified nations, squads, group standings, and bookmaker odds. Use it when you need match schedules, team info, or odds without scraping sites.
github: "https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/worldcup-cli"
language: Python
stars: 215
forks: 45
install: "npx degit https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/worldcup-cli ~/.claude/skills/worldcup-cli"
installs_to: ~/.claude/skills/worldcup-cli
source_path: .claude/skills/worldcup-cli/SKILL.md
collection_size: 25
category_size: 1860
collection_url: "https://dirskills.com/collections/ItamarZand88/CLI-Anything-WEB"
added: 2026-09-04T05:25:50.709Z
last_synced: 2026-09-04T05:25:50.709Z
canonical_url: "https://dirskills.com/skills/world-cup-cli"
---

# World Cup CLI

World Cup CLI provides read-only FIFA World Cup 2026 data from the command line, including fixtures, qualified nations, squads, group standings, and bookmaker odds. Use it when you need match schedules, team info, or odds without scraping sites.

**Install:**

```bash
npx degit https://github.com/ItamarZand88/CLI-Anything-WEB/tree/main/.claude/skills/worldcup-cli ~/.claude/skills/worldcup-cli
```

## README

# cli-web-worldcup

FIFA World Cup 2026 on the command line — read-only. Matches, nations,
squads, group standings, and bookmaker odds.
Install: `pip install cli-web-worldcup`

Data sources: **ESPN** public API (no auth) for everything except odds;
**The Odds API** (free key) for `odds`. No bets are ever placed.

## Commands

- `fixtures list` — World Cup matches. Options: `--team TEXT` (name or 3-letter code, e.g. `MEX`), `--dates YYYYMMDD` or `YYYYMMDD-YYYYMMDD` (default: full tournament), `--limit N`
- `fixtures get <event_id>` — one match's detail (status, venue, odds line)
- `teams list` — all 48 qualified nations
- `teams get <id|code|name>` — one nation (e.g. `MEX`, `Mexico`, `203`)
- `players roster <id|code|name>` — a nation's squad
- `standings list` — group tables. Option: `--group A`
- `odds list` — bookmaker head-to-head odds. Options: `--regions us|uk|eu|au`, `--markets h2h,totals`, `--odds-format decimal|american`, `--api-key KEY`. **Requires a free key** from https://the-odds-api.com via `CLI_WEB_WORLDCUP_ODDS_API_KEY` or `--api-key`.

## Examples

```bash
# Mexico's matches, as JSON
cli-web-worldcup fixtures list --team MEX --json

# Group A table
cli-web-worldcup standings list --group A

# Mexico's 26-player squad
cli-web-worldcup players roster Mexico --json

# Today's matches (tournament opens 2026-06-11)
cli-web-worldcup fixtures list --dates 20260611

# Odds (after setting a key)
export CLI_WEB_WORLDCUP_ODDS_API_KEY=...; cli-web-worldcup odds list --json
```

## JSON output

Add `--json` for `{"success": true, "data": [...]}`, or `--jsonl` on list
commands for one compact object per line. Errors are structured too:
`{"error": true, "code": "NOT_FOUND", "message": "..."}`.

Exit codes: `0` ok · `2` usage · `3` auth (missing/invalid odds key) ·
`4` not-found (unknown team/match) · `5` rate-limit · `6` server · `7` network.

## Utilities

`cli-web-worldcup doctor [--json]` diagnoses local setup. `cli-web-worldcup
mcp-serve` exposes the commands as MCP tools over stdio. Running with no
arguments opens an interactive REPL.

## Agent tips

- Resolve teams by 3-letter code (`MEX`, `BRA`, `ARG`) — most reliable; names work too but ambiguous prefixes (e.g. "South") error with the candidates.
- `odds` is the only command needing a key; everything else is keyless. Composes with the `world-cup-2026-predictor` skill for richer forecasts.
- Match `id` for `fixtures get` comes from `fixtures list` (the `id` field).