@crafter/jne-cli

CLI agent-first para consultar informacion electoral publica del Jurado Nacional de Elecciones.

   ██╗███╗   ██╗███████╗
   ██║████╗  ██║██╔════╝
   ██║██╔██╗ ██║█████╗
██ ██║██║╚██╗██║██╔══╝
╚████║██║ ╚████║███████╗
 ╚═══╝╚═╝  ╚═══╝╚══════╝

v0.1.0 · JNE public electoral data · agent-first

Instalacion

bun add -g @crafter/jne-cli

Desde este repositorio:

bun install
bun jne-cli --help

Inicio rapido

jne-cli status --json

{"ok":true,"status":"reachable","auth":"public-no-auth","processCount":23}

jne-cli procesos list --limit 3

JNE processes (3)
  ID    SIGLA        STATUS         NAME
  84    ERM.2018     ACTIVO (U)     ELECCIONES REGIONALES Y MUNICIPALES 2018
  85                 ACTIVO (U)     REFERÉNDUM NACIONAL 2018
  86    SER.2018     ACTIVO (U)     SEGUNDA ELECCIÓN REGIONAL 2018

jne-cli candidatos search --dni 4518**** --process 84 --json

{"ok":true,"status":"found","count":1,"candidates":[{"dniRedacted":"4518****","office":"CONSEJERO REGIONAL","expedienteCode":"ERM.2018002685"}]}

Comandos

jne-cli status
jne-cli schema <status|procesos|candidatos|expedientes|autoridades|hoja-vida>
jne-cli procesos list [--limit n] [--active]
jne-cli candidatos search --dni <dni> --process <id>
jne-cli expedientes get <codigo>
jne-cli autoridades search --process <id> --type <tipo> --ubigeo <codigo>
jne-cli hoja-vida get --candidate-id <id>

Todos los comandos soportan --json. Cuando stdout no es TTY, el CLI emite JSON o NDJSON de forma automatica y escribe notas en stderr como NDJSON estructurado.

webctl

El IR incluido describe endpoints publicos capturados en portal.jne.gob.pe.

webctl install ./packages/cli/webctl.json

Este IR sirve como instalacion alternativa y como referencia de recon. Las operaciones principales del CLI usan endpoints confirmados en plataformahistorico.jne.gob.pe.

Legal

@crafter/jne-cli es una herramienta no oficial para acceder a informacion electoral publica en superficies web publicas relacionadas con JNE. No esta afiliada, respaldada ni operada por el Jurado Nacional de Elecciones. Algunos registros electorales publicos pueden contener datos personales, incluyendo informacion de candidatos vinculada a DNI. El usuario es responsable de usar esta herramienta con una finalidad licita, respetando la Ley 29733 de Peru, los terminos del portal JNE y cualquier regla electoral o de proteccion de datos aplicable. El CLI aplica limites conservadores, registra procedencia y no almacena payloads personales por defecto.

Licencia

MIT