01 Para qué sirve
Muchas aplicaciones tienen datos útiles para terceros (un catálogo, un listado de centros, incidencias, reportes ciudadanos) pero no exponen una API para consultarlos. Crear un endpoint bien hecho implica decidir qué columnas se publican, paginar, limitar peticiones y no filtrar datos sensibles. Endpoint Agent Kit automatiza ese trabajo.
Toda la lógica vive en un CLI llamado endpoint, escrito en Node sin dependencias y que funciona sin conexión. Los agentes de código (Claude Code, Codex, Cursor) solo lo ejecutan, así que el resultado es el mismo lo use quien lo use.
Perfil general
Para cualquier proyecto: genera un GET paginado que devuelve { "data": [...] } con lista blanca de columnas, límite de peticiones y tope de paginación.
Perfil persona-desaparecida
Para apps de reportes de personas desaparecidas: mapea tus campos a un esquema común de 19 campos y prepara una propuesta para registrar la fuente en una red federada.
Casos de negocio
Compartir el catálogo con distribuidores, publicar un listado de puntos de venta o dar acceso de lectura a un partner sin abrirle la base de datos.
02 Instalación
Comprueba tu versión de Node con node -v. El instalador clona el repositorio, deja el comando endpoint en tu PATH y copia la skill para Claude en ~/.claude/skills/ (y para Codex en ~/.agents/skills/). Como siempre que ejecutes un script descargado de internet, puedes abrirlo antes en el navegador para revisar qué hace.
curl -fsSL https://raw.githubusercontent.com/Hainrixz/enpoint-agentkit/main/install-mac.command | bashcurl -fsSL https://raw.githubusercontent.com/Hainrixz/enpoint-agentkit/main/install-linux.sh | bashirm https://raw.githubusercontent.com/Hainrixz/enpoint-agentkit/main/install-windows.ps1 | iexendpoint help
endpoint version
# dentro de tu proyecto: deja el kit copiado en .endpoint-agentkit/ y los archivos para agentes
endpoint init03 El camino fácil: pedírselo a Claude Code
Abre Claude Code en la carpeta de tu proyecto. La skill instalada se activa cuando describes lo que quieres, y Claude ejecuta los comandos del kit pidiéndote confirmación en cada paso.
Usa Endpoint Agent Kit con el perfil general. Necesito publicar en modo solo lectura [QUÉ DATOS: el catálogo de productos, el listado de centros…] para que [QUIÉN: un distribuidor, una app móvil, un socio] pueda consultarlos.
1. Detecta el stack, la tabla correspondiente y sus columnas.
2. Propón qué columnas publicar y cuáles no, explicando por qué. Nada de datos personales ni internos (márgenes, notas, costes) salvo que yo lo confirme.
3. Genera el endpoint con lista blanca de columnas, paginación y límite de peticiones.
4. Recuérdame qué editar en endpoint.config.json y valida la configuración.
Explícame cada paso y espera mi confirmación antes de escribir archivos.Mi aplicación ya tiene un endpoint que devuelve JSON. Usa el comando sample de Endpoint Agent Kit para deducir data_path y field_mapping a partir de esta respuesta, sin modificar mi código. Después valida la configuración y dime qué falta.
[PEGA UNA RESPUESTA JSON DE EJEMPLO, SIN DATOS REALES DE PERSONAS]04 A mano desde la terminal
-
1
Detectar
endpoint detect lee el proyecto y te dice framework, capa de datos, columnas y clave primaria. No modifica nada.
-
2
Generar
endpoint scaffold crea el endpoint GET. Con --print lo muestra en pantalla en lugar de escribir el archivo; con --minimize excluye campos sensibles como documento de identidad, coordenadas o contacto.
-
3
Mapear (perfil cívico)
endpoint map empareja tus columnas con el esquema común e indica el grado de confianza de cada emparejamiento.
-
4
Validar
endpoint validate revisa la configuración o la propuesta y te dice qué falta. Con --strict, los datos personales sensibles bloquean la validación en lugar de solo avisar.
cd mi-proyecto
endpoint detect
endpoint scaffold --profile=general --minimize
# edita endpoint_url en endpoint.config.json
endpoint validate endpoint.config.json --profile=general --strictendpoint detect
endpoint scaffold --profile=persona-desaparecida --print
endpoint map --profile=persona-desaparecida
# con ayuda del mapeo, crea propuesta.json
endpoint validate propuesta.json --profile=persona-desaparecida
endpoint submit propuesta.json| Stack | Soporte |
|---|---|
| Express + Prisma, Next.js (App Router) + Prisma | Detección y plantilla |
| FastAPI + SQLAlchemy, Django | Detección y plantilla |
| Laravel (Eloquent), Rails | Detección y plantilla |
| Supabase / PostgREST | Detección y plantilla |
| Apps sin backend (SPA o móvil) | Camino de JSON estático |
| Otro stack | Pega una respuesta JSON con endpoint sample |
05 El caso de la red cívica de personas desaparecidas
El kit nació para un problema concreto: en Venezuela hay varias apps que recogen reportes de personas desaparecidas, cada una con sus datos aislados. Con el perfil persona-desaparecida, cada app expone su endpoint, mapea sus campos a un esquema común (solo title es obligatorio) y genera un propuesta.json que un administrador revisa antes de activar la fuente en la red.
La red es federada: enlaza al endpoint de cada fuente en lugar de copiar los datos a un registro inmutable. Cada organización mantiene el control y puede borrar registros, algo clave cuando una persona aparece o cuando hay menores implicados.
06 Seguridad y privacidad
- ✓Las credenciales nunca se escriben en la configuración: el CLI lo comprueba en cada escritura.
- ✓Documentos de identidad, coordenadas exactas y datos de contacto se marcan como sensibles; usa --minimize para excluirlos y --strict para que bloqueen la validación.
- ✓El kit avisa con más fuerza si detecta menores de edad o la combinación de nombre, documento y ubicación.
- ✓La URL del endpoint se valida contra direcciones locales, IP privadas y metadatos de la nube para evitar ataques SSRF.
- ✓El JSON estático es permanente una vez publicado: para datos personales usa siempre un endpoint dinámico que puedas corregir o retirar.
- ✓Lee el archivo SAFETY.md del perfil antes de publicar datos de personas y revisa la base legal de la publicación (en España y la UE, el RGPD).
Preguntas frecuentes
No para el flujo con Claude Code: describes lo que quieres y confirmas cada paso. Sí conviene que alguien con criterio técnico revise qué columnas se publican antes de desplegar el endpoint.
Sí. El CLI funciona solo desde la terminal y también con Codex o Cursor. El instalador deja la skill para Claude y Codex, y endpoint init genera las reglas para Cursor y un AGENTS.md.
Sí. Con endpoint sample y una respuesta JSON de ejemplo, el kit deduce dónde están los datos y cómo mapearlos sin tocar tu código.
No. El CLI funciona en local y sin conexión. Lo único que sale de tu equipo es lo que tú publiques al desplegar el endpoint o registrar la propuesta.
Es software libre con licencia MIT: puedes usarlo y adaptarlo en proyectos comerciales.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.