- name
- bmkg-monitor
- description
- Monitoring earthquake, weather, and tsunami data in Indonesia using BMKG official data. Use when the user asks about earthquakes, weather forecasts, weather warnings, felt tremors, tsunami potential, or seismic events in Indonesia.
BMKG Monitor
Monitor and analyze seismic activity, weather, and natural hazard warnings in Indonesia using real-time data from BMKG (Badan Meteorologi, Klimatologi, dan Geofisika).
Quick Start
# Earthquake
python3 scripts/get_data.py latest # Latest significant earthquake
python3 scripts/get_data.py felt # Earthquakes felt by people
python3 scripts/get_data.py recent # Recent M5.0+ earthquakes
python3 scripts/get_data.py detail <EVENT_ID> # Moment tensor & phase data
python3 scripts/get_data.py shakemap # Shakemap image URL
python3 scripts/get_data.py tsunami # Filter for tsunami potential
# Weather
python3 scripts/get_data.py weather <ADM4_CODE> # 3-day forecast for location
python3 scripts/get_data.py warnings # Active severe weather warnings
# Options
python3 scripts/get_data.py felt --json # Raw JSON output (any command)
python3 scripts/get_data.py help # List all commandsADM4 Codes (Weather)
Weather forecasts use kelurahan/desa administrative codes (format: XX.XX.XX.XXXX). Examples:
31.71.03.1001— Kemayoran, Jakarta Pusat35.07.01.1001— Surabaya area- Find codes via Kepmendagri No. 100.1.1-6117/2022.
Workflows
1. "Was there a quake?"
Run felt first — includes smaller, shallow quakes that people actually feel. If they want the big one, run latest.
2. Significant Earthquake Analysis
When a major quake occurs:
- Run
latestto get details. - Run
shakemapto get the MMI shakemap image URL. - Use references/seismology.md to explain magnitude, depth classification, MMI intensity, and fault type.
- Run
tsunamito check if any events have tsunami potential.
3. Weather Check
For weather questions, use weather <adm4_code>. Shows next 3 forecast periods with temperature, humidity, condition, wind, and visibility.
4. Active Weather Warnings
Run warnings to see current nowcast alerts — severe rain, thunderstorms, strong winds across Indonesian provinces. Refer to the "Weather Warning Severity" section in references/seismology.md for urgency/severity/certainty meanings.
5. Moment Tensor / Beach Ball Analysis
If a detailed BMKG report includes a moment tensor diagram, refer to the "Moment Tensor" section in references/seismology.md to identify Strike-Slip, Normal, or Thrust faulting.
Data Sources
| Data | Source | Format |
|---|---|---|
| Earthquake (latest, recent, felt) | data.bmkg.go.id/DataMKG/TEWS/ | JSON |
| Shakemap images | data.bmkg.go.id/DataMKG/TEWS/<id>.mmi.jpg | JPG |
| Weather forecast | api.bmkg.go.id/publik/prakiraan-cuaca | JSON |
| Weather warnings | bmkg.go.id/alerts/nowcast/id | RSS/XML |
| Moment tensor & phase | static.bmkg.go.id/ | TXT |
References
- seismology.md — Magnitude, MMI scale, depth, tsunami warnings, fault types, Indonesia tectonics, weather severity levels.