avisos-pe

Avisos del SENAMHI (Perú) en formatos que una máquina puede usar: JSON, GeoJSON y CAP 1.2, más un CLI agent-first que responde:

¿Qué avisos cubren este punto, hoy y en los próximos días?

Cubre los avisos meteorológicos nacionales (lluvias, vientos, temperaturas, con niveles amarillo, naranja y rojo por día) y el aviso de corto plazo ante posible activación de quebradas (huaicos). Es la segunda pieza del conjunto para El Niño 2026-2027, junto a peligros-pe.

Reproduce avisos oficiales sin modificar su nivel, vigencia ni zonas. No es una orden de evacuación. Que no haya avisos para un punto no garantiza que no ocurran lluvias intensas o huaicos. Sigue a INDECI, SENAMHI y tu municipalidad.

Uso

npm i -g @osrcmap/avisos-pe            # o: npx @osrcmap/avisos-pe ...

avisos-pe punto --lat -5.0104 --lon -79.2468      # ¿qué avisos cubren este punto?
avisos-pe vigentes                                 # todos los avisos activos
avisos-pe aviso 421                                # descripción oficial y provincias
avisos-pe aviso 421 --geojson > aviso-421.geojson  # polígonos por día y nivel
avisos-pe cap 421 > aviso-421.cap.xml              # CAP 1.2
avisos-pe cap quebradas                            # aviso de quebradas en CAP
avisos-pe punto --lat -11.94 --lon -76.70 --momento 2026-10-19T15:00-05:00

Avisos del SENAMHI para (-5.01039, -79.24678) al 2026-10-17 04:08 (hora de Perú)
● 421-2026 PRECIPITACIONES EN LA SIERRA NORTE Y COSTA NORTE
    2026-10-17: nivel AMARILLO (en curso)
    2026-10-18: nivel NARANJA (proximo)
    2026-10-19: nivel AMARILLO (proximo)
● Activación de quebradas 289-2026: nivel AMARILLO hasta 10-17 13:00 — EL CARMEN DE LA FRONTERA
    Ante el pronóstico de lluvias es probable la activación de quebradas de magnitud moderada ...
    Estar atentos a la información oficial y seguir las instrucciones de las autoridades competentes.

Comandos

| Comando | Qué hace | |---|---| | punto --lat --lon [--tipo] [--momento] | Avisos cuyas zonas contienen el punto, día por día, con nivel y texto oficial del nivel. | | vigentes [--tipo] [--momento] | Avisos que no han terminado, con los niveles de cada día y las zonas de quebradas. | | aviso <n> [--anio] [--geojson] | Descripción oficial, niveles y provincias por día; o los polígonos en GeoJSON. | | cap <n\|quebradas> [--anio] | El aviso en CAP 1.2 (XML), validado contra el esquema OASIS. | | schema [comando] | JSON Schema de las entradas. | | doctor [--sin-red] | Caché local y que las publicaciones del SENAMHI se puedan leer. |

• --tipo: todos (por defecto), meteorologico o quebradas.
• --momento: ISO 8601 con zona horaria (2026-10-19T15:00-05:00). Sirve para preguntar por mañana o por un momento pasado.
• --sin-cache: las respuestas del SENAMHI se guardan 10 minutos en ~/.cache/avisos-pe para no saturarlo; este flag las ignora.
• Niveles: 1 verde, 2 amarillo, 3 naranja, 4 rojo. El nivel 1 ("no es necesario tomar precauciones especiales") no se reporta como aviso: el SENAMHI lo usa para el resto del territorio.

Para agentes

• JSON por defecto cuando stdout no es una terminal (--json lo fuerza); cap siempre emite XML.
• --params '{"lat":-12.05,"lon":-77.04}' o --params @consulta.json.
• Errores en stdout: { "ok": false, "code", "error", "hint" }. Salida 2 uso incorrecto, 1 fuente o internos.
• Siguientes pasos en stderr como NDJSON {"type":"next-step", ...}.
• Toda respuesta trae datos.obtenido_en (cuándo se consultó al SENAMHI) y aviso. Muestra el aviso al usuario final.
• Ver SKILL.md.

| Código | Cuándo | Qué significa | |---|---|---| | FUENTE_NO_DISPONIBLE | El SENAMHI no respondió | No se puede afirmar que no haya avisos | | FORMATO_INESPERADO | El SENAMHI cambió su publicación | No se puede afirmar que no haya avisos | | FUERA_DE_COBERTURA | Punto fuera del Perú | Casi siempre lat/lon invertidos | | NO_ENCONTRADO | aviso/cap con un número que no existe | Revisa --anio | | ARGS_INVALIDOS, PARAMS_INVALIDOS | Entrada mal formada | Ver schema <comando> |

Si el SENAMHI no publicó las zonas de algún día de un aviso, punto lo lista en no_evaluables: nunca se omite en silencio.

Ejecútalo desde el Perú. senamhi.gob.pe no responde a conexiones desde servidores en el extranjero o en la nube (por ejemplo, GitHub Actions). Un bot debe correr en el Perú o salir por un proxy peruano.

Cobertura

| Publicación del SENAMHI | Cubierta | Cómo | |---|---|---| | Avisos meteorológicos nacionales | Sí | Tabla de avisos + polígonos por día (GeoServer WFS) | | Aviso de corto plazo ante posible activación de quebradas | Sí, el vigente | Página del aviso + polígonos por distrito (WFS) | | Avisos hidrológicos | No | Pendiente (RESEARCH.md) | | Avisos de las direcciones zonales | No | Pendiente | | CAP oficial | No existe | avisos-pe cap genera una reproducción no oficial |

Detalles y riesgos en LIMITATIONS.md. Cómo funciona cada fuente, en RESEARCH.md.

Desarrollo

bun install
bun test                   # con fixtures reales y un servidor local que imita al SENAMHI
bun run typecheck && bun run lint
bun run build              # dist/cli.js (Node >= 20)
node scripts/humo.mjs      # prueba de humo del paquete compilado, sin red

Variables AVISOS_PE_BASE_WEB y AVISOS_PE_BASE_GEO cambian las URLs base (pruebas o espejos).

Bloques de cligentic (MIT) copiados en src/agent, src/foundation y src/platform.

Licencia

Código: MIT. Los avisos son del SENAMHI; atribúyelos siempre al SENAMHI y enlaza el aviso original (url en cada respuesta).