bmkg-monitor

name	bmkg-monitor
description	Robust BMKG (Indonesian Meteorological Agency) monitoring for weather and earthquake alerts. Track conditions in project locations across Indonesia, especially Balikpapan and Kalimantan region.

🌦️ BMKG Monitor Pro

Monitoring cuaca dan gempa untuk lokasi project di Indonesia.

🎯 Features

📍 Multi-Location Monitoring

• Track multiple project locations
• Default: Balikpapan, Jakarta, Sidoarjo
• Custom locations via config

🌤️ Weather Data

• Current conditions
• 3-day forecast
• Rainfall predictions
• Wind speed & direction
• Humidity & visibility

🌍 Earthquake Alerts

• Real-time earthquake detection
• Magnitude & depth
• Distance from project sites
• Tsunami warnings (if applicable)

🚨 Smart Alerts

• Heavy rain alert (>50mm/day)
• High wind alert (>40km/h)
• Earthquake M>4.0 near project
• Extreme heat index

🚀 Usage

# Check current weather
bash skills/bmkg-monitor/scripts/weather.sh --location balikpapan

# Check all project locations
bash skills/bmkg-monitor/scripts/weather.sh --all-locations

# Latest earthquake info
bash skills/bmkg-monitor/scripts/earthquake.sh --latest

# Earthquakes near projects
bash skills/bmkg-monitor/scripts/earthquake.sh --near-projects

# Full report
bash skills/bmkg-monitor/scripts/report.sh --send-telegram

📊 Output Example

🌦️ BMKG Weather Report - 22 Feb 2026

📍 Balikpapan, Kalimantan Timur
⏰ Update: 15:00 WITA

🌤️ Current: Berawan (Cloudy)
🌡️ Temperature: 29°C (feels like 33°C)
💧 Humidity: 78%
💨 Wind: 15 km/h dari Utara
🌧️ Rain: 0 mm (10% chance)

📅 3-Day Forecast:
Besok (23 Feb): Hujan ringan, 26-30°C
Kamis (24 Feb): Berawan, 26-31°C  
Jumat (25 Feb): Cerah, 27-32°C

⚠️  Alerts: None

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🌍 Earthquake Monitor

📍 Latest: 50 km BaratLaut Balikpapan
📊 Magnitude: 3.2 (Ringan)
⏰ Time: 14:32 WITA (28 menit lalu)
🌊 Depth: 12 km
⚠️  Tsunami Risk: None

Status Project:
✅ Balikpapan: Safe (50km dari epicenter)
✅ Jakarta: Safe (1200km dari epicenter)
✅ Sidoarjo: Safe (800km dari epicenter)

⚙️ Configuration

config.json:

{
  "locations": [
    {
      "name": "Balikpapan",
      "province": "Kalimantan Timur",
      "latitude": -1.2654,
      "longitude": 116.8312,
      "projects": ["RFM", "UST"],
      "alert_radius_km": 100
    },
    {
      "name": "Jakarta", 
      "province": "DKI Jakarta",
      "latitude": -6.2088,
      "longitude": 106.8456,
      "projects": ["REFOREL"],
      "alert_radius_km": 100
    },
    {
      "name": "Sidoarjo",
      "province": "Jawa Timur", 
      "latitude": -7.4478,
      "longitude": 112.7183,
      "projects": ["RFS"],
      "alert_radius_km": 100
    }
  ],
  "alerts": {
    "heavy_rain": {"threshold_mm": 50, "enabled": true},
    "high_wind": {"threshold_kmh": 40, "enabled": true},
    "earthquake": {"min_magnitude": 4.0, "enabled": true},
    "tsunami": {"enabled": true}
  },
  "schedule": {
    "weather_check": "6h",
    "earthquake_check": "15min",
    "report_time": "07:00"
  }
}

🔔 Alert Triggers

Kirim Telegram alert otomatis kalau:

Cuaca:

• 🌧️ Hujan deras (>50mm/hari) forecast
• 💨 Angin kencang (>40km/jam)
• 🌡️ Suhu ekstrem (>35°C atau <20°C)
• 🌊 Banjir rob/tinggi air laut

Gempa:

• 📳 M > 4.0 dalam radius 100km project
• 📳 M > 5.0 dalam radius 200km
• 🌊 Tsunami warning (any magnitude)

🛠️ Data Sources

• BMKG API: https://data.bmkg.go.id/
• Earthquake Feed: Real-time gempa bumi
• Weather Station: Stasiun terdekat project

📈 Historical Data

Simpan historical untuk analisis:

logs/
├── weather_YYYY-MM-DD.json
├── earthquake_YYYY-MM-DD.json
└── alerts_YYYY-MM-DD.json

🔧 Commands

Command	Description
--location NAME	Check specific location
--all-locations	Check all project sites
--latest	Latest earthquake
--near-projects	Quakes near any project
--forecast DAYS	Extended forecast
--alert-test	Test alert system

📝 Integration dengan Morning Briefing

BMKG report otomatis masuk ke Morning Briefing:

🌦️ Cuaca Hari Ini:
• Balikpapan: 29°C, berawan
• Jakarta: 31°C, hujan ringan
• Sidoarjo: 30°C, cerah

🌍 Gempa: Tidak ada gempa signifikan