Documentación

Construye con OniPin

Instala el chat, conecta IAs por HTTP o MCP. Ejemplos con pin ficticio onp_tu_pin.

Qué puedes usar hoy (MCP, CLI, SDK, HTTP)

Plataforma real en producción. Solo necesitas el pin del negocio.

  • MCP — https://onnivers.store/mcp (Cursor, Claude)
  • CLI — npm install -g onipin-cli
  • SDK JS — npm install onipin-js
  • React — npm install onipin-react (OniChat)
  • SDK Python — pip install onipin
  • HTTP /v1 + OpenAPI — https://onnivers.store/v1/openapi.yaml
  • Widget — /widget.js
Cursor MCP 
{
  "mcpServers": {
    "onipin": { "url": "https://onnivers.store/mcp" }
  }
}

Empezar con OniPin

  1. Regístrate gratis y confirma tu correo.
  2. En MI IA configura negocio, FAQs y catálogo.
  3. Comparte https://onnivers.store/c/onp_tu_pin o instala el widget.
  4. En CHATS toma el control cuando quieras.

Instalar el chat en tu web

HTML 
<script src="https://onnivers.store/widget.js" data-pin="onp_tu_pin"></script>

React (paquete oficial)

React 
npm install onipin-react

import { OniChat } from "onipin-react";

<OniChat pin="onp_tu_pin" />
<OniChat pin="onp_tu_pin" mode="iframe" height={640} />

Protocolo HTTP /v1

GET /v1/ping/{pin}

Discovery del negocio.

curl 
curl https://onnivers.store/v1/ping/onp_tu_pin
POST /v1/chat/{pin}

Envía mensaje; devuelve conversationId y reply.

curl 
curl -X POST https://onnivers.store/v1/chat/onp_tu_pin \
  -H "Content-Type: application/json" \
  -H "X-Caller-Type: ai-agent" \
  -d '{ "message": "¿Horarios?" }'
GET /v1/catalog/{pin}

Catálogo público de productos y servicios.

Discovery e Intent Spec (IA ↔ negocio)

Guía para asistentes: Cómo una IA decide usar OniPin

meta tag 
<meta name="onipin" content="onp_tu_pin">
well-known plataforma 
curl "https://onnivers.store/.well-known/onipin"
well-known negocio 
curl "https://onnivers.store/.well-known/onipin.json?pin=onp_tu_pin"
descubrir desde URL 
curl "https://onnivers.store/v1/discover?url=https://example.com"
handshake 
curl -X POST https://onnivers.store/v1/handshake/onp_tu_pin \
  -H "Content-Type: application/json" \
  -d '{"agent":{"name":"MyBot"},"intent":"appointment.create"}'

Intent Specification 0.2

Cómo una IA decide usar OniPin

El usuario dice "agenda una cita" — no "usa OniPin". Esta spec define el flujo que cualquier asistente puede implementar.

Flujo en 5 pasos

  1. Descubrir — ¿El negocio publica OniPin? (/v1/discover, meta onipin, llms.txt)
  2. Handshake — Anunciar agente + intención (POST /v1/handshake/{pin})
  3. Enviar mensaje — POST /v1/chat/{pin}
  4. Recibir respuesta — Texto + conversationId
  5. Acción — Cita/pedido en Agenda (data.bookingId / orderId)

Descubrir desde URL

curl 
curl "https://onnivers.store/v1/discover?url=https://onnivers.store/probar-chat/"

Handshake

curl 
curl -X POST https://onnivers.store/v1/handshake/onp_vuzadcjv3xw7 \
  -H "Content-Type: application/json" \
  -d '{"agent":{"name":"MyBot","version":"1.0"},"intent":"appointment.create"}'

Chat con intent

curl 
curl -X POST https://onnivers.store/v1/chat/onp_vuzadcjv3xw7 \
  -H "Content-Type: application/json" \
  -H "X-Caller-Type: ai-agent" \
  -d '{"message":"Quiero demo el viernes","agent":{"name":"MyBot"},"intent":"appointment.create"}'

Intenciones

  • business.chat — conversación general
  • appointment.create — cita / demo
  • order.create — pedido
  • product.price — precio
  • catalog.browse — catálogo
  • payment.info — pago

Pin demo:onp_vuzadcjv3xw7

Servidor MCP

Endpoint https://onnivers.store/mcp — Endpoint — usa POST (Streamable HTTP). No es una página web; conéctalo desde Cursor o Claude.

  • descubrir_url, handshake, buscar_negocio, enviar_mensaje
  • leer_conversacion, obtener_catalogo, crear_reserva, comprar_producto
.cursor/mcp.json 
{ "mcpServers": { "onipin": { "url": "https://onnivers.store/mcp" } } }

CLI onipin-cli (npm)

Para agentes IA con terminal (Cursor Agent, Claude Code, scripts). Misma API /v1; salida JSON por defecto.

install 
npm install -g onipin-cli
# o: npx onipin-cli ping --pin onp_tu_pin --text
examples 
onipin ping --pin onp_tu_pin --text
onipin catalog --pin onp_tu_pin --text
onipin chat --pin onp_tu_pin "¿Qué servicios ofrecen?" --text
onipin book --pin onp_tu_pin --service "Demo" --client "Ana" --contact "ana@email.com" --date "mañana 10:00"
onipin order --pin onp_tu_pin --product "Plan Pro" --client "Ana" --contact "ana@email.com" --qty 1

Paquete: onipin-cli · MCP sigue recomendado en Cursor/Claude (incluye créditos). El CLI cubre ping, chat, catálogo, reservas y pedidos.

SDK (npm + React + CLI + PyPI)

install 
npm install onipin-js
npm install onipin-react
npm install -g onipin-cli
pip install onipin
sdk.mjs 
import { OniPinClient } from "onipin-js";

const oni = new OniPinClient({
  baseUrl: "https://onnivers.store",
  pin: "onp_tu_pin",
  callerType: "ai-agent",
});

const info = await oni.ping();
await oni.handshake("appointment.create");
const chat = await oni.chat("Quiero demo el viernes", { intent: "appointment.create" });
console.log(chat.reply?.text);
OniChat.tsx 
import { OniChat } from "onipin-react";

export function Support() {
  return <OniChat pin="onp_tu_pin" />;
}
sdk.py 
from onipin import OniPinClient

oni = OniPinClient(pin="onp_tu_pin", agent={"name": "MyBot", "version": "1.0"})
oni.handshake("business.chat")
print(oni.chat("Quiero demo el viernes", intent="business.chat").get("reply"))

onipin-js · onipin-react · onipin-cli · onipin (PyPI) · OpenAPI