sunedu-cli

CLI no oficial, agent-first, para consultar flujos publicos de verificacion SUNEDU con salida JSON estable, auditoria local y controles de privacidad.

  █████ █   █ █   █ █████ ████  █   █
  █     █   █ ██  █ █     █   █ █   █
  █████ █   █ █ █ █ ████  █   █ █   █
      █ █   █ █  ██ █     █   █ █   █
  █████  ███  █   █ █████ ████   ███
  ═════════════════════════════════════

Instalar

bun add -g @crafter/sunedu-cli

Uso rapido

sunedu-cli status --json

Salida resumida:

{"ok":true,"status":"ok","version":"0.1.0","portal":{"reachable":true,"auth":"public-no-auth","apiSurface":"undocumented-json"}}

sunedu-cli carne processes --json

Salida real:

{"ok":true,"status":"found","processes":[{"id":2,"year":"2021"},{"id":3,"year":"2022"},{"id":4,"year":"2023"},{"id":5,"year":"2024"},{"id":6,"year":"2025"},{"id":7,"year":"2026"}]}

sunedu-cli grado verify --dni 12345678 --purpose hr-verification --dry-run --json

Salida resumida:

{"ok":true,"dryRun":true,"status":"would-query","input":{"queryKind":"dni","documentNumberRedacted":"1234****"}}

Comandos

• sunedu-cli status: revisa conectividad, runtime y endpoints verificados.
• sunedu-cli whoami: alias de status.
• sunedu-cli schema <resource>: imprime contratos JSON para agentes.
• sunedu-cli grado verify: valida entrada para Registro Nacional de Grados y Titulos. Consulta real requiere --turnstile-token.
• sunedu-cli constancia verify: verifica QR o URL de constancia cuando el dato es suficiente. Codigo suelto queda como needs-recon.
• sunedu-cli constancia request: preflight de solicitud de constancia. v0.1.0 no envia formularios.
• sunedu-cli carne processes: lista procesos publicos de carne universitario.
• sunedu-cli carne status: valida o consulta estado de carne. Consulta real requiere --turnstile-token.
• sunedu-cli consulta types: lista tipos publicos de consulta SUNEDU.
• sunedu-cli audit tail: lee auditoria local JSONL.

Recursos de schema:

sunedu-cli schema grado-verify --json
sunedu-cli schema constancia-verify --json
sunedu-cli schema constancia-request --json
sunedu-cli schema carne-status --json
sunedu-cli schema audit-entry --json
sunedu-cli schema status --json

JSON para agentes

Todas las operaciones aceptan:

--json
--output auto|json|table|ndjson
--params '{"dni":"12345678","purpose":"hr-verification","dryRun":true}'
--fields ok,status,input
--purpose "hr-verification"
--dry-run
--no-store

Cuando stdout no es TTY, el CLI emite JSON automaticamente. Notas y siguientes pasos van a stderr como NDJSON estructurado.

webctl IR

webctl IR pending. No hay artefactos HAR, screenshots ni manifiestos IR para SUNEDU en v0.1.0.

Legal

sunedu-cli is an unofficial tool for agent-first interaction with public SUNEDU verification workflows. DNI-linked education data may be personal data under Peru's Ley 29733. You are responsible for having a lawful basis and a specific purpose before querying or processing credential records. The CLI minimizes data by default, records provenance, redacts audit logs, and does not store personal payloads unless explicitly configured.

This project is not affiliated with, endorsed by, or operated by SUNEDU.

Licencia

MIT