onipin-cli

CLI oficial de OniPin — mismo protocolo /v1 que onipin-js, pensado para agentes IA (shell) o uso humano en terminal.

npm: https://www.npmjs.com/package/onipin-cli
MCP (alternativa): https://onnivers.store/mcp

Instalación

npm install -g onipin-cli
# o sin instalar:
npx onipin-cli <comando>

El binario se llama onipin.

Inicio rápido

export ONIPIN_PIN=onp_tu_pin
# opcional, para cuota/créditos de agente:
export ONIPIN_AGENT_KEY=ona_tu_clave

onipin ping
onipin catalog --text
onipin chat "Hola, ¿qué servicios ofrecen?"

Salida JSON por defecto (agentes). Usa --text para lectura humana.

Comandos

| Comando | Descripción | |--------|-------------| | ping | Discovery del negocio | | discover <url> | Resuelve pin desde un sitio | | handshake [intent] | Handshake OniPin 0.2 | | catalog | Productos/servicios | | chat <mensaje> | Envía mensaje | | messages | Lee el hilo (-c conversationId) | | poll | Espera respuesta bot/owner | | book | Crea reserva (--service --client --contact) | | order | Crea pedido (--product --client --contact) |

Opciones globales

| Flag | Env | Descripción | |------|-----|-------------| | -p, --pin | ONIPIN_PIN | Pin del negocio | | -k, --key | ONIPIN_AGENT_KEY | Clave agente ona_… | | --base-url | ONIPIN_BASE_URL | Default https://onnivers.store | | -a, --agent | — | Nombre del agente | | -c, --conversation-id | — | Reutilizar hilo | | --intent | — | Intent OniPin | | --json / --text | — | Formato de salida |

Ejemplos para agentes

npx onipin-cli ping --pin onp_xxx
npx onipin-cli chat --pin onp_xxx "Quiero cita mañana 10:00" --intent appointment.create
npx onipin-cli book --pin onp_xxx --service "Corte" --client "Ana" --contact "[email protected]" --date "mañana 10:00"
npx onipin-cli order --pin onp_xxx --product "Kit" --client "Ana" --contact "[email protected]" --qty 2

MCP vs CLI

| Canal | Cuándo | |-------|--------| | MCP | Cliente con conector MCP (Cursor, Claude, ChatGPT) | | CLI | Agente con shell / scripts / CI |

Ambos hablan con la misma API pública /v1.