mtc-sutran-cli

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

CLI agent-first para consultas públicas de cumplimiento MTC/SUTRAN: licencias, puntos, papeletas, infracciones y entidades complementarias.

Instalación

bun add -g @crafter/mtc-sutran-cli

En desarrollo local:

bun install
bun mtc-sutran-cli --help

Inicio rápido

mtc-sutran-cli status --json

Salida resumida:

{"ok":true,"auth":"public-no-auth","sources":[{"name":"mtcLicense","ok":true},{"name":"mtcPoints","ok":true,"blocker":"captcha"}]}

mtc-sutran-cli license status --dni 12345678 --purpose fleet-compliance --consent documented --dry-run --json

Salida resumida:

{"ok":true,"dryRun":true,"status":"would-query","input":{"dniRedacted":"1234****"}}

mtc-sutran-cli entity search --type escuela --region lima --json

Salida resumida:

{"ok":true,"status":"metadata-found","sourceCapabilities":{"supportsComplementaryEntities":true}}

Comandos

• status: revisa conectividad con fuentes oficiales MTC/SUTRAN.
• schema <resource>: imprime contratos JSON para agentes.
• license status: valida y previsualiza una consulta de licencia MTC. La consulta live queda bloqueada hasta confirmar endpoint seguro.
• driver record: valida y previsualiza récord de conductor, puntos y papeletas.
• sutran infractions: valida placa o ticket y revisa disponibilidad de fuente SUTRAN.
• entity search: obtiene metadata oficial MTC sobre entidades complementarias.
• infraccion payment-ticket: preflight dry-run para flujo de pago. No genera ni paga.

Recursos de schema:

mtc-sutran-cli schema license-status --json
mtc-sutran-cli schema driver-record --json
mtc-sutran-cli schema sutran-infractions --json
mtc-sutran-cli schema entity-search --json
mtc-sutran-cli schema payment-ticket --json

webctl

webctl IR pendiente. No hay manifiestos HAR, capturas de XHR ni screenshots oficiales para este portal en v0.1.0.

Legal

@crafter/mtc-sutran-cli is an unofficial tool for agent-first interaction with public MTC/SUTRAN consultation workflows. License, DNI, plate, and infraction data may be personal data under Peru's Ley 29733. You are responsible for having a lawful basis, valid consent when required, and a specific legitimate purpose before querying or processing this data. The CLI minimizes data by default, records source provenance, and does not store personal payloads unless explicitly configured.

Licencia

MIT