red-alert

# Red Alert — Israel Emergency Alerts

Real-time and historical alert data for Israeli cities. Track rocket alerts, calculate shelter time, generate charts.

## Get an API Key

Sign up at **<https://redalert.orielhaim.com/>** to get your API key. Store it as env var `RED_ALERT_API_KEY`.

This skill is a wrapper around the RedAlert API — it provides convenient CLI tools for querying, analyzing, and visualizing alert data.

## Endpoint Reference

For a full, exact endpoint map used by this skill (REST + Socket.IO + auth behavior), read:
- `references/ENDPOINTS.md`

## Data Sources

| Source | Type | Auth | Use For |
|--------|------|------|---------|
| `api.tzevaadom.co.il` | REST | None | Alert history (last ~24h, 50 records) |
| `redalert.orielhaim.com` | Socket.IO | `RED_ALERT_API_KEY` | Real-time alerts, status |

## Setup

```bash
# API key is stored as Fly secret: RED_ALERT_API_KEY
# Socket.io client needed for real-time
cd /data/clawd/skills/red-alert/scripts && npm install
```

## Quick Usage

### Get Alert History (REST)
```bash
# Last ~24h of alerts nationwide (50 most recent alert groups)
curl -s "https://api.tzevaadom.co.il/alerts-history" -o /tmp/alerts.json
```

Response format:
```json
[{
  "id": 5718,
  "description": null,
  "alerts": [{
    "time": 1772352828,     // Unix timestamp
    "cities": ["כפר סבא", "תל אביב"],
    "threat": 0,            // 0=rockets, 1=aircraft, 5=infiltration
    "isDrill": false
  }]
}]
```

### Check System Status
```bash
curl -s -H "Accept: application/json" "https://redalert.orielhaim.com/api/status"
```

### Real-Time Alerts (Socket.IO)
```bash
node /data/clawd/skills/red-alert/scripts/realtime.mjs
# Listens for: alert, rockets, hostileAircraftIntrusion, tsunami, earthquake
```

### Analyze Shelter Time for a City
```bash
node /data/clawd/skills/red-alert/scripts/analyze.mjs --city "כפר סבא" --since "2026-02-28T08:00"
# Outputs: alert count, shelter sessions, total shelter time, hourly data as JSON
```

## Threat Type...