Earthquake Monitor

🌋 Earthquake Monitor v1.1.1

Real-time earthquake monitoring for China (CENC), Taiwan (CWA), and Japan (JMA) with proactive alerting.

v1.1.1 Changelog

v1.1.1 (Security Fix)

v1.1.0 Features

Quick Start

// Initialize monitoring
await init({ location: "大理" })
// Get latest earthquakes
await getAll()
// Start proactive monitoring
await start()

Data Sources

| Source | Region | Language (Alert) | Description | |--------|--------|------------------|-------------| | CENC | 🇨🇳 China | 中文 | China Earthquake Networks Center | | CWA | 🇹🇼 Taiwan | 中文 | Central Weather Administration | | JMA | 🇯🇵 Japan | 日本語 | Japan Meteorological Agency |

API Reference

init(options)

await init({
  location: "dali",           // City name (supports pinyin, abbreviations)
  distanceThreshold: 300,     // Alert distance in km
  minMagnitude: 3.0,         // Minimum magnitude
  language: 'zh',            // Language: zh/en/ja
  sources: {                // Toggle data sources
    CENC: true,
    JMA: true,
    CWA: true
  }
})

getAll(options)

const result = await getAll({ limit: 5 })
// Returns: { earthquakes, totalCount, nearbyEarthquakes, hasAlert, alertMessage }

getCENC(limit)

const { earthquakes } = await getCENC(10)

getJMA(limit)

const { earthquakes } = await getJMA(10)

getCWA()

const { earthquakes, isWarning } = await getCWA()

start(options)

await start({ interval: 60000 })  // Check every 60 seconds

stop()

await stop()

config(newConfig)

// View
const cfg = await config()
// Update
await config({ language: 'en', minMagnitude: 4.0 })

cities()

const { cities } = await cities()

Configuration Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | location | string/object | 大理 | City name or {name, latitude, longitude} | | distanceThreshold | number | 300 | Alert distance in km | | minMagnitude | number | 3.0 | Minimum earthquake magnitude | | language | string | zh | Alert language: zh/en/ja | | sources.CENC | boolean | true | Enable China data | | sources.JMA | boolean | true | Enable Japan data | | sources.CWA | boolean | true | Enable Taiwan data | | webhook | string | null | Encrypted webhook URL |

Supported Cities (20+)

| City | Pinyin | Abbr | Coordinates | |------|--------|------|-------------| | 大理 | dali, dal, dl | DL | 25.61°N, 100.27°E | | 北京 | beijing, bj, b | BJ | 39.90°N, 116.40°E | | 上海 | shanghai, sh, s | SH | 31.23°N, 121.47°E | | 昆明 | kunming, km, k | KM | 25.04°N, 102.71°E | | 成都 | chengdu, cd, c | CD | 30.57°N, 104.07°E | | 东京 | tokyo, dj, d | DJ | 35.68°N, 139.69°E | | ... | ... | ... | ... |

Location Matching Examples

All these return Beijing:

await init({ location: '北京' })      // Chinese
await init({ location: 'beijing' })   // Full pinyin
await init({ location: 'bj' })        // Abbreviation
await init({ location: 'bei' })       // Partial match

Multi-Language Alerts

Alert language is automatically selected based on earthquake source:

| Source | Language | Example | |--------|----------|---------| | CENC (China) | 中文 | ⚠️ 地震预警提醒！ | | CWA (Taiwan) | 中文 | ⚠️ 地震预警提醒！ | | JMA (Japan) | 日本語 | ⚠️ 地震アラート！ |

Manual Language Override

// Set preferred language (applies to alert format)
await init({ language: 'en' })
// All alerts will be in English regardless of source

Alert Message Format

⚠️ Earthquake Alert!
📍 Epicenter near Dali:
1. 🔴 M7.6级 [中国地震台网]
   📍 汤加群岛
   📏 Distance: 5000km
   ⏰ 2026-03-24 12:37:50
   📊 Depth: 250km
Please stay safe!

Security

Webhook URLs are encrypted using AES-256-CBC before storing in config file:

// Set webhook (automatically encrypted)
await config({ webhook: 'https://oapi.dingtalk.com/robot/send?access_token=xxx' })
// Stored encrypted, decrypted only in memory

Performance

Shared Cache

Parallel Fetching

Return Format

{
  timestamp: "2026-03-24T14:30:00.000Z",
  sources: [
    { source: "CENC", sourceName: "中国地震台网", count: 10, earthquakes: [...] },
    { source: "JMA", sourceName: "日本气象厅", count: 5, earthquakes: [...] }
  ],
  earthquakes: [...],      // Merged, sorted by time
  totalCount: 15,
  nearbyEarthquakes: [...], // Within distanceThreshold
  hasAlert: true/false,
  alertMessage: "..."       // Formatted alert string
}

Notes

Support

// Initialize monitoring
await init({ location: "大理" })
// Get latest earthquakes
await getAll()
// Start proactive monitoring
await start()