Coding

sports-ticker

Try it

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

What it does

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

The skill document

Sports Ticker

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

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

First Run (Onboarding)

When no config.json exists, running the setup script launches an interactive wizard:

python3 scripts/setup.py

The wizard asks:

  1. 📺 Which sports? — Pick from Soccer, NFL, NBA, NHL, MLB, F1
  2. 🏆 Which teams? — Choose from popular teams or search for any team
  3. 🔔 Alert style? — Live scores, final only, or daily digest
  4. ⏰ Game-day reminders? — Get a heads-up 30 mins before kick-off
  5. 🌙 Quiet hours? — Pause alerts while you sleep

After setup, your config.json is ready and you can start tracking!

Re-run setup anytime:

python3 scripts/setup.py --force  # Overwrites existing config

Quick Start

# First time? Just run setup!
python3 scripts/setup.py  # Interactive wizard

# 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

{
  "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

# 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

# 📅 Schedule - View upcoming fixtures (NEW in v3!)
python3 scripts/schedule.py                    # All teams, next 14 days
python3 scripts/schedule.py --days 30          # Look further ahead
python3 scripts/schedule.py --team spurs       # Specific team
python3 scripts/schedule.py --compact          # One-liner format
python3 scripts/schedule.py --json             # JSON output

# 🤖 Auto Setup Crons - Generate match-day crons (NEW in v3!)
python3 scripts/auto_setup_crons.py            # All teams, next 7 days
python3 scripts/auto_setup_crons.py --team spurs --days 14
python3 scripts/auto_setup_crons.py --json     # Machine-readable
python3 scripts/auto_setup_crons.py --commands # OpenClaw CLI commands

# 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

Related skills

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván561 installs18 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván857 installs69 stars

More from robbyczgw-cla

Browse all skills

Generate reflective AI diary entries with pattern tracking, quote logs, and weekly digests.

by robbyczgw-cla208 installs6 stars

Continuously monitor topics across web search, RSS/Atom feeds, and GitHub releases, alerting only when relevant.

by robbyczgw-cla367 installs27 stars

Synthesize speech in 18 voices across 32 languages, generate sound effects, and design custom voices via ElevenLabs.

by robbyczgw-cla275 installs16 stars

Three specialized agents tackle your question in parallel and optionally cross-examine each other before synthesis.

by robbyczgw-cla62 installs2 stars

Fetch YouTube transcripts from cloud IPs without getting blocked by bot detection.

by robbyczgw-cla151 installs5 stars

Get three context-aware follow-up questions after any AI response, grouped into quick, deep-dive, and related.

by robbyczgw-cla192 installs8 stars