BMKG Weather Skill

Fetch real-time Indonesian weather forecasts and earthquake data from BMKG's open API. No API key needed. Rate limit: 60 requests/minute per IP.

Attribution required: Always mention "Sumber: BMKG" in responses.

API Endpoints

1. Prakiraan Cuaca (Weather Forecast)

GET https://api.bmkg.go.id/publik/prakiraan-cuaca?adm4={kode_wilayah}

Forecast: 3 hari ke depan, per 3 jam (8 data/hari)
Update: 2x sehari
Format: JSON

2. Peringatan Dini / Nowcast

GET https://data.bmkg.go.id/peringatan-dini-cuaca/

Early warning hingga level kecamatan
Format: XML (CAP)

3. Data Gempa Bumi

GET https://data.bmkg.go.id/DataMKG/TEWS/autogempa.json
GET https://data.bmkg.go.id/DataMKG/TEWS/gempaterkini.json

Cara Penggunaan

Step 1: Tentukan kode wilayah (adm4)

Format kode: PP.KK.CC.DDDD

PP = Kode provinsi (2 digit)
KK = Kode kota/kabupaten (2 digit)
CC = Kode kecamatan (2 digit)
DDDD = Kode kelurahan/desa (4 digit)

Cara lookup kode wilayah (gunakan script):

python scripts/cari_wilayah.py "Padang"
python scripts/cari_wilayah.py "Bogor"

Script otomatis cari kode dan test validitasnya ke API BMKG.

Jika tidak ditemukan, cari manual di https://cuaca.bmkg.go.id Atau lihat: references/kode-wilayah.md

Step 2: Fetch data cuaca

# Contoh: Jakarta Pusat - Kemayoran
curl "https://api.bmkg.go.id/publik/prakiraan-cuaca?adm4=31.71.03.1001"

# Contoh: Surabaya - Wonokromo
curl "https://api.bmkg.go.id/publik/prakiraan-cuaca?adm4=35.78.31.1007"

Step 3: Parse response JSON

Response structure:

{
  "lokasi": {
    "provinsi": "DKI Jakarta",
    "kotkab": "Kota Adm. Jakarta Pusat",
    "kecamatan": "Kemayoran",
    "desa": "Kemayoran",
    "lon": 106.845,
    "lat": -6.164,
    "timezone": "Asia/Jakarta"
  },
  "data": [{
    "cuaca": [
      [ /* hari 1, array per 3 jam */ ],
      [ /* hari 2 */ ],
      [ /* hari 3 */ ]
    ]
  }]
}

Step 4: Format response ke user

Untuk setiap entry cuaca, field yang tersedia:

Field	Deskripsi	Satuan
`local_datetime`	Waktu lokal	YYYY-MM-DD HH:mm:ss
`t`	Suhu udara	°C
`hu`	Kelembapan	%
`weather_desc`	Kondisi cuaca (ID)	-
`weather_desc_en`	Kondisi cuaca (EN)	-
`ws`	Kecepatan angin	km/jam
`wd`	Arah angin dari	-
`tcc`	Tutupan awan	%
`vs_text`	Jarak pandang	km
`tp`	Curah hujan	mm
`image`	URL ikon cuaca	SVG

Data Gempa Bumi

# Gempa terbaru (1 gempa)
curl "https://data.bmkg.go.id/DataMKG/TEWS/autogempa.json"

# 15 gempa terkini
curl "https://data.bmkg.go.id/DataMKG/TEWS/gempaterkini.json"

# 15 gempa dirasakan
curl "https://data.bmkg.go.id/DataMKG/TEWS/gempadirasakan.json"

Response fields gempa:

Tanggal, Jam — waktu kejadian
Magnitude — kekuatan gempa
Kedalaman — kedalaman dalam km
Wilayah — lokasi episenter
Potensi — potensi tsunami atau tidak
Koordinat — lat,lon

Contoh Output ke User

🌤️ Prakiraan Cuaca Jakarta Pusat - Kemayoran
📅 Senin, 26 April 2026 | 14:00 WIB

🌡️ Suhu: 31°C
💧 Kelembapan: 69%
🌬️ Angin: 9.6 km/jam dari Timur
☁️ Tutupan awan: 7%
👁️ Jarak pandang: >10 km
🌦️ Kondisi: Cerah

---
Sumber: BMKG (data.bmkg.go.id)

Kode Wilayah Kota Besar

Kota	Kode adm4 Contoh
Jakarta Pusat (Kemayoran)	`31.71.03.1001`
Jakarta Selatan (Kebayoran)	`31.74.08.1001`
Surabaya	`35.78.01.1001`
Bandung	`32.73.01.1001`
Medan	`12.71.01.1001`
Makassar	`73.71.01.1001`
Semarang	`33.74.01.1001`
Yogyakarta	`34.71.01.1001`
Denpasar	`51.71.01.1001`
Palembang	`16.71.01.1001`
Pekanbaru	`14.71.01.1001`
Balikpapan	`64.72.01.1001`
Manado	`71.71.01.1001`
Jayapura	`91.71.01.1001`

Untuk kode wilayah lengkap, lihat: references/kode-wilayah.md

Catatan Penting

Wajib cantumkan BMKG sebagai sumber data di setiap response
Kode wilayah menggunakan Kepmendagri No. 100.1.1-6117 Tahun 2022
Jika kode wilayah tidak diketahui, gunakan kode kota terdekat atau minta user clarifikasi
Data diupdate 2x sehari — pagi dan sore
Jika API tidak merespons, informasikan ke user dan sarankan cek langsung di https://cuaca.bmkg.go.id

bmkg-weather

Safety Notice

Copy this and send it to your AI assistant to learn