cricket-live-score

# 🏏 Cricket Live Score Updates

Real-time cricket score updates delivered to Telegram — with optional voice memos so you can follow along without reading. Scrapes data from cricbuzz and does not need any API key setup to get the scores. 

Supports T20 and ODI formats, both innings, auto-detection of teams, target, and required run rate.

The script runs in the background, sends updates at your chosen interval, and auto-stops when the match ends.

The voice memos are perfect for when you're driving or otherwise can't focus on a screen.

## Example prompts

**Starting updates:**
- "Send me live score updates for the India vs Australia match"
- "Follow the IPL match — RCB vs CSK — and send me updates every 3 minutes"
- "What's the score in the England vs Pakistan T20? Keep me posted"

**With voice memos:**
- "Send me live cricket scores with voice memos for the World Cup final"
- "Follow India vs South Africa and include voice updates — I'm driving"

**Changing interval:**
- "Make the updates every 2 minutes instead"
- "Slow it down to every 10 minutes"

**Stopping:**
- "Stop sending score updates"
- "Kill the cricket updates"

## When to use

User asks for live score updates, cricket score alerts, or to follow a match.

## How it works

1. **Find the Cricbuzz URL** for the match. Search for `cricbuzz <team1> vs <team2> live score` and grab the `cricbuzz.com/live-cricket-scores/...` URL.
2. **Run the script** in background:

```bash
python3 <skill_dir>/scripts/cricket-live.py \
  --url "<cricbuzz_url>" \
  --chat-id "<telegram_chat_id>" \
  --bot-token "<telegram_bot_token>" \
  --interval 300 \
  --voice
```

3. Script auto-detects teams, innings, format (T20/ODI), and target.
4. Sends text + voice memo every interval. Auto-stops when match ends.

## Parameters

| Param | Default | Description |
|-------|---------|-------------|
| `--url` | required | Cricbuzz live score page URL |
| `--chat-id` | required | Telegram chat ID to send updates to |
| `--bot-token` | auto | Telegram bot token. Falls back to `TELEGRAM_BOT_TOKEN` env var, then OpenClaw config (`~/.openclaw/openclaw.json`) |
| `--interval` | 300 | Seconds between updates (default 5 min) |
| `--voice` | off | Include voice memo with each update |

## What the updates look like

### 2nd innings (chase)
```
*India: 146/4 (15 ov)*
  🏏 Tilak Varma — 20 (15)
  🏏 Sanju Samson — 80 (40)

Need: 50 runs off 30 balls
RRR: 10.0 per over with 5.0 overs to go
Last wicket: Suryakumar Yadav c Rutherford b Joseph 18 (16)

🔹 WI innings: 195/4 (20 ov)
━━━━━━━━━━━━━━━━━
🏏 IND vs WI | ICC Men's T20 World Cup 2026

· Next update in 5 min
```

### 1st innings
```
*West Indies: 120/3 (15 ov)*
  🏏 Rovman Powell — 25 (14)
  🏏 Jason Holder — 12 (8)

Run rate: 8.0 per over
Projected: 160
Last wicket: Shimron Hetmyer c Samson b Bumrah 22 (18)

━━━━━━━━━━━━━━━━━
🏏 IND vs WI | ICC Men's T20 World Cup 2026

· Next update in 5 min
```

### Voice memo examples

**2nd innings:** "India are 146 for 4 in 15 overs. Tilak Varma and Sanju Samson are batting. Tilak Varma is on 20, and Sanju Samson is on 80. India need 50 runs off 30 balls. Required run rate is 10.0 per over, with 5.0 overs to go."

**1st innings:** "West Indies are 120 for 3 in 15 overs. Rovman Powell and Jason Holder are batting. Run rate is 8.0 per over. Projected total is 160."

## Data source

Scrapes Cricbuzz — the `og:description` meta tag for live scores and batsmen, plus embedded JSON for last wicket, bowler stats, and team info. No paid API or API key required for score data.

## Stopping

- Script auto-stops when it detects a match result (won/tied/no result).
- To stop manually, kill the background process.

## Channel support

Currently **Telegram only** — the script sends updates directly via the Telegram Bot API. Multi-channel support (Discord, WhatsApp, Signal, etc.) is planned for a future version.

## Requirements

- Python 3 (uses only `urllib` from the standard library — no `requests` needed)
- `gTTS` package (for voice memos)
- Telegram bot token — provided via one of:
  1. `--bot-token` argument (recommended)
  2. `TELEGRAM_BOT_TOKEN` environment variable
  3. OpenClaw config file (`~/.openclaw/openclaw.json` → `channels.telegram.botToken`)

## Known limitations

- When the chasing team is all out or completes their overs without reaching the target, the script may be slow to detect the result (depends on Cricbuzz updating the page title). It reliably catches wins, ties, and target-reached scenarios.