Para agentes: cómo leer Scholaris y cómo usarlo en nombre de alguien

Qué puede leer un agente en esta web y en qué formato, cómo actuar sobre la biblioteca de una persona con la API v1 o el MCP, con qué permisos y límites, y las reglas para citar sin inventar.

Revisado el 6 de octubre de 2026Esta página en Markdown

Si solo quieres entender qué es Scholaris

Todo lo público está pensado para leerse sin JavaScript y sin raspar HTML. Cada página tiene un gemelo en Markdown en la misma dirección terminada en .md, y también se sirve en Markdown si lo pides con la cabecera Accept: text/markdown. Las páginas llevan además JSON-LD de schema.org (SoftwareApplication, TechArticle, FAQPage, HowTo, DefinedTermSet).

# Cualquier página pública, en Markdown
curl -s https://scholaris-v2.jlsf2005.workers.dev/saber/formatos.md
curl -s -H "Accept: text/markdown" https://scholaris-v2.jlsf2005.workers.dev/saber/formatos

# Todo de una vez
curl -s https://scholaris-v2.jlsf2005.workers.dev/llms.txt
curl -s https://scholaris-v2.jlsf2005.workers.dev/llms-full.txt

Los ficheros para máquinas

Dirección	Qué es
/llms.txt	Índice breve con un enlace a cada página en Markdown
/llms-full.txt	El texto entero de todas las páginas públicas, en castellano y en inglés
/cualquier/pagina.md	El gemelo en Markdown de cada página pública
/api/v1/llms.txt	Cómo usar la API sin inventar citas
/api/v1/openapi.json	Especificación OpenAPI 3.1 de la API v1
/.well-known/api-catalog	Catálogo de API (RFC 9727)
/.well-known/mcp/server-card.json	Tarjeta del servidor MCP
/.well-known/oauth-protected-resource/mcp	Metadatos OAuth del recurso MCP
/.well-known/oauth-authorization-server	Metadatos del servidor de autorización OAuth
/.well-known/security.txt	Dónde avisar de un problema de seguridad
/sitemap.xml	Todas las páginas públicas, con su fecha y sus lenguas
/robots.txt	Qué se puede rastrear

Qué se puede rastrear

Las páginas públicas (la portada, esta base de conocimiento, la guía de la API y esta hoja) se pueden leer, indexar, citar y usar para responder, también para entrenar modelos: está dicho en /robots.txt, con una línea para cada rastreador conocido (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, CCBot y otros). No se rastrea la aplicación, la API ni las bibliotecas de nadie: los enlaces públicos que comparten las personas piden expresamente no ser indexados, y su contenido es suyo.

Si actúas en nombre de una persona

Necesitas que esa persona te dé acceso; no hay acceso anónimo a ninguna biblioteca. Hay dos caminos:

MCP con OAuth. Si tu cliente habla MCP, conecta con https://scholaris-v2.jlsf2005.workers.dev/mcp. Te registras solo (registro dinámico de clientes), la persona entra en Scholaris y te concede acceso de solo lectura. Herramientas: search, cite, open_page y verify_claim.
API v1 con una clave. La persona crea una clave en Ajustes → Claves de API y te la da. Con el alcance lectura puedes buscar, leer, preguntar y verificar; con escritura, además subir, borrar y citar un texto entero; con mcp, usarla en el servidor MCP. Base: https://scholaris-v2.jlsf2005.workers.dev/api/v1.

curl -sG https://scholaris-v2.jlsf2005.workers.dev/api/v1/buscar -H "Authorization: Bearer $SCHOLARIS" \
  --data-urlencode "q=la música me metía en el tiempo" -d k=5 -d formato=markdown

Todo está explicado en La API v1 y el servidor MCP y, con una sesión grabada, en la guía de la API.

Límites que tienes que respetar

Ritmo: 120 peticiones por minuto en el plan gratuito y 600 en Pro. Si recibes un 429, espera los segundos de Retry-After.
Cuotas de la persona: búsquedas al día, páginas o minutos al mes, autocitas al mes (ver Planes). Un 402 quiere decir que se han agotado: díselo, no insistas.
Ficheros: hasta 95 MB por petición en la API v1.
Reintentos: manda Idempotency-Key al subir y al citar para no duplicar nada.
Lo que tarda: subir y citar esperan por defecto; para no bloquearte, esperar=0 o Prefer: respond-async, y consulta progreso_url.

Las reglas para citar

Cita solo lo que devuelve Scholaris, y copia cita y localizador tal cual.
Si citas literalmente, copia el texto literal; si parafraseas, pon igualmente la cita.
Da el enlace: es como la persona comprueba la página o el segundo.
Si la búsqueda no encuentra nada, dilo. No rellenes el hueco de memoria ni inventes una página.
No presentes una respuesta de preguntar como si fuera tuya: sus notas al pie son la parte importante.
No escribas el trabajo de la persona haciéndolo pasar por suyo. Scholaris existe para que encuentre y piense ella.

Errores

Todas las respuestas de error tienen un codigo estable, un mensaje en castellano, un message en inglés y un enlace a la documentación. Los campos de la API están en castellano y en minúsculas.

Contacto

Para avisar de un fallo, pedir más ritmo o proponer una integración: jl@joseluissaorin.com.