iran-israel-alerts

🛡️ Magen Yehuda Bot — Iran-Israel Real-Time Intelligence Monitor

Multi-source intelligence aggregation for Iran/Israel/US military escalation. Adaptive threat-level system, 85+ OSINT sources, satellite fire detection, seismic monitoring, flight tracking, internet blackout detection, strike correlation, cyber warfare monitoring, wire service integration, multi-source corroboration, bilingual alerts with per-channel timezones, and instant Telegram delivery.

What It Does

Monitors 85+ intelligence sources across 16 categories, auto-adjusts polling frequency based on threat level, auto-detects and corroborates breaking news from credible sources, and pushes instant bilingual alerts to Telegram channels with per-channel timezones:

Key Features

• Adaptive threat system — Polling scales from 5min (GREEN) to 30s (CRITICAL) based on siren activity
• Breaking news corroboration — Auto-tracks sources per topic; 3+ reputable sources (Reuters, AP, BBC, etc.) = CONFIRMED with source list; <3 = UNVERIFIED with count
• Multi-channel dispatch — Route alerts to English and/or Hebrew channels with language-specific formatting
• Per-channel timezones — English channel shows ET, Hebrew channel shows IST (configurable per output)
• Hebrew threat levels — שגרה (GREEN), מוגבר (ELEVATED), גבוה (HIGH), קריטי (CRITICAL) — all alert types fully translated
• Satellite fire detection — 4 NASA satellites, proximity to 23 known nuclear/military/oil sites
• Internet blackout early warning — Iran historically cuts internet before military operations
• Strike correlation engine — Automatic fire + seismic coincidence detection (50km/30min window)
• US/Israeli military flight tracking — 50+ aircraft type→role mappings, filtered to relevant assets only
• Cyber warfare monitor — 19 hacktivist groups (25 TG handles), 8 CTI Twitter accounts, 4 dark web feeds, auto-classification
• Live pinned status dashboard — Single message edited every 60s with full system state (separate EN/HE versions)
• Bilingual hourly reports — Intel map + flight map + Hebrew summary + English summary + 24h time-lapse GIF
• Wire service integration — Reuters and AP News via Google News RSS proxy (direct feeds are Cloudflared)
• Attack classification — Auto-categorizes ICS/SCADA, data breach, ransomware, DDoS, espionage with severity scoring
• Naval vessel tracking — US Navy, IRGC Navy, zone classification, naval base proximity

🗺️ Interactive Theater Operations Dashboard

Live Dashboard: magen-yehuda-intel.github.io/magen-yehuda-bot

A Leaflet-based interactive web dashboard visualizing 48,000+ geolocated conflict events across the Middle East since October 7, 2023.

Features

• Theater Select — 9 operational theaters including Persian Gulf, each with tailored map bounds and context
• 14 Conflict Phase Presets — Jump to key moments: Oct 7 attack, Iran April strikes, Lebanon ground ops, Houthi naval campaign, and more
• Force Disposition — Filter events by side (Israel, Iran, Iran proxies, US/Coalition, Unknown)
• Military Base Overlays — 29 Iranian military sites + 20 US/Coalition bases with independent layer toggles
• Event Type Filtering — Clickable legend filters by airstrikes, shelling, ground combat, satellite detections, and more
• News Feed Panel — Live headlines from OSINT sources; click any headline to fly to its geolocated position on the map
• Resizable Side Panel — Drag to resize the info/news panel to your preference
• Collapsible Timeline — Temporal density visualization showing event concentration over time; expand/collapse as needed
• Mobile-Responsive — Full mobile support with a 5-tab bottom navigation bar (Map, Theaters, Filters, News, Timeline)

Dashboard Data Sources

Screenshots

Screenshots coming soon. The dashboard is live at the URL above.

---

Quick Start

1. Prerequisites

• Python 3.9+ with Pillow (pip3 install Pillow)
• bash, curl, jq
• A Telegram bot (create via @BotFather)
• A Telegram channel (add your bot as admin)

2. Configure

cp config.example.json config.json

Edit config.json:

{
  "telegram_bot_token": "YOUR_BOT_TOKEN",
  "telegram_chat_id": "@your_channel",
  "timezone": "Asia/Jerusalem",
  "outputs": [
    {
      "id": "main",
      "chat_id": "@your_english_channel",
      "language": "en",
      "timezone": "America/New_York",
      "content": ["all"],
      "images": "all"
    },
    {
      "id": "hebrew",
      "chat_id": "@your_hebrew_channel",
      "language": "he",
      "timezone": "Asia/Jerusalem",
      "content": ["all"],
      "images": "high_only"
    }
  ]
}

3. NASA FIRMS API Key (free, 30 seconds)

Fire detection needs a free NASA FIRMS MAP_KEY — no verification required.

1. Go to mail.tm or any temp email service
2. Copy the temp email address
3. Go to FIRMS API → Get MAP_KEY
4. Enter the email — key arrives instantly
5. Save it:

   mkdir -p secrets
   echo "YOUR_KEY" > secrets/firms-map-key.txt
   

The key is permanent with no rate limits.

4. Run

# One-time check (stdout)
bash ctl.sh check

# Start real-time watcher daemon
bash ctl.sh start

# Full dashboard
bash ctl.sh dashboard

# Stop
bash ctl.sh stop

🐳 Docker (Recommended for Cloud/Self-Hosting)

# Option A: Quick start with env vars
cp .env.example .env
# Edit .env with your Telegram bot token + channel IDs

docker compose up -d

# View logs
docker compose logs -f

# Stop
docker compose down

# Option B: Use your own config.json
docker build -t iran-israel-watcher .
docker run -d --name watcher \
  -v ./config.json:/app/config.json:ro \
  -v ./secrets:/app/secrets:ro \
  -v watcher-state:/app/state \
  iran-israel-watcher

# One-shot SITREP (without starting daemon)
docker run --rm --env-file .env ira