Add USGS Earthquake Hazards API source#81
Open
mbtariq82 wants to merge 1 commit intocalesthio:masterfrom
Open
Conversation
- Integrate USGS real-time earthquake monitoring - Fetch significant earthquakes (M≥4.0 or tsunami warnings) - Display as markers on globe/map with magnitude-based sizing - Add to dashboard layers and signals - Update source count to 28 across codebase - Add translations and README updates
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds the USGS Earthquake Hazards Program API as a new real-time data source to Crucix, providing natural disaster intelligence alongside existing geopolitical, economic, and satellite sources.
Why
Crucix provides comprehensive OSINT coverage but lacked natural disaster intelligence. Earthquakes represent critical signals that can:
Trigger geopolitical responses (humanitarian aid, border tensions)
Correlate with existing signals (radiation monitoring near nuclear sites, conflict zones)
Provide early warning for cascading events in volatile regions
Expand coverage into climate change and environmental monitoring domains
The USGS API fills this gap with reliable, real-time data that's free and doesn't require authentication.
Scope
Validation
Commands run:
Manual validation:
✅ USGS source returns structured earthquake data without errors
✅ Full sweep completes with 30 sources (29/30 successful)
✅ Dashboard server starts on port 3117
✅ Earthquake markers appear on globe/map with correct sizing
✅ Layer toggle includes new "Earthquakes" option
✅ No console errors in browser dev tools
Screenshots
Config and Docs
.env.exampleupdated if neededREADME.mdupdated if behavior changedSource Additions
If this PR adds a new source, explain:
why the source improves signal quality
The USGS source enhances Crucix's intelligence by adding natural disaster awareness, which often intersects with geopolitical events. Earthquakes can destabilize regions, trigger humanitarian crises, or correlate with military/nuclear activities. This provides early warning signals that complement existing conflict, radiation, and satellite monitoring.
whether it requires an API key
No API key required - uses public USGS GeoJSON feed.
how it degrades when the key is missing
Graceful degradation: If USGS API is down, source returns empty array with "No recent significant earthquake data" signal.
what changed in
apis/briefing.mjsanddashboard/inject.mjsbriefing.mjs: Added USGS import and runSource call in Tier 3
inject.mjs: Added earthquake data processing and signal extraction
Checklist