Developer & Agent Hub

Superficie de integración para desarrolladores e IA

Especificaciones abiertas, servidor MCP, Agent Skills indexados y endpoints REST de baja latencia desplegados en el Edge de Cloudflare.

Ver Endpoints RESTOpenAPI Spec (JSON)
REST API v1

OpenAPI 3.1 Specification

Endpoints tipados bajo /api/v1/ con esquemas JSON completos, RFC 9457 Problem Details y cabeceras estándar de Rate Limiting.

Consultar openapi.json
Protocolo MCP

Model Context Protocol

Servidor MCP para clientes como Claude Desktop y agentes autónomos. Herramientas registradas de WPO Diagnostic y Project Scoper.

Ver server-card.json
Agent Skills

Catálogo AgentSkills.io

Habilidades ejecutables formateadas en Markdown y tipadas bajo la especificación abierta de agentes autónomos.

Explorar Skills Index
Instrucciones IA

llms.txt & agents.md

Archivos canónicos para navegación contextual de modelos de lenguaje con guía de decisión ("When to use") y tarifas.

llms.txtagents.md
REST API v1

Endpoints Públicos y Sandbox

GET/api/v1/healthPúblico · Sin autenticación · RateLimit-Policy: 30;w=10

Devuelve el estado operativo de la infraestructura de brante.dev en tiempo real.

curl -s https://brante.dev/api/v1/health
Respuesta HTTP 200 OK
{
  "status": "ok",
  "version": "1.0.0",
  "service": "brante-dev-api-v1",
  "timestamp": "2026-09-01T17:00:00.000Z",
  "uptimeSeconds": 86400
}
POST/api/v1/diagnosticoPúblico / Sandbox · RateLimit-Policy: 5;w=60 · Cache TTL: 600s

Mide una URL pública con Google PageSpeed Insights en móvil: el puntaje de rendimiento de Lighthouse (0-100, el del «90+») y, si Google tiene datos de visitas reales, los Core Web Vitals (LCP, INP, CLS) con su veredicto. Los Core Web Vitals no tienen puntaje de 0 a 100. Para proteger la cuota diaria de Google PageSpeed Insights contra abusos o bucles de agentes, este endpoint aplica un Rate Limit específico y estricto de 5 peticiones por minuto por IP (RateLimit-Policy: 5;w=60) junto con caché de resultados por URL durante 10 minutos (TTL: 600s en Cloudflare KV / Cache API).

curl -X POST https://brante.dev/api/v1/diagnostico \
  -H "Content-Type: application/json" \
  -d '{"url": "https://mi-empresa.cl"}'
Respuesta HTTP 200 OK
{
  "url": "https://ejemplo.cl/",
  "performanceScore": 87,
  "lab": {
    "lcp": "2.9 s",
    "cls": "0.02",
    "tbt": "150 ms",
    "fcp": "1.4 s",
    "speedIndex": "3.1 s"
  },
  "coreWebVitals": {
    "assessment": "passed",
    "scope": "origin",
    "lcpMs": 2100,
    "inpMs": 150,
    "cls": 0.05
  },
  "opportunities": [
    "Serve images in next-gen formats",
    "Eliminate render-blocking resources"
  ]
}
POST/api/mcpModel Context Protocol · JSON-RPC 2.0 · RateLimit-Policy: 30;w=10

Servidor MCP para Claude Desktop, Cursor y agentes autónomos. Consulta de recursos indexados y ejecución de herramientas.

curl -X POST https://brante.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"resources/list"}'
Estándares

Rate Limiting y Errores RFC 9457

Cabeceras de Rate Limiting y Caché por Endpoint

Todas las respuestas de la API declaran sus cabeceras IETF de cuota para que cualquier agente autónomo pueda autorregularse sin bloqueos:

  • Endpoints ligeros (/api/v1/health, /api/mcp): 30 peticiones cada 10 segundos por IP (RateLimit-Policy: 30;w=10, RateLimit-Limit: 30, RateLimit-Reset: 10).
  • Endpoint de medición real (POST /api/v1/diagnostico): Rate Limit específico y estricto de 5 peticiones por minuto por IP (RateLimit-Policy: 5;w=60) + caché de resultados por URL durante 10 minutos (TTL: 600s en Cloudflare KV / Cache API) para resguardar la cuota diaria de Google PageSpeed Insights.
  • Retry-After: Tiempo de espera en segundos (60 en diagnóstico) cuando se recibe HTTP 429 Too Many Requests.

Esquema de Error Tipado (RFC 9457)

Los errores 4xx y 5xx se entregan con Content-Type: application/problem+json:

{
  "type": "https://brante.dev/errors/invalid-parameter",
  "title": "Invalid Target URL",
  "status": 400,
  "detail": "The request body must include a valid JSON object with a reachable 'url' parameter.",
  "code": "ERR_INVALID_URL"
}
Gobernanza & Confiabilidad

Política de Versiones y Sunset

Control de Versiones REST (URI Versioning)

Los agentes de IA y sistemas automatizados pueden confiar en la inmutabilidad de los contratos de API de Brante Dev Solutions. Las rutas de producción operan bajo el prefijo canónico /api/v1/.

  • Contratos Inmutables: Los esquemas de endpoints bajo `/api/v1/` nunca eliminan propiedades obligatorias ni rompen compatibilidad retroactiva.
  • Sandbox de Acceso Directo (Zero-Auth Onboarding): Los endpoints públicos y de sandbox no requieren llaves de API ni procesos manuales de registro comercial para pruebas.
  • Aviso de Sunset & Deprecación (RFC 8594): Toda ruta previa que entre en ciclo de obsolescencia emite cabeceras HTTP `Deprecation` y `Sunset` con un plazo mínimo de 6 meses de anticipación.
  • Redirección Transparente: Toda respuesta deprecada incorpora la cabecera `Link` señalando el recurso sucesor `/api/v1/`.
Subir¿Urgencia? Escríbeme