LicenRoute

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.

Actualizado: 2026-11-22

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 eresDónde trabajasSecciones
Dueño de una API: la publicas y cobras por ellaPanel de LicenRoute (Central)Primeros pasos a Atender a tus compradores
Comprador: buscas una API, la pruebas y la comprasLicenRoute MarketGuía del comprador
Asistente o agente de IA que busca APIsCatálogo legible por máquinas y servidor MCPPara 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.

  1. Abre el panel e introduce tu correo y tu contraseña.
  2. En el Resumen ves cuántos sitios, API keys activas y miembros tiene tu organización, y los tres primeros pasos.
  3. Usa el menú superior para moverte.
Entrada al panel.
Entrada al panel.
Resumen de la organización.
Resumen de la organización.
MenúPara qué sirve
ResumenCifras de la organización y primeros pasos
SitiosTus APIs: dominio, claves, planes y fichas del Market
CompradoresQuién tiene licencias tuyas y su uso
Solicitudes MarketPeticiones de acceso a planes con aprobación manual
CobrosTu cuenta de Stripe conectada
MiembrosPersonas de tu equipo y su rol (propietario, admin, lector)
AuditoríaRegistro 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

  1. Ve a Sitios y pulsa Nuevo sitio: nombre, dominio de tu API y aceptación del consentimiento.
  2. 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.
  3. 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.
Lista de sitios: una fila por API.
Lista de sitios: una fila por API.
Página de un sitio: datos, variables de entorno y API keys.
Página de un sitio: datos, variables de entorno y API keys.

Los planes

En la pestaña Licencias del sitio ves sus planes; pulsa Editar en uno o crea otro.

Planes de un sitio.
Planes de un sitio.
Edición de un plan.
Edición de un plan.
CampoQué significaEjemplo
Ruta licenciadaQué rutas cobra el plan (glob)/v1/**
MétodosQué métodos HTTP cobra; GET y HEAD comparten cuotaGET, HEAD
Precio y Por cadaPrecio en céntimos por petición o por 1.000300 por 1.000 = 3,00 €
CuotaPeticiones que se compran de una vez10.000 (= 30,00 €)
VigenciaDías que dura cada licencia30
Límite por licenciaPeticiones por minuto; frena claves filtradas60
Venta en el MarketCompra instantánea: pagan y reciben la clave al momento. Con mi aprobación: te piden acceso y decidesCompra instantánea
Prueba gratuitaPeticiones gratis, una vez por comprador y plan, durante 7 días50

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.

  1. Ve a Cobros y pulsa Conectar mi cuenta de Stripe. Solo puede hacerlo la persona propietaria de la organización.
  2. Stripe te pide tus datos y los de tu banco. Si lo dejas a medias, vuelve y pulsa Continuar en Stripe.
  3. 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.
Cobros con una cuenta conectada y lista para cobrar.
Cobros con una cuenta conectada y lista para cobrar.
EstadoQué significa
Sin cuenta conectadaTus planes no se pueden comprar directamente; los compradores solo pueden solicitar acceso
Alta sin terminarFaltan datos en Stripe
Alta enviada; Stripe la está revisandoStripe aún no permite cobros
Lista para cobrarLas 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.

  1. En el sitio, abre la pestaña Market y pulsa Nueva ficha.
  2. Rellena título, editor, categoría, resumen y descripción.
  3. 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.
  4. Marca los planes que ofreces y elige la visibilidad.
  5. Guarda. Con visibilidad Pública, la ficha aparece en el catálogo.
Fichas del sitio en el Market.
Fichas del sitio en el Market.
Edición de una ficha.
Edición de una ficha.
VisibilidadQuién la ve
OcultaNadie
Solo con enlaceQuien tenga el enlace privado (se puede regenerar)
PúblicaCualquiera: 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

  1. Abre Solicitudes Market: las pendientes salen primero y puedes filtrar por aprobadas, rechazadas o retiradas.
  2. Pulsa Revisar para ver quién pide acceso, si ha verificado su correo y el motivo.
  3. 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.
Bandeja de solicitudes.
Bandeja de solicitudes.
Revisión de una solicitud.
Revisión de una solicitud.

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é.

Compradores: Lucía aparece al activar su prueba gratuita.
Compradores: Lucía aparece al activar su prueba gratuita.

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.

Catálogo del Market.
Catálogo del Market.
Ficha de una API vista sin haber entrado.
Ficha de una API vista sin haber entrado.

Crear tu cuenta

  1. Pulsa Crear cuenta: nombre, correo, contraseña de 12 caracteres o más y aceptación de los términos.
  2. Abre el enlace que te llega por correo para verificar la cuenta. Sin verificar no puedes probar, comprar ni solicitar acceso.
  3. Entra con tu correo y tu contraseña.
Alta de cuenta.
Alta de cuenta.
Entrada al Market.
Entrada al Market.

Probar gratis y comprar

Con la sesión iniciada, cada plan de la ficha muestra sus botones:

BotónQué pasa
Probar gratisRecibes 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
ComprarAú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 accesoPara planes con aprobación: explicas para qué lo necesitas y el dueño decide. Si aprueba, pagas y recibes la clave
Ficha con la sesión iniciada: botones Comprar y Probar gratis.
Ficha con la sesión iniciada: botones Comprar y Probar gratis.
Clave de prueba (oculta en el pantallazo).
Clave de prueba (oculta en el pantallazo).

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.

Mis compras y pruebas.
Mis compras y pruebas.

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.

catalog.json visto en el navegador.
catalog.json visto en el navegador.

2. El servidor MCP. packages/market-mcp no tiene dependencias y ofrece tres herramientas:

HerramientaQué devuelve
search_apisAPIs que encajan con lo que pides ("festivos españa", "validar NIF"), con el precio más bajo
get_apiTodo sobre una API: descripción, ejemplo, uso real y planes
request_purchaseEl 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.