← Back to Skills Marketplace
bluemeda

BMKG Monitor

by Affif Mukhlashin · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
2166
Downloads
1
Stars
4
Active Installs
2
Versions
Install in OpenClaw
/install 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...
README (SKILL.md)

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 \x3CEVENT_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 \x3CADM4_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 commands

ADM4 Codes (Weather)

Weather forecasts use kelurahan/desa administrative codes (format: XX.XX.XX.XXXX). Examples:

  • 31.71.03.1001 — Kemayoran, Jakarta Pusat
  • 35.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:

  1. Run latest to get details.
  2. Run shakemap to get the MMI shakemap image URL.
  3. Use references/seismology.md to explain magnitude, depth classification, MMI intensity, and fault type.
  4. Run tsunami to check if any events have tsunami potential.

3. Weather Check

For weather questions, use weather \x3Cadm4_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/\x3Cid>.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.
Usage Guidance
This skill is coherent with its description: it fetches public BMKG earthquake, weather, shakemap, and warnings data and prints formatted output. Things to consider before installing/running: (1) The package metadata doesn't declare that python3 and the 'requests' library are required — install them (or run in a Python virtualenv) before use. (2) The script makes outbound HTTP(S) calls to official BMKG hosts; ensure outbound network access is acceptable. (3) As with any third-party code, inspect the included scripts (scripts/get_data.py) yourself or run them in a sandboxed environment if you have security concerns. (4) Allowing autonomous invocation is low risk here because no secrets are exposed, but an autonomous agent could call the endpoints repeatedly — consider rate/usage implications.
Capability Analysis
Type: OpenClaw Skill Name: bmkg-monitor Version: 1.1.0 The skill bundle is a legitimate tool for monitoring Indonesian seismic and weather data via official BMKG (Meteorology, Climatology, and Geophysical Agency) APIs. The script `scripts/get_data.py` fetches data from verified government domains (bmkg.go.id) and lacks any high-risk behaviors such as shell execution, credential theft, or prompt injection. All instructions in `SKILL.md` and the reference documentation are strictly aligned with the stated purpose of natural hazard monitoring.
Capability Assessment
Purpose & Capability
The skill name/description match its behavior: the included Python script fetches JSON/XML from BMKG domains and formats outputs for earthquakes, shakemaps, tsunamis, weather, and warnings. Minor mismatch: the registry metadata lists no required binaries, but SKILL.md and the script expect python3 and the 'requests' library to be available.
Instruction Scope
SKILL.md explicitly instructs running scripts/get_data.py with specific commands; the script only fetches data from BMKG domains (data.bmkg.go.id, api.bmkg.go.id, bmkg.go.id, static.bmkg.go.id), parses JSON/XML, and prints results. It does not access local sensitive files, other environment variables, or external endpoints outside BMKG. Error handling prints to stderr and exits; no broad 'gather context' steps are present.
Install Mechanism
There is no install spec (instruction-only plus an included script). No remote downloads or archive extraction are performed by an installer. The only runtime dependency is the Python script itself and the third-party 'requests' package, which the skill does not automatically install.
Credentials
The skill declares no environment variables, credentials, or config paths and the code does not read any such values. All network requests are to BMKG official hosts; no tokens/secrets are requested or transmitted.
Persistence & Privilege
The skill does not request permanent presence (always is false) and does not modify other skills or system-wide configuration. It is user-invocable and permitted to be invoked autonomously by the agent (platform default), which is reasonable given its limited scope and lack of credentials.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bmkg-monitor
  3. After installation, invoke the skill by name or use /bmkg-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Major Update: Added comprehensive weather monitoring (forecasts and warnings) alongside earthquake data using official BMKG APIs.
v1.0.0
Initial release: Real-time Indonesia earthquake monitor with detailed Moment Tensor support.
Metadata
Slug bmkg-monitor
Version 1.1.0
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 2
Frequently Asked Questions

What is BMKG Monitor?

Monitoring earthquake, weather, and tsunami data in Indonesia using BMKG official data. Use when the user asks about earthquakes, weather forecasts, weather... It is an AI Agent Skill for Claude Code / OpenClaw, with 2166 downloads so far.

How do I install BMKG Monitor?

Run "/install bmkg-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is BMKG Monitor free?

Yes, BMKG Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does BMKG Monitor support?

BMKG Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created BMKG Monitor?

It is built and maintained by Affif Mukhlashin (@bluemeda); the current version is v1.1.0.

💬 Comments