Weather, Storm Watch, Earthquakes & All Natural Disasters
Live multi-hazard feeds for _AugmentedIntelligence via free public APIs (no paid keys by default).
Sources
| Feature | API | Coverage | Auth |
|---|---|---|---|
| Current weather + forecast + geocoding | Open-Meteo | Global | None |
| Watches / warnings (flood, fire weather, tornado, hurricane, tsunami, heat, winter, …) | NWS api.weather.gov | US | Free; User-Agent required |
| Earthquakes | USGS GeoJSON | Global | None |
| Open natural events (wildfire, volcano, flood, storm, drought, landslide, …) | NASA EONET v3 | Global | None |
| Multi-hazard coordination alerts (EQ, TC, FL, VO, DR, WF, TS) | GDACS | Global | None |
| Space weather (geomagnetic / solar) | NOAA SWPC | Global / near-Earth | None |
Storm risk score (0–100) is a local heuristic from Open-Meteo wind, precip, and thunder codes. Official products come from NWS / GDACS / agencies.
Categories monitored
earthquake · tsunami · volcano · wildfire · flood · storm · hurricane · tornado · drought · landslide · heat · cold · winter · avalanche · space · dust · ice · other
NWS event names are classified into these tokens; EONET/GDACS map into the same vocabulary.
Commands
# Weather / storm / quake (existing)
weather status|doctor|metrics|selftest|help
weather mock on|off
weather set <lat> <lon> [name]
weather locate <city...>
weather area WA
weather now | forecast [days]
weather alerts | watch | summary
storm watch
earthquake recent [min_mag] [hours] | significant
# All natural disasters
disaster all # merge every source
disaster list [category] # filter e.g. flood wildfire volcano
disaster desk # weather + full multi-hazard desk
disaster categories
disaster eonet | gdacs | space # single feed
disaster monitor on [seconds] # background poll (default 300s)
disaster monitor off|status|snapshot
disaster selftest|doctor|status
natural disaster all # alias
hazards flood # alias
weatherkit disaster|summary
disasterkit all|desk|monitor on
Background monitor
disaster monitor on 300
disaster monitor status
disaster monitor snapshot
disaster monitor off
Polls NWS + USGS + EONET + GDACS + SWPC on an interval, remembers seen event IDs, and prints NEW lines when something appears. Minimum interval 60 s.
Environment
| Variable | Meaning |
|---|---|
AI_WEATHER_LAT / AI_WEATHER_LON |
Default coordinates |
AI_WEATHER_LOCATION |
Label (default Seattle) |
AI_WEATHER_NWS_AREA |
Optional 2-letter state for alerts |
AI_WEATHER_MOCK / AI_WEATHER_FORCE_MOCK |
Force offline fixtures |
AI_WEATHER_USER_AGENT |
Override NWS User-Agent |
AI_WEATHER_TIMEOUT |
HTTP timeout seconds (default 20) |
Offline / CI
weather mock on
disaster selftest
disaster all
disaster flood
disaster monitor on 60
Embedded mocks cover multi-hazard NWS events, EONET, GDACS, SWPC. Optional fixtures: tests/fixtures/weather/*.json.
Lua
Bindings: weather_* / disaster_* (see LuaBrainstormAPI.md).
simple script execute lua_scripts/Natural-Disasters-Watch.lua
simple script execute lua_scripts/Features-V11-Harness.lua
weather_mock(true)
print(disaster_selftest())
print(disaster_all("flood"))
disaster_monitor_start(300)
Files
| Path | Role |
|---|---|
WeatherHazards.hpp / .cpp |
Module |
weatherkit / disasterkit plugins |
Plugin SDK façade |
lua_scripts/Natural-Disasters-Watch.lua |
Desk harness |
lua_scripts/Features-V11-Harness.lua |
Full v11 feature suite |
docs/WeatherHazards.md |
This doc |
Limits & honesty
- NWS is US-centric. Outside the US, weather (Open-Meteo) + EONET + GDACS + USGS + SWPC still work; NWS alerts may be empty.
- Feeds can lag, drop, or rate-limit; parsers are best-effort JSON extractors, not full GeoJSON libraries.
- Not a substitute for Wireless Emergency Alerts, NOAA Weather Radio, or local emergency authorities.
- Space weather is included as a natural hazard family (geomagnetic/solar) via SWPC.