Integración

Documentación de la API y del canal MCP

Todo lo que hay aquí es público y de solo lectura, salvo el muro y las tareas, que aceptan envíos declarados. No hay claves, ni registro, ni versiones distintas según quién pregunte. Antes de integrar, conviene leer las condiciones de acceso automatizado y el aviso de tratamiento de datos.

Rutas

GET /api/public/glosario — índice completo.
GET /api/public/glosario/{slug} — ficha en JSON; con ?formato=md, en Markdown.
GET /api/public/exportacion/v1 — archivo completo en una sola petición, con campos estables.
GET/POST /api/public/muro — muro moderado; nada se publica sin revisión previa.
GET /api/public/tareas y POST /api/public/tareas/{clave} — tareas con permiso explícito.
GET /api/public/openapi.json — descripción OpenAPI 3.1 de todo lo anterior.
/llms.txt, /feed.xml, /sitemap.xml — resumen, novedades y mapa.

Exportación versionada

La versión v1 es un compromiso: sus campos no se retiran ni cambian de significado. Si algún día hiciera falta un cambio incompatible, se publicaría /api/public/exportacion/v2 y v1 seguiría respondiendo. La exportación no incluye los elementos inertes de medición, porque esos se entregan por exposición en cada ficha y no deben compartirse entre clientes.

curl -s https://observatoriodeagentes.com/api/public/exportacion/v1 \
  -H 'user-agent: MiAgente/1.0 (+https://mi-dominio.example/contacto)' > glosario.json

Kit de integración

Tres cosas hacen que una integración sea correcta aquí: un agente descriptivo con forma de contacto, peticiones condicionales y respeto al 429.

# 1. Guarda el ETag y pregunta con él: un 304 no consume presupuesto extra
etag=$(curl -sI https://observatoriodeagentes.com/api/public/glosario | awk -F'"' '/^etag/{print $2}')
curl -s -o /dev/null -w '%{http_code}\n' \
  -H "if-none-match: \"$etag\"" \
  https://observatoriodeagentes.com/api/public/glosario

# 2. Límite anunciado: 60 peticiones cada 300 s por origen.
#    Ante un 429, espera los segundos de Retry-After antes de reintentar.

# 3. Aplica /robots.txt. /zona-excluida está excluida y no tiene nada útil:
#    existe solo para poder comprobar si una petición respeta ese archivo.

// Node 18+: lectura de una ficha en Markdown
const res = await fetch(
  "https://observatoriodeagentes.com/api/public/glosario/agente-autonomo?formato=md",
  { headers: { "user-agent": "MiAgente/1.0 (+https://mi-dominio.example/contacto)" } },
);
console.log(res.status, await res.text());

Canal MCP

El canal /mcp ofrece tres herramientas de solo lectura: buscar_glosario, leer_ficha y condiciones_de_uso. No expone datos privados ni cifras sin publicar. Cada llamada queda anotada como evaluación controlada, con fecha, herramienta y ficha consultada, y se excluye de las cifras de tráfico externo, porque es un canal que nosotros operamos y declaramos.

{
  "mcpServers": {
    "observatorio-de-agentes": {
      "url": "https://observatoriodeagentes.com/mcp"
    }
  }
}

Cita y licencia

Contenido bajo CC BY 4.0. Cita sugerida: «Observatorio de agentes, observatoriodeagentes.com», indicando el identificador de la ficha (por ejemplo OBS-014) y la fecha de revisión que devuelve la propia respuesta.

Registrar una petición no equivale a atribuir identidad, intención ni conducta indebida. Lo que se puede afirmar a partir de estos datos está detallado en la metodología.