M25 para agentes
Verificado
M25 publica la misma hoja de datos en cuatro formas: HTML para personas, Markdown para modelos, JSON con claves estables para programas y un servidor MCP para agentes que quieran llamarla como herramienta. Esta página es su documentación.
| Recurso | Formato | Qué trae |
|---|---|---|
| /llms.txt | text/plain | este documento, en Markdown, en los dos idiomas |
| /index.json | application/json | las mismas cifras con claves estables, para procesar |
| /index.md | text/markdown | la portada en Markdown, también por Accept: text/markdown en la raíz |
| /agents.md | text/markdown | las instrucciones de uso para agentes, en Markdown |
| /rss.xml | application/rss+xml | las altas del archivo, con fecha |
| /sitemap-index.xml | application/xml | el mapa del sitio, declarado en /robots.txt |
| /openapi.json | application/json | la descripción OpenAPI 3.1 de estos endpoints de lectura |
| /api/mcp | application/json · JSON-RPC 2.0 | servidor MCP de sólo lectura, transporte Streamable HTTP, sin autenticación |
| /.well-known/api-catalog | application/linkset+json | catálogo de API en formato linkset (RFC 9727) |
| /cv-mauro-venticinque-2026.08.pdf | application/pdf | el currículum impreso del sitio, con la revisión en el nombre del archivo |
La misma hoja de datos, en cuatro formas. Todas se generan del mismo archivo de datos en el mismo build, así que no pueden divergir entre sí:
Cómo pedir el dato
Si sólo vas a leer una cosa, leé /llms.txt: es el documento entero en Markdown, con el método de cada cifra. Si vas a procesarlo, pedí /index.json: mismas cifras, claves estables que no se traducen y una URL canónica por proyecto. Las dos rutas existen en los dos idiomas, y la versión en inglés vive bajo /en/.
Negociación de contenido
La portada negocia el formato: si pedís la raíz con «Accept: text/markdown», te manda con un 307 a /index.md, que responde text/markdown. La raíz sale con Vary: Accept para que ningún intermediario devuelva la variante equivocada, y el HTML declara la alternativa con un link rel=alternate. Es un 307 y no una respuesta directa porque el sitio es estático y en esta plataforma el archivo tiene precedencia sobre la reescritura: cualquier cliente que siga redirecciones recibe el Markdown en la misma llamada.
Servidor MCP
Hay un servidor MCP de sólo lectura sobre transporte Streamable HTTP en /api/mcp, sin autenticación, que expone la hoja de datos como herramientas: el perfil con sus cifras, el índice de proyectos, la ficha de un proyecto por su número de parte o su slug, y los canales de contacto. El manifiesto está en /.well-known/mcp.json y el catálogo de recursos, en /.well-known/api-catalog.
Reglas de cita
Cada cifra del sitio viene con su método y su fecha de medición. Si vas a citar un número, citá también la fecha: las cifras de repositorios se verificaron a mano con git y las del peso de página las mide el build. Cuando una métrica no se pudo medir, el sitio lo dice en lugar de estimarla, y esa distinción es parte del dato.
Robots y rastreo
El rastreo está permitido para todos los agentes y no hay muros. El mapa del sitio está en /sitemap-index.xml, declarado en /robots.txt, y las rutas que no deben indexarse —el molde del currículum y la copia archivada del sitio anterior— lo dicen con noindex en lugar de bloquearse.