OSINT Missile Intelligence Agent

July 30, 2025 · View on GitHub

🚨 Real-time missile threat intelligence agent for Israeli red alert notifications

Overview

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.

Purpose

When a red alert is issued in Israel, this agent:

  1. Receives automated triggers from Home Assistant's Homefront Command integration
  2. Analyzes real-time OSINT data from X (Twitter) including verified journalists, IDF accounts, and eyewitness reports
  3. Generates structured intelligence reports with verified information
  4. Delivers formatted notifications via Slack, email, or other channels

Workflow Architecture

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]

Key Features

🎯 Intelligent Data Processing

  • 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

📋 Structured Output Schema

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

🔄 Multi-Channel Delivery

  • Slack workspace notifications
  • Email alerts with HTML formatting
  • Webhook integrations for custom endpoints
  • API responses for downstream systems

Technical Implementation

Core Components

  1. System Prompt (system-prompt.md)

    • Defines agent behavior and output requirements
    • Specifies data prioritization rules
    • Ensures consistent report formatting

  2. JSON Schema (schema.json)

    • Validates structured output format
    • Ensures data consistency across reports
    • Enables reliable downstream processing

  3. X API Integration

    • Streams real-time OSINT data
    • Monitors verified journalist accounts
    • Tracks IDF and emergency service updates
    • Captures eyewitness reports

Integration Points

Home Assistant Setup

# 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() }}"

Automation Platform Configuration

  • 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

Usage Examples

Sample Agent Response

{
  "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"]
}

Slack Notification Format

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

Security Considerations

  • 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

Deployment

Prerequisites

  • X API access with appropriate permissions
  • Home Assistant with Homefront Command integration
  • Automation platform (N8N, Zapier, etc.)
  • Notification endpoints (Slack workspace, email server)

Configuration Steps

  1. Deploy agent to your preferred AI platform
  2. Configure Home Assistant webhook automation
  3. Set up automation platform workflow
  4. Test notification delivery channels
  5. Validate end-to-end alert processing

Monitoring & Maintenance

  • 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

License

This project is intended for defensive intelligence purposes only.

⚠️ Important: This system provides automated analysis of public information during emergency situations. Always verify critical information through official channels and follow local emergency procedures.