Red Alert — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

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

开发与 DevOps

作者：Danny Shmueli @dannyshmueli

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.2.0

统计：⭐ 0 · 255 · 1 current installs · 1 all-time installs

⭐ 0

安装量（当前） 1

🛡 VirusTotal ：良性 · OpenClaw ：良性

Package：dannyshmueli/red-alert

安全扫描（ClawHub）

VirusTotal ：良性
OpenClaw ：良性

OpenClaw 评估

The skill's code, instructions, and optional environment use are consistent with a Red Alert listener/analyzer: it fetches history from api.tzevaadom.co.il and optionally connects to redalert.orielhaim.com via socket.io, requires only an optional API key, and writes local JSONL output for analysis — nothing in the bundle requests unrelated credentials or hidden endpoints.

目的

Name/description match the code and instructions: analyze.mjs calls the documented REST history endpoint, realtime/listener scripts use socket.io to redalert.orielhaim.com. No unrelated credentials, binaries, or surprising services are requested.

说明范围

SKILL.md instructs the agent to run npm install and execute Node scripts and curl commands against the documented endpoints. The scripts write JSONL files under /data/clawd/tmp and reference skill-local paths (/data/clawd/skills/...). This is expected for a persistent listener/analyzer, but note it will create/append local files and may run a long-lived socket connection if the daemon is used.

安装机制

There is no platform install spec; users are instructed to run npm install in the scripts directory. Dependencies come from the public npm registry (socket.io-client). This is expected but carries the usual npm-supply-chain risks (verify package-lock.json and run in a sandboxed environment if concerned).

证书

Only an optional RED_ALERT_API_KEY is declared and used. The code reads that single env var for authenticated socket.io connections; no other secrets or unrelated env/config paths are requested or accessed.

持久

always:false (no forced inclusion). The listener-daemon creates persistent local files (/data/clawd/tmp/redalert-live.jsonl and redalert-pending.jsonl) and maintains long-lived network connections. This is consistent with real-time functionality, but you should expect residual files and an active socket if run persistently.

综合结论

This skill appears internally coherent for its stated purpose. Before installing: 1) If you will run the realtime/daemon scripts, run npm install in an isolated sandbox and verify package-lock.json to reduce npm supply-chain risk. 2) The listener writes JSONL files to /data/clawd/tmp — ensure that path and file permissions are acceptable and won't expose sensitive data. 3) The RED_ALERT_API_KEY is optional; only provide it if you need authenti…

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Red Alert」。简介：Israel Red Alert API — real-time and historical rocket/missile alert data. Quer…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/dannyshmueli/red-alert/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

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

```bash
# 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