Sports Ticker

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.

Security Scan

The skill’s requested resources and instructions align with its stated purpose (fetching public ESPN data, generating local config/state files, and producing cron job JSON); nothing requests unrelated credentials or installs arbitrary remote code.

Purpose & Capability

Name/description (live sports alerts using ESPN) match the included Python scripts which call ESPN's public API and manage team config, schedules, and cron-job JSON output. Only python3 is required and no credentials are requested—this is proportionate to the stated purpose.

Instruction Scope

SKILL.md instructs running included scripts (setup.py, ticker.py, live_monitor.py, schedule.py, auto_setup_crons.py). The scripts read/write config.json and .live_state.json inside the skill, call ESPN endpoints, and output cron configurations as JSON for the agent/platform to apply. There are no instructions to read unrelated system files or to exfiltrate data to unexpected endpoints.

Install Mechanism

No install specification is provided (instruction-only install), so nothing is downloaded or installed by the skill itself. The code bundle is included and run locally with python3, which is low-risk in the model of skill distribution.

Credentials

The skill declares no required environment variables or credentials. Scripts do ask for user-supplied values in CLI usage (e.g., a telegram_id/timezone when generating cron configs), but there are no hidden secret requirements. No unrelated service keys are requested.

Persistence & Privilege

always is false. The skill writes its own config.json and .live_state.json under the skill directory (expected). It outputs cron-job JSON that the agent/platform must explicitly apply; it does not directly create system-wide crons or modify other skills' configurations.

Assessment

This skill is internally consistent with its description: it fetches public ESPN data, stores a local config.json and a .live_state.json, and outputs cron-job JSON for OpenClaw to schedule. Before installing, verify you are comfortable with: (1) granting the agent/network access so the scripts can call https://site.api.espn.com, (2) the agent/platform creating cron jobs from the generated JSON (review cron entries before applying), and (3) supplying any personal identifiers (e.g., a Telegram ID) that you may pass to the cron-generation scripts. If you want extra caution, run the scripts locally first in a sandbox, inspect the generated config/state/crons, and confirm the OpenClaw cron tool will only schedule jobs you explicitly approve.

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