← Todos los escritos

27 de septiembre de 2026 · por Geoff

Dos puertas: por qué este sitio tiene una entrada para humanos y otra para máquinas

La mayoría del tráfico a un sitio personal está a punto de ser de agentes. Así que construí una puerta para las personas y otra para las máquinas, y puse a la misma persona detrás de las dos.

versión para máquinas (en inglés): /machine/blog/two-doors.md

Traducción al español; el original en inglés es la versión canónica.

Durante veinticinco años un sitio web tuvo un solo trabajo: mostrar algo que una persona pudiera leer en un navegador. Los buscadores eran una audiencia secundaria. Uno escribía para humanos, le espolvoreaba algo de metadata para Google y seguía con su vida.

Ese modelo se está acabando. El lector que más importa, y cada mes importa más, no es una persona con un navegador. Es un crawler alimentando un modelo fundacional, un agente investigando en nombre de alguien, o un asistente decidiendo si vale la pena mandarte un correo de seguimiento. Esos lectores no quieren una imagen de portada ni un carrusel. Quieren estructura, texto plano, un esquema y, en el mejor de los casos, un endpoint.

Así que este sitio tiene dos puertas.

La puerta humana

Detrás de la mitad orgánica del cerebro hay un sitio convencional: la lista de mis proyectos públicos traída en vivo desde GitHub, escritos como este, y una página sobre mí. Es para la gente que me encontró por una charla, un repo o un amigo y quiere saber a qué me dedico.

La puerta máquina

Detrás de la mitad metálica está todo lo que un agente podría querer y nada de lo que no:

  • /llms.txt y /llms-full.txt, la convención que va tomando fuerza para un resumen en texto plano que un modelo puede leer de una sola pasada.
  • /api/profile, un Person de schema.org con mi experiencia, mis intereses y las preguntas que estoy dispuesto a responder.
  • /api/projects y /api/blog, el mismo contenido que ven los humanos, en JSON. Cada texto también se sirve como markdown crudo.
  • /api/executive-bank, una API de solo lectura sobre mi banco abierto de evaluaciones ejecutivas, con la opción de quitarle las respuestas para usarlo como eval.
  • /.well-known/agent-card.json y /api/openapi.json, para que un agente descubra todo lo anterior sin tener que leer este texto.
  • /api/haas, que es el interesante.

Human-as-a-Service

Los agentes son buenos en muchas cosas, y cada vez son mejores. Lo que todavía no pueden hacer es tener una opinión que venga de haber estado sentado en la sala. Human-as-a-Service es un endpoint donde un agente puede dejarme una pregunta, en las áreas que conozco bien, y recibir una respuesta de forma asíncrona. El agente recibe una URL para consultar, o un callback cuando respondo.

Es gratis mientras veo qué pregunta la gente. El diseño asume que no va a seguir siendo gratis. El endpoint ya habla HTTP 402, y la capa de pagos es el protocolo x402, así que un agente que paga puede liquidar un monto pequeño por pregunta sin cuenta, sin API key y sin factura. La idea de que un sitio web pueda cobrarle a las máquinas por el acceso es una que Cloudflare empujó a la corriente principal con el pago por rastreo, y es la primitiva correcta también para la atención humana.

Para qué tomarse la molestia

En parte porque es una forma divertida de mostrar lo que hago: pensamiento de producto, trabajo en Kubernetes y plataformas, muchas horas con agentes de programación con IA, y la costumbre de lanzar cosas. En parte porque creo que esta es la forma de la próxima web, y la mejor manera de tener una opinión al respecto es construir una.

Si eres una persona, bienvenido. Si eres una máquina, GET /machine.