--- title: "Para agentes: cómo leer Scholaris y cómo usarlo en nombre de alguien" description: "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." url: https://scholaris.joseluissaorin.com/agentes markdown: https://scholaris.joseluissaorin.com/agentes.md lang: es alternate_en: https://scholaris.joseluissaorin.com/en/agents.md updated: 2026-10-06 author: José Luis Saorín Ferrer (https://joseluissaorin.com) --- # 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. ## 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). ```sh # Cualquier página pública, en Markdown curl -s https://scholaris.joseluissaorin.com/saber/formatos.md curl -s -H "Accept: text/markdown" https://scholaris.joseluissaorin.com/saber/formatos # Todo de una vez curl -s https://scholaris.joseluissaorin.com/llms.txt curl -s https://scholaris.joseluissaorin.com/llms-full.txt ``` ## Los ficheros para máquinas | Dirección | Qué es | | --- | --- | | [/llms.txt](https://scholaris.joseluissaorin.com/llms.txt) | Índice breve con un enlace a cada página en Markdown | | [/llms-full.txt](https://scholaris.joseluissaorin.com/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](https://scholaris.joseluissaorin.com/api/v1/llms.txt) | Cómo usar la API sin inventar citas | | [/api/v1/openapi.json](https://scholaris.joseluissaorin.com/api/v1/openapi.json) | Especificación OpenAPI 3.1 de la API v1 | | [/.well-known/api-catalog](https://scholaris.joseluissaorin.com/.well-known/api-catalog) | Catálogo de API (RFC 9727) | | [/.well-known/mcp/server-card.json](https://scholaris.joseluissaorin.com/.well-known/mcp/server-card.json) | Tarjeta del servidor MCP | | [/.well-known/oauth-protected-resource/mcp](https://scholaris.joseluissaorin.com/.well-known/oauth-protected-resource/mcp) | Metadatos OAuth del recurso MCP | | [/.well-known/oauth-authorization-server](https://scholaris.joseluissaorin.com/.well-known/oauth-authorization-server) | Metadatos del servidor de autorización OAuth | | [/.well-known/security.txt](https://scholaris.joseluissaorin.com/.well-known/security.txt) | Dónde avisar de un problema de seguridad | | [/sitemap.xml](https://scholaris.joseluissaorin.com/sitemap.xml) | Todas las páginas públicas, con su fecha y sus lenguas | | [/robots.txt](https://scholaris.joseluissaorin.com/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](https://scholaris.joseluissaorin.com/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: 1. **MCP con OAuth.** Si tu cliente habla MCP, conecta con `https://scholaris.joseluissaorin.com/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`. 2. **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.joseluissaorin.com/api/v1`. ```sh curl -sG https://scholaris.joseluissaorin.com/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](https://scholaris.joseluissaorin.com/saber/api-y-mcp.md) y, con una sesión grabada, en la [guía de la API](https://scholaris.joseluissaorin.com/api.md). ## 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](https://scholaris.joseluissaorin.com/saber/planes.md)). 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 1. Cita solo lo que devuelve Scholaris, y copia `cita` y `localizador` tal cual. 2. Si citas literalmente, copia el `texto` literal; si parafraseas, pon igualmente la cita. 3. Da el `enlace`: es como la persona comprueba la página o el segundo. 4. Si la búsqueda no encuentra nada, dilo. No rellenes el hueco de memoria ni inventes una página. 5. No presentes una respuesta de `preguntar` como si fuera tuya: sus notas al pie son la parte importante. 6. 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](mailto:jl@joseluissaorin.com).