# onpe-cli lleva los resultados electorales a la terminal

> Una CLI pensada para agentes con datos electorales de la ONPE: mesas, actas, rankings y resúmenes.

**Publicado:** 20 de abril de 2026 | **Área:** Research | **Tipo:** Ship | **Crafters:** Railly Hugo

![](https://crafter.run/changelog/onpe-cli/cover.webp)

---

onpe-cli consulta la API oficial de resultados electorales del Perú desde la terminal. Es para periodistas, analistas y agentes de IA que necesitan mesas, actas y resúmenes como datos y no como una página web. No requiere autenticación. La documentación está en [onpe-cli.crafter.run](https://onpe-cli.crafter.run).

<Clip src="/changelog/onpe-cli/resumen.mp4" poster="/changelog/onpe-cli/resumen.webp" size="1280x800" alt="onpe-cli resumen mostrando las actas contabilizadas y la participación, y luego los mismos datos en JSON" caption="El mismo comando da una vista para personas en la terminal y JSON para un agente." />

## Una salida para personas y otra para agentes

En la terminal, `onpe-cli resumen` dibuja barras de avance para las actas contabilizadas y la participación. Con un pipe o con `--json`, devuelve JSON y sugerencias del siguiente paso que le dicen al agente qué comando correr después.

## Del resumen nacional a una sola mesa

Busca una mesa por su código, lee un acta completa por ID, lista ubigeos por departamento, provincia o distrito, u obtén la URL de descarga de un archivo de acta. `onpe-cli doctor` revisa que la API de la ONPE responda antes de empezar.

![Portada de onpe-cli: Query ONPE with one CLI](https://crafter.run/changelog/onpe-cli/home.webp)

*La portada en onpe-cli.crafter.run.*

## Pruébalo

```bash
bun add -g @crafter/onpe-cli
onpe-cli resumen
onpe-cli mesa 900001 --json
```



- `resumen`: resumen general de la elección
- `ranking`: ranking nacional de candidatos
- `mesa <codigo>` y `acta <id>`: una mesa o un acta en detalle
- `ubigeos [nivel] [padre]`: departamentos, provincias y distritos
- `file-url <fileId>`: URL de descarga de un archivo de acta
- `doctor`: conectividad y estado de la API

---

**Repositorios**

- [crafter-research/onpe-cli](https://github.com/crafter-research/onpe-cli)

**Enlaces**

- [Abrir la documentación](https://onpe-cli.crafter.run)

**Fuentes**

- https://github.com/crafter-research/onpe-cli
- https://www.npmjs.com/package/@crafter/onpe-cli
- https://onpe-cli.crafter.run

**Todos los cambios:** [Índice en Markdown](https://crafter.run/es/changelog/sitemap.md) | [Crafter Station](https://crafter.run)
