- name
- red-alert
- version
- 1.2.0
- description
- Israel Red Alert API — real-time and historical rocket/missile alert data. Query alerts by city, time range, generate shelter time stats. Uses redalert.orielhaim.com (socket.io for real-time) and tzevaadom.co.il (REST for history).
- provides
- methods
- [history, realtime, shelter-stats]
- credentials
- required
- false
- description
- API key from redalert.orielhaim.com — optional, used for authenticated socket.io real-time connection. History via tzevaadom works without any key.
- dependencies
- type
- npm
- required
- false
- description
- Only needed for real-time alerts (realtime.mjs). History analysis works without it.
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
# 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 installQuick 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.jsonResponse 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, earthquakeAnalyze 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 JSONThreat Types
| Code | Type (Hebrew) | Type (English) | Shelter Time |
|---|---|---|---|
| 0 | רקטות וטילים | Rockets & Missiles | 15s-90s (varies by city) |
| 1 | חדירת כלי טיס עוין | Hostile Aircraft | 10 min |
| 2 | רעידת אדמה | Earthquake | Until safe |
| 3 | צונאמי | Tsunami | Evacuate coast |
| 5 | חדירת מחבלים | Terrorist Infiltration | Stay inside |
Shelter Times by Region (for rockets)
| Region | Time |
|---|---|
| Gaza envelope | 15 seconds |
| Ashkelon, Sderot | 30 seconds |
| Beer Sheva, Ashdod | 45 seconds |
| Tel Aviv, Kfar Saba, Netanya | 90 seconds |
| Haifa, Hadera | 60 seconds |
| North (border) | 30 seconds |
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.pngArchitecture 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