Manual de usuario de LicenRoute
Publica tu API, cobra por ella en tu propia cuenta de Stripe y deja que personas y agentes de IA la prueben y la compren.
El panel (app.licenroute.com) y el Market ya están en línea en un piloto; los pagos funcionan en modo de pruebas de Stripe, sin dinero real. Los pantallazos son de una demostración local con datos de ejemplo.
Qué es LicenRoute
LicenRoute te permite cobrar por tu API sin montar facturación: cada comprador recibe una clave con su cuota, y tú cobras en tu propia cuenta de Stripe.
| Quién eres | Dónde trabajas | Secciones |
|---|---|---|
| Dueño de una API: la publicas y cobras por ella | Panel de LicenRoute (Central) | Primeros pasos a Atender a tus compradores |
| Comprador: buscas una API, la pruebas y la compras | LicenRoute Market | Guía del comprador |
| Asistente o agente de IA que busca APIs | Catálogo legible por máquinas y servidor MCP | Para agentes de IA |
Primeros pasos en el panel
Entra con tu correo y contraseña; el panel abre en el Resumen de tu organización.
- Abre el panel e introduce tu correo y tu contraseña.
- En el Resumen ves cuántos sitios, API keys activas y miembros tiene tu organización, y los tres primeros pasos.
- Usa el menú superior para moverte.
| Menú | Para qué sirve |
|---|---|
| Resumen | Cifras de la organización y primeros pasos |
| Sitios | Tus APIs: dominio, claves, planes y fichas del Market |
| Compradores | Quién tiene licencias tuyas y su uso |
| Solicitudes Market | Peticiones de acceso a planes con aprobación manual |
| Cobros | Tu cuenta de Stripe conectada |
| Miembros | Personas de tu equipo y su rol (propietario, admin, lector) |
| Auditoría | Registro de cada cambio importante (solo admin y propietario) |
El botón con el nombre de la organización, arriba a la derecha, cambia de organización si perteneces a varias.
Registrar tu API y sus planes
Cada API es un sitio con su dominio; dentro del sitio defines los planes que se venden: qué rutas cobran, a qué precio y con cuánta cuota.
El sitio
- Ve a Sitios y pulsa Nuevo sitio: nombre, dominio de tu API y aceptación del consentimiento.
- En la página del sitio, crea una API key (se muestra una sola vez) y copia las tres variables de entorno a tu servidor.
- Lo normal es que tu asistente de IA haga la conexión con el prompt de licenroute.com; tú solo apruebas el cambio en tu terminal.
Los planes
En la pestaña Licencias del sitio ves sus planes; pulsa Editar en uno o crea otro.
| Campo | Qué significa | Ejemplo |
|---|---|---|
| Ruta licenciada | Qué rutas cobra el plan (glob) | /v1/** |
| Métodos | Qué métodos HTTP cobra; GET y HEAD comparten cuota | GET, HEAD |
| Precio y Por cada | Precio en céntimos por petición o por 1.000 | 300 por 1.000 = 3,00 € |
| Cuota | Peticiones que se compran de una vez | 10.000 (= 30,00 €) |
| Vigencia | Días que dura cada licencia | 30 |
| Límite por licencia | Peticiones por minuto; frena claves filtradas | 60 |
| Venta en el Market | Compra instantánea: pagan y reciben la clave al momento. Con mi aprobación: te piden acceso y decides | Compra instantánea |
| Prueba gratuita | Peticiones gratis, una vez por comprador y plan, durante 7 días | 50 |
El precio que ve el comprador se calcula solo: cuota × precio. Nunca se escribe a mano.
Cobrar en tu cuenta de Stripe
Las ventas se cobran en tu propia cuenta de Stripe: el dinero va directo a ti y LicenRoute no lo recibe ni lo retiene.
En el piloto este paso aún no está abierto: conectar Stripe y comprar llegan tras la revisión de seguridad. Mientras tanto, los compradores pueden probar tus APIs gratis.
- Ve a Cobros y pulsa Conectar mi cuenta de Stripe. Solo puede hacerlo la persona propietaria de la organización.
- Stripe te pide tus datos y los de tu banco. Si lo dejas a medias, vuelve y pulsa Continuar en Stripe.
- Al volver, el panel consulta a Stripe y muestra el estado. Con lista para cobrar, tus planes de compra instantánea muestran el botón Comprar en el Market.
| Estado | Qué significa |
|---|---|
| Sin cuenta conectada | Tus planes no se pueden comprar directamente; los compradores solo pueden solicitar acceso |
| Alta sin terminar | Faltan datos en Stripe |
| Alta enviada; Stripe la está revisando | Stripe aún no permite cobros |
| Lista para cobrar | Las ventas se cobran en tu cuenta |
Las comisiones de Stripe se cargan en tu cuenta como cualquier otro cobro tuyo. Comprobar estado en Stripe vuelve a consultar el estado cuando quieras.
Publicar tu API en el Market
La ficha es lo que ven los compradores: solo muestra lo que escribes en ella, el dominio y los planes que eliges. Nunca muestra tus rutas, límites, claves ni políticas.
- En el sitio, abre la pestaña Market y pulsa Nueva ficha.
- Rellena título, editor, categoría, resumen y descripción.
- Añade la documentación (por ejemplo tu
/openapi.json), el estado del servicio si lo tienes y un ejemplo de petición y respuesta. - Marca los planes que ofreces y elige la visibilidad.
- Guarda. Con visibilidad Pública, la ficha aparece en el catálogo.
| Visibilidad | Quién la ve |
|---|---|
| Oculta | Nadie |
| Solo con enlace | Quien tenga el enlace privado (se puede regenerar) |
| Pública | Cualquiera: el catálogo, catalog.json y licenroute.com/apis |
En el ejemplo escribe bgat_… en lugar de una clave: la ficha rechaza las claves con formato real. La dirección de la página pública (por ejemplo festivos-es) se genera a partir del título si la dejas vacía. La ficha muestra también las peticiones servidas en los últimos 30 días, calculadas a partir del uso real.
Atender a tus compradores
Con compra instantánea no tienes que hacer nada: el comprador paga y recibe su clave. Solo intervienes en los planes con tu aprobación y cuando quieres revisar o cortar un acceso.
Solicitudes del Market
- Abre Solicitudes Market: las pendientes salen primero y puedes filtrar por aprobadas, rechazadas o retiradas.
- Pulsa Revisar para ver quién pide acceso, si ha verificado su correo y el motivo.
- Aprobar abre un pago de Stripe para el comprador; la clave solo se entrega cuando el pago consta como pagado. Rechazar cierra la solicitud. En los dos casos puedes dejar una nota, y el comprador recibe un correo.
Compradores y licencias
En Compradores está cada persona con licencias tuyas, tanto de pago como de prueba. Al entrar en uno ves sus licencias, el uso de cada una y el botón para revocarlas. Una licencia revocada deja de funcionar en el acto, sin redesplegar tu API. Si suspendes a un comprador, no puede comprar ni probar tus APIs, y no se le dice por qué.
Guía del comprador
En el Market buscas una API, la pruebas gratis y la compras en un minuto. La clave que recibes se envía en cada petición como Authorization: Bearer bgat_….
Encontrar una API
El Catálogo lista las APIs públicas, con un buscador y un filtro por categoría. Al abrir una ficha ves qué hace, un ejemplo de petición y respuesta, la documentación, las peticiones servidas en 30 días y sus planes con el precio final.
Crear tu cuenta
- Pulsa Crear cuenta: nombre, correo, contraseña de 12 caracteres o más y aceptación de los términos.
- Abre el enlace que te llega por correo para verificar la cuenta. Sin verificar no puedes probar, comprar ni solicitar acceso.
- Entra con tu correo y tu contraseña.
Probar gratis y comprar
Con la sesión iniciada, cada plan de la ficha muestra sus botones:
| Botón | Qué pasa |
|---|---|
| Probar gratis | Recibes al momento una clave con la cuota de prueba (por ejemplo 50 peticiones durante 7 días). Una prueba por plan y hasta 3 al día |
| Comprar | Aún no está disponible en el piloto. Cuando lo esté, irás a la página de pago de Stripe y volverás a una página que te entrega la clave una sola vez |
| Solicitar acceso | Para planes con aprobación: explicas para qué lo necesitas y el dueño decide. Si aprueba, pagas y recibes la clave |
Copia la clave en cuanto la veas: no se vuelve a mostrar, porque LicenRoute solo guarda un resumen cifrado de ella. Si la pierdes, el dueño puede revocarla y tendrás que obtener otra.
Tus compras, pruebas y solicitudes
Mis compras muestra cada pago con su estado (pendiente, pagado, reembolsado…) y cada prueba con su uso. Mis solicitudes muestra las peticiones de acceso y la decisión del dueño. En Mi cuenta cambias tus datos, descargas tus datos o eliminas la cuenta.
Para agentes de IA
Los asistentes de IA pueden encontrar y recomendar APIs del Market por dos vías. Ninguna paga nada: el agente propone y una persona decide.
1. El catálogo en JSON. GET /market/catalog.json devuelve las fichas públicas con sus planes, precios, cuotas y pruebas, en el formato licenroute.market.catalog/v1. No incluye rutas internas, límites ni claves.
2. El servidor MCP. packages/market-mcp no tiene dependencias y ofrece tres herramientas:
| Herramienta | Qué devuelve |
|---|---|
search_apis | APIs que encajan con lo que pides ("festivos españa", "validar NIF"), con el precio más bajo |
get_api | Todo sobre una API: descripción, ejemplo, uso real y planes |
request_purchase | El enlace para que una persona active la prueba o compre |
Para conectarlo en Claude Code:
claude mcp add licenroute-market -e LICENROUTE_MARKET_URL=https://<tu-market>/market -- node <ruta>/packages/market-mcp/bin/licenroute-market-mcp.mjs
En Cursor se añade lo mismo en .cursor/mcp.json; el README del paquete trae el ejemplo.
Preguntas frecuentes y límites actuales
¿Se cobra dinero real? No. En el piloto puedes probar las APIs gratis; la compra sigue cerrada hasta la revisión de seguridad, y los pagos empezarán en modo de pruebas de Stripe.
¿Puedo usarlo ya con clientes de verdad? En piloto: el panel emite licencias reales y aplica las cuotas, y los compradores pueden probar APIs gratis. Cobrar dinero real llega tras la revisión de seguridad.
¿Qué pasa si LicenRoute no responde? Las rutas de pago de tu API devuelven 503 hasta que vuelve; las rutas públicas siguen funcionando.
He perdido mi clave. No se puede recuperar: solo se guarda un resumen cifrado. Pide al dueño que la revoque y consigue otra.
¿Qué responde una ruta de pago? Sin clave, 402 con el plan y el enlace de compra. Con clave válida, 200. Con una clave inventada o revocada, 403. Con la cuota agotada, 402.
¿Qué tecnologías admite? APIs en Node.js con Express 4 o 5. Para otros frameworks, escríbenos desde licenroute.com.