Abre los endpoints de tu app — y súmalos a la red de personas desaparecidas

En Venezuela hay apps que recogen reportes de personas desaparecidas. El problema no es la falta de datos: es que cada app guarda los suyos por separado y no sabe “abrir su endpoint” para que otros los consuman. Esa barrera técnica frena algo urgente — poder juntar toda la información en una sola red.

Endpoint Agent Kit baja esa barrera. Por la causa, te ayuda a exponer tu app y a generar la propuesta que la registra en la red. Así cada fuente abre su endpoint y todos compartimos la misma información. Y como la inteligencia vive en un CLI sin dependencias, el resultado es idéntico lo maneje quien lo maneje.

Requisito único: Node.js 20 o superior (node -v para comprobar tu versión). El instalador deja, por igual, el skill para Claude en ~/.claude/skills/ y para Codex en ~/.agents/skills/, más el comando endpoint en tu PATH.

Para verificar que quedó bien instalado:

No necesitas saber de APIs ni tocar la terminal. Este es el camino recomendado: abres tu proyecto en Claude Code y le pides en español lo que quieres. El agente se activa solo, detecta tu stack y te va guiando paso a paso — tú solo confirmas.

1. 1

   Instala el kit

   Con el comando de tu sistema de la sección anterior. Una sola vez.

2. 2

   Abre tu proyecto en Claude Code

   También funciona en Codex o Cursor — el cerebro es el mismo CLI, así que el resultado es idéntico.

3. 3

   Pídelo en lenguaje natural

   Escribe lo que quieres lograr, en español. El kit trae prompts listos para copiar abajo.

4. 4

   Confirma cada paso

   El agente detecta tu stack, genera el endpoint, mapea tus campos, escribe la propuesta y la valida. Tú solo revisas y confirmas.

Usa Endpoint Agent Kit en este proyecto. Quiero exponer mi endpoint de personas desaparecidas y registrar mi fuente en la red.

Por favor:
1. Detecta mi stack, mi base de datos y mis columnas.
2. Genera un endpoint REST de solo lectura con el perfil persona-desaparecida (allowlist de columnas, nunca SELECT *).
3. Mapea mis columnas al esquema común y avísame si hay alguna duda.
4. Escribe propuesta.json — sin meter ninguna clave secreta, solo el tipo de auth.
5. Valídala y muéstrame el resumen para el formulario "Registrar una fuente".

Explícame cada paso en español y pídeme confirmación antes de escribir archivos.
Mi fuente se llama [NOMBRE DE TU APP] y mi correo de contacto es [TU CORREO].

Usa Endpoint Agent Kit en este proyecto con el perfil general. Quiero sacar un endpoint REST limpio y de solo lectura de mi app para poder compartirlo.

Por favor:
1. Detecta mi stack y mis columnas.
2. Genera el endpoint GET paginado de solo lectura (allowlist de columnas, rate-limit, tope de offset) y un endpoint.config.json.
3. Recuérdame editar endpoint_url en ese archivo.
4. Valida la configuración y dime qué falta.

Explícame cada paso en español y pídeme confirmación antes de escribir archivos.

Mi app ya tiene un endpoint que devuelve JSON. Usa Endpoint Agent Kit con el comando sample para deducir el data_path y el field_mapping a partir de una respuesta de mi API, con el perfil persona-desaparecida. Después ayúdame a armar y validar la propuesta sin modificar mi código.

Aquí va una respuesta de ejemplo de mi endpoint:
[PEGA AQUÍ UN JSON DE EJEMPLO DE TU API]

Todo el kit se reduce a cuatro movimientos. Con un agente los hace por ti; desde la terminal, cada uno es un comando.

Supongamos una app de reportes con este modelo (Prisma, pero da igual el stack). Vamos del proyecto a una propuesta lista para registrar.

model Reporte {
  id             Int      @id @default(autoincrement())
  nombreCompleto String
  documento      String
  ciudad         String
  estatus        String   @default("desaparecido")
  creadoEn       DateTime @default(now())
}

