---

name: sports-ticker description: Live sports alerts for Soccer, NFL, NBA, NHL, MLB, F1 and more. Real-time scoring with FREE ESPN API. Track any team from any major league worldwide.

Sports Ticker

Track your favorite teams across multiple sports with FREE live alerts!

Supports: ⚽ Soccer • 🏈 NFL • 🏀 NBA • 🏒 NHL • ⚾ MLB • 🏎️ F1

Quick Start

Copy# Setup
cp config.example.json config.json
python3 scripts/setup.py  # Interactive setup

# Find team IDs (any sport)
python3 scripts/setup.py find "Lakers" basketball
python3 scripts/setup.py find "Chiefs" football
python3 scripts/setup.py find "Barcelona" soccer

# Test
python3 scripts/ticker.py

Config Example

Copy{
  "teams": [
    {
      "name": "Barcelona",
      "emoji": "🔵🔴",
      "sport": "soccer",
      "espn_id": "83",
      "espn_leagues": ["esp.1", "uefa.champions"]
    },
    {
      "name": "Lakers",
      "emoji": "🏀💜💛",
      "sport": "basketball",
      "espn_id": "13",
      "espn_leagues": ["nba"]
    }
  ]
}

Commands

Copy# Ticker for all teams
python3 scripts/ticker.py

# Live monitor (for cron)
python3 scripts/live_monitor.py

# League scoreboard
python3 scripts/ticker.py league nba basketball
python3 scripts/ticker.py league nfl football
python3 scripts/ticker.py league eng.1 soccer

# ESPN direct
python3 scripts/espn.py leagues
python3 scripts/espn.py scoreboard nba basketball
python3 scripts/espn.py search "Chiefs" football

Alert Types

• 🏟️ Game start (kick-off / tip-off)
• ⚽🏈🏀⚾ Scoring plays (goals, touchdowns, 3-pointers, home runs)
• 🟥 Red cards / Ejections
• ⏸️ Halftime / Period breaks
• 🏁 Final results (WIN/LOSS/DRAW)

ESPN API (Free!)

No key needed. Covers all major sports and 50+ leagues worldwide.

Supported Sports:

• Soccer: Premier League, La Liga, Champions League, MLS, and 30+ more
• Football: NFL
• Basketball: NBA, WNBA, NCAA
• Hockey: NHL
• Baseball: MLB
• Racing: Formula 1