🚨 Real-time missile threat intelligence agent for Israeli red alert notifications
This AI agent provides automated, structured intelligence reports during missile attacks targeting Israel. It integrates with the Israeli Home Front Command API through Home Assistant, processes OSINT data from X (Twitter), and delivers actionable intelligence through multiple notification channels.
When a red alert is issued in Israel, this agent:
- Receives automated triggers from Home Assistant's Homefront Command integration
- Analyzes real-time OSINT data from X (Twitter) including verified journalists, IDF accounts, and eyewitness reports
- Generates structured intelligence reports with verified information
- Delivers formatted notifications via Slack, email, or other channels
flowchart LR
A[🚨 Red Alert] --> B[🏠 Home Assistant<br/>Homefront Command API]
B --> C[🔗 Webhook Trigger]
C --> D[⚡ Automation Platform<br/>N8N/Zapier/etc]
D --> E[🤖 OSINT Agent]
E --> F[🐦 X API Tool<br/>OSINT Data Collection]
F --> G[📊 Structured Report<br/>JSON Schema]
G --> H[📢 Notifications]
H --> I[💬 Slack]
H --> J[📧 Email]
H --> K[📱 Other Channels]
- Prioritizes verified sources (IDF, Home Front Command, major media)
- Cross-references multiple OSINT channels
- Filters speculation from confirmed intelligence
- Never hallucinates - clearly marks uncertain information
Generates standardized reports containing:
- Summary: Concise incident overview
- HTML Report: Gmail-safe formatted notification
- Militant Group: Suspected organization (if known)
- Missile Count: Number of projectiles launched
- Launch Details: Target areas and timing
- Timestamps: Both UTC and Israel Standard Time
- Affected Areas: Cities/regions under alert
- Slack workspace notifications
- Email alerts with HTML formatting
- Webhook integrations for custom endpoints
- API responses for downstream systems
-
System Prompt (
system-prompt.md)- Defines agent behavior and output requirements
- Specifies data prioritization rules
- Ensures consistent report formatting
-
JSON Schema (
schema.json)- Validates structured output format
- Ensures data consistency across reports
- Enables reliable downstream processing
-
X API Integration
- Streams real-time OSINT data
- Monitors verified journalist accounts
- Tracks IDF and emergency service updates
- Captures eyewitness reports
# Example Home Assistant automation
automation:
- alias: "Red Alert Trigger"
trigger:
platform: state
entity_id: binary_sensor.red_alert_jerusalem
to: 'on'
action:
service: webhook.call
data:
url: "https://your-automation-platform.com/webhook/red-alert"
method: POST
data:
alert_area: "{{ trigger.to_state.attributes.area }}"
timestamp: "{{ now().isoformat() }}"- N8N: Use HTTP Request node to call agent API
- Zapier: Configure webhook trigger → AI agent → notification actions
- Make.com: Set up scenario with webhook → agent → multi-channel delivery
{
"summary": "Hamas reportedly launched 3 missiles toward Jerusalem area at 06:15 IST. Red alerts active in Jerusalem, Beit Shemesh, and surrounding communities. Iron Dome interceptions reported.",
"gmail_html": "<html><body><h2>🚨 Missile Alert Report</h2><p><b>Group:</b> Hamas</p><p><b>Details:</b> 3 missiles toward Jerusalem area</p><p><b>Areas:</b> Jerusalem, Beit Shemesh</p><p><b>Time:</b> 06:15 IST</p></body></html>",
"militant_group": "Hamas",
"missile_count": 3,
"missile_launch_details": "3 missiles reported launched toward Jerusalem area",
"launch_time_utc": "2025-07-30T03:15:00Z",
"launch_time_ist": "2025-07-30T06:15:00+03:00",
"affected_areas": ["Jerusalem", "Beit Shemesh", "Modiin"]
}🚨 MISSILE ALERT - Jerusalem Area
📍 Affected Areas: Jerusalem, Beit Shemesh, Modiin
🎯 Source: Hamas (3 missiles)
⏰ Time: 06:15 IST (03:15 UTC)
📊 Summary: Hamas reportedly launched 3 missiles toward Jerusalem area. Red alerts active in multiple communities. Iron Dome interceptions reported.
⚠️ This is an automated intelligence report based on OSINT data.
- API Keys: Store X API credentials securely
- Rate Limiting: Implement appropriate API call limits
- Data Validation: Verify all inputs before processing
- Error Handling: Graceful degradation when sources unavailable
- Audit Trail: Log all agent activations and responses
- X API access with appropriate permissions
- Home Assistant with Homefront Command integration
- Automation platform (N8N, Zapier, etc.)
- Notification endpoints (Slack workspace, email server)
- Deploy agent to your preferred AI platform
- Configure Home Assistant webhook automation
- Set up automation platform workflow
- Test notification delivery channels
- Validate end-to-end alert processing
- Health Checks: Regular API connectivity tests
- Response Time: Monitor agent processing latency
- Accuracy Tracking: Validate reports against official sources
- False Positive Rate: Track and minimize incorrect alerts
This project is intended for defensive intelligence purposes only.