🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Red Alert
🦀 ClawHub

Red Alert

by @dannyshmueli

Israel Red Alert API — real-time and historical rocket/missile alert data. Query alerts by city, time range, generate shelter time stats. Uses redalert.oriel...

Versionv1.2.0
Downloads1,002
#database#legal
TERMINAL
clawhub install red-alert

📖 About This Skill

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: - capability: israel-alerts methods: [history, realtime, shelter-stats] credentials: - name: RED_ALERT_API_KEY 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: - name: socket.io-client 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 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 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

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

    • ⚙️ Configuration

    # 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