Cricket Live

# 🏏 Cricket Live

**Live cricket scores, IPL tracking, and match alerts for OpenClaw.**

Get real-time scores, upcoming schedules, detailed scorecards, and IPL standings — all from your OpenClaw agent. Powered by [CricketData.org](https://cricketdata.org) API (endpoint: `api.cricapi.com`).

---

## ✨ Features

- 🔴 **Live Scores** — All currently live matches with real-time scores, overs, and status
- 📋 **Match Details** — Full scorecards with batting and bowling stats
- 📅 **Upcoming Matches** — Next 7 days of scheduled matches, filterable by team
- ✅ **Recent Results** — Completed matches from the last 3 days
- 🏆 **IPL Hub** — Standings, upcoming IPL matches, live scores, and results
- 🔍 **Match Search** — Find any match by team name (supports aliases like "MI", "CSK", "AUS")
- 🔔 **Alerts** — Cron-ready script for wicket, century, and result notifications
- 💾 **Smart Caching** — Respects API quota with configurable TTL per endpoint
- 🇮🇳 **IST by Default** — All times displayed in Indian Standard Time

---

## 🚀 Quick Start

### 1. Get a Free API Key
Sign up at [cricketdata.org](https://cricketdata.org) — the free tier gives you **100 API calls/day**. (CricketData.org's API is served at `api.cricapi.com` — they are the same service.)

### 2. Set the Environment Variable
```bash
export CRICKET_API_KEY="your-api-key-here"
# Add to your shell profile or ~/.openclaw/.env for persistence
```

### 3. Run Any Script
```bash
bash scripts/live-scores.sh              # What's happening right now?
bash scripts/upcoming-matches.sh         # What's coming up?
bash scripts/ipl.sh standings            # IPL points table
```

---

## 📖 Usage

### Live Scores
```bash
bash scripts/live-scores.sh
```
Shows all currently live matches with scores, overs, and match status.

**Example output:**
```
🏏 LIVE CRICKET SCORES
━━━━━━━━━━━━━━━━━━━━━

🔴 India vs England — 3rd Test, Day 2
🇮🇳 India: 285/6 (78.2 ov)
🏴 England: 312 (98.4 ov)
📊 India trail by 27 runs

🔴 Australia vs Sou...