1. 1

   Detectar

   El kit lee tu proyecto y lista tu framework, tu base de datos, tus columnas (id, nombreCompleto, documento, ciudad, estatus, creadoEn) y la clave primaria.

   1 · Detectar tu stack y tus columnas

   endpoint detect

   Copiar comando
2. 2

   Exponer el endpoint

   Genera un endpoint listo para montar, con allowlist de columnas, rate-limit y tope de paginación. Quita --print para que lo escriba en un archivo. ¿Tu app maneja datos sensibles? --minimize excluye cédula, coordenadas y contacto del endpoint.

   2 · Exponer el endpoint (solo lectura)

   endpoint scaffold --profile=persona-desaparecida --print

   Copiar comando

   ¿Tu endpoint ya existe? Dedúcelo de una respuesta

   endpoint sample respuesta.json --profile=persona-desaparecida

   Copiar comando
3. 3

   Mapear tus campos

   Empareja cada columna con el esquema común y te marca el porcentaje de confianza: person_name ← nombreCompleto, cedula ← documento, city ← ciudad, status ← estatus, observed_at ← creadoEn. Cuando hay duda, te pregunta cuál es cuál.

   3 · Mapear tus campos al esquema común

   endpoint map --profile=persona-desaparecida

   Copiar comando
4. 4

   Escribir propuesta.json

   El agente la escribe por ti. Si lo haces a mano, declara la fuente, el endpoint, el tipo de auth, la paginación y el mapeo de campos. Así se ve:

   Así se ve propuesta.json

   {
     "source_name": "Reportes Ciudadanos VE",
     "kind": "persona_desaparecida",
     "endpoint_url": "https://mi-app.org/api/registros",
     "http_method": "GET",
     "auth_type": "api_key",
     "auth_header": "x-api-key",
     "pagination": {
       "style": "offset", "limit_param": "limit",
       "offset_param": "offset", "page_size": 100
     },
     "data_path": "data",
     "field_mapping": {
       "title": "nombreCompleto", "person_name": "nombreCompleto",
       "cedula": "documento", "city": "ciudad", "status": "estatus",
       "observed_at": "creadoEn", "source_record_id": "id"
     },
     "contact_email": "equipo@mi-app.org"
   }

   NUNCA pongas la clave secreta aquí. Declara solo el tipo de autenticación (auth_type) y el nombre del header (auth_header). El kit bloquea cualquier credencial antes de escribir el archivo.

5. 5

   Validar y registrar

   Verás un checklist, la tabla de cobertura de los 19 campos y, al final, el resumen para el formulario “Registrar una fuente”.

   5 · Validar la propuesta y registrar

   endpoint validate propuesta.json --profile=persona-desaparecida

   Copiar comando

   Cuando la validación esté en verde, el comando imprime un “resumen para el formulario” con cada valor listo para copiar y pegar en la página “Registrar una fuente”. La propuesta queda pendiente de revisión de un administrador antes de activarse.

¿Solo quieres exponer un endpoint REST limpio, sin la red cívica? Usa el perfil general. Obtienes un GET paginado, de solo lectura, con forma { “data”: [...] }, con allowlist de columnas, rate-limit y tope de offset. Sirve para sacar los endpoints de cualquier proyecto.

Tus datos se normalizan a estos 19 campos. Mapea los que apliquen; solo title es obligatorio.

Esta herramienta ayuda a publicar datos sensibles. Por eso trae candados por defecto:

Detección y/o plantilla de endpoint para los stacks más comunes. ¿El tuyo no está? Pega una respuesta JSON con endpoint sample y el kit deduce el resto.

El CLI es el cerebro; cada agente solo lo orquesta, así que el resultado es idéntico:

El kit trae su propio sistema de auditoría que verifica, en cada corrida, que sigue conforme al contrato de la plataforma. Codifica el esquema de 19 campos, los enums y fixtures dorados que deben rechazarse por su razón exacta. Si algo se desvía, falla.