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 **** 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

Setup

# 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)

# 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:

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

Check System Status

curl -s -H "Accept: application/json" "https://redalert.orielhaim.com/api/status"

Real-Time Alerts (Socket.IO)

node /data/clawd/skills/red-alert/scripts/realtime.mjs
# Listens for: alert, rockets, hostileAircraftIntrusion, tsunami, earthquake

Analyze Shelter Time for a City

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 Types

Shelter Times by Region (for rockets)

Combining with Chart/Table Skills

# Generate hourly alert chart
node /data/clawd/skills/red-alert/scripts/analyze.mjs --city "כפר סבא" --since "2026-02-28T08:00" --format chart-json \
  | node /data/clawd/skills/chart-image/scripts/chart.mjs --type bar --dark --title "Kfar Saba Alerts" --output alerts.png

# Generate shelter session table
node /data/clawd/skills/red-alert/scripts/analyze.mjs --city "כפר סבא" --since "2026-02-28T08:00" --format table-json \
  | node /data/clawd/skills/table-image/scripts/table.mjs --dark --title "Shelter Sessions" --output shelter.png

Architecture Notes

• redalert.orielhaim.com — Oriel Haim's service. Polls Pikud HaOref, redistributes via Socket.IO. Has better-auth for API key management. REST endpoints blocked by Cloudflare challenge (except /api/status).
• api.tzevaadom.co.il — Free REST API, no auth needed, returns last ~24h of alert history.
• Pikud HaOref direct (oref.org.il) — Blocked from cloud IPs (Akamai WAF).

Limitations

• History limited to ~24h (50 groups) from tzevaadom
• For longer history, would need to store alerts ourselves via socket.io listener
• Real-time requires persistent socket.io connection