Developers

API, CLI y Estado de Fuentes sobre el mismo núcleo normalizado con procedencia para Perú y Colombia.

Referencia de la API
Contrato OpenAPI con referencia interactiva (Scalar): endpoints /v1, esquemas y consultas de prueba.
OpenAPI JSON
El documento OpenAPI 3.1 es la fuente de verdad de documentación y validación.
Estado de Fuentes
Lo que observa nuestro consumidor sobre las fuentes públicas que usa este proyecto.

Úsalo con coding agents

Instala la skill de `sismo` y tu agente (Claude Code, Cursor, Codex…) aprende a operar cada vertical — sismos, ondas, volcanes, verificación y salud de fuentes — con salida JSON, exit codes estables y procedencia en cada respuesta.

npx skills add crafter-research/sismo-abierto

Introspección en runtime: `sismo skill` imprime la documentación agent-first completa · `--open` abre la fuente oficial de cualquier dato

CLI `sismo`

El binario `sismo` consume los mismos adaptadores normalizados que esta web y la API.

bunx --bun @crafter/sismo-cli latest
bunx --bun @crafter/sismo-cli events --since 7d --min-magnitude 4 --format geojson
SISMO_SGC_PROVIDER=true bunx --bun @crafter/sismo-cli latest --provider sgc
SISMO_SGC_PROVIDER=true bunx --bun @crafter/sismo-cli events --provider sgc --since ytd --min-magnitude 3 --format json
bunx --bun @crafter/sismo-cli incident colombia-2026-08-10 --json
bunx --bun @crafter/sismo-cli inspect EVENT_ID
bunx --bun @crafter/sismo-cli stations EVENT_ID --sort pga
bunx --bun @crafter/sismo-cli waveform EVENT_ID STATION_ID --format csv
bunx --bun @crafter/sismo-cli volcanoes
bunx --bun @crafter/sismo-cli volcano VOLCANO_SLUG
bunx --bun @crafter/sismo-cli sources
bunx --bun @crafter/sismo-cli source SOURCE_ID --evidence
bunx --bun @crafter/sismo-cli schema COMMAND

Salida humana en tablas · --json, --geojson y --csv sin decoración · errores a stderr con códigos de salida estables

Badges de fuentes

Cada fuente ofrece un SVG cacheable con el estado observado por nuestro consumidor. No representa el estado interno del IGP ni del SGC.

/api/v1/sources/igp-aceldat/badge.svg
/api/v1/sources/sgc-sismos/badge.svg

Principios del contrato

Cada respuesta incluye fuente, hora de consulta, procedencia y limitaciones.
No hay SDKs mantenidos a mano: el contrato es OpenAPI.
Los datasets se consultan en origen; no se redistribuyen.
Sin API keys en esta etapa. Sé conservador con la frecuencia de tus consultas.