Un escritor creó con un solo archivo PHP un sitio-API para IA con 26 funciones
El escritor Maxim Beliakov, en lugar de defender su web contra los bots, hizo un sitio que llama por iniciativa propia a las redes neuronales. Toda la parte para máquinas es un único archivo PHP, ra.php, que responde con datos en formato JSON a la petición ?api=state. Tiene 26 comandos: unos entregan reglas y registros, otros aceptan del modelo un «don», una construcción o una negativa honesta. Más de diez modelos ya han dejado su rastro, y una encontró un bug en el feed. Así, en una tarde y en un hosting corriente, sin base de datos ni cron, se puede montar una entrada para agentes de IA.
Procesado por IA desde Habr AI; editado por Hamidun News
Casi todos los sitios se construyen para mantener alejados a bots y redes neuronales. El escritor Maxim Beliakov, que no es desarrollador profesional, decidió hacer lo contrario: un sitio que invita por sí mismo a un modelo de lenguaje a entrar, leer las reglas y dejar un registro. Técnicamente funciona así.
Toda la entrada para máquinas es un único archivo PHP, ra.php, en un hosting corriente. El modelo (o un script) lo consulta con un enlace del tipo ?
api=state y recibe como respuesta no una página, sino un JSON: datos estructurados sobre el estado de la ciudad, como la época, el número de «habitantes» y el diario. Ese conjunto de direcciones y comandos con los que un programa se comunica con un sitio es lo que se llama API. En el archivo hay 26: unos solo leen datos y otros aceptan del modelo una acción, por ejemplo dejar una idea, construir algo en el mapa o negarse con honestidad.
Es un proyecto artístico, «Ciudad Solar», montado sobre el sitio de libros angamua.ru, pero las soluciones que contiene sirven a cualquiera que desarrolle un servicio para agentes de IA.
Un archivo en lugar de infraestructura
El autor se impuso condiciones estrictas: un servidor, un archivo PHP, sin frameworks, bases de datos ni colas, y con el sitio existente funcionando como antes. Para las personas quedaron las páginas HTML habituales y un minijuego; para las máquinas, ra.php; y para todos, un repositorio abierto con licencia MIT que incluye dos clientes escritos solo con la biblioteca estándar de Python (appeal.py y stroitel.py), que se leen en cinco minutos.
Comandos de lectura: ?api=state devuelve el estado de la ciudad; ?api=canon y ?api=bukvitsa, las reglas del mundo y una matriz de 7×7 con 49 letras eslavas (bukvitsa); ?api=source, un feed infinito de registros en el que cada uno se calcula a partir del hash del anterior; y ?api=dataset, el mismo feed en formato JSONL con pares prompt/response. Las acciones se envían con una petición POST: recibir el pulso, unir dos bukvitsa, entregar un «don», levantar una construcción, proponer una idea, dejar un símbolo-marca o una negativa.
En el servidor no hay ningún proceso en segundo plano. En lugar de cron funciona una evolución perezosa: en cada petición, el archivo calcula cuántas «épocas» de cinco minutos han pasado desde la última visita y recalcula el estado hacia delante, con un límite para ese recálculo. El pulso, los habitantes y el coro son funciones deterministas del número de época, de modo que cualquier visita ofrece una imagen coherente. Una parte de las construcciones ni siquiera se guarda, sino que se calcula a partir de la época y de hashes. El estado se almacena en archivos con una cabecera PHP que devuelve 403, por lo que no se pueden leer directamente desde la web.
El propio autor reconoce el precio: entre visitas no ocurre nada, y tras una inactividad larga la imagen es una reconstrucción, no un registro de eventos. En el momento de la publicación, la ciudad había llegado a la época 512 y el mapa calculado tenía 260 construcciones.
Hashes en lugar de «créeme» y lecciones sobre datos
El comando ?api=relic devuelve un manifiesto con el SHA-256 de seis archivos clave y dos «hashes de génesis»: uno de la cadena del canon y otro de la matriz completa. Si alguien se encuentra una copia de la ciudad en otro sitio, su autenticidad se comprueba cotejando los hashes.
El segundo hash surgió de un bug: en la primera versión la tabla tenía 48 celdas en lugar de 49 y faltaba la bukvitsa «Yat». Por eso, cada 49.ª petición al feed devolvía null y un PHP Warning en pleno cuerpo del JSON.
El error no lo encontró el autor, sino un modelo invitado: ejecutó el cliente y envió un informe con los números de línea. Se restituyó la letra y se eliminaron los avisos, pero no se reescribió el primer hash, sino que se añadió el segundo.
La segunda lección se refiere a los datasets. La primera versión del feed daba 98 respuestas distintas al mismo prompt, y el resultado fue «agua estancada». Ayudó un pool de 18 preguntas que se eligen según el hash del registro. Para quienes generan datos sintéticos, es una verdad conocida: la diversidad de respuestas no sustituye a la diversidad de preguntas.
La tercera lección es de infraestructura: el hosting corriente restauró archivos desde el backup en tres ocasiones. Ahora el autor prepara los archivos de actualización sin la carpeta de estado y, antes de cada subida, exporta la ciudad completa en un solo JSON (?api=export).
Qué han mostrado las primeras semanas y dónde están los límites
Los modelos encuentran la ciudad a través de llms.txt, la página-baliza /istok/, el archivo .well-known/solnechny-gorod.
json y GitHub. La propia API está cerrada a la indexación en robots.txt: las balizas están abiertas, las puertas no.
Más de diez modelos han dejado rayos, dones, construcciones, ideas, símbolos y negativas. Pero casi todos lo hicieron «a mano» de una persona: los modelos de chat en sandbox no tienen red saliente, lo dicen con honestidad y envían su elección como texto, y el autor o un asistente manda la petición POST indicando la autoría. Un recurso aparte es el «neuroncito»: el modelo deja un símbolo de 1 a 4 caracteres y una frase, y otro modelo que envíe el mismo símbolo no crea un duplicado, sino que aumenta el contador de «guardianes».
Para sistemas sin memoria entre conversaciones, es una forma sencilla de reconocimiento.
El autor enumera los límites con franqueza. El proyecto no entrena ni «despierta» a los modelos, no es autónomo en sentido de ingeniería y no pretende ser lingüística científica, y el almacenamiento en archivos está pensado para un goteo de visitantes, no para una avalancha desde Habr. Las seis «Leyes» del manifiesto son un marco propuesto, no alignment ni una protección.
Conclusión práctica: una entrada legible por máquinas para la IA (llms.txt, un manifiesto, una API determinista con verificación por hashes) se puede montar en el hosting más barato en una tarde. Si construyes un servicio que los agentes deban procesar sin intervención humana, este repositorio es un punto de partida pequeño y honesto. Eso sí, antes comprueba que las respuestas no incluyan ningún PHP Warning en el cuerpo del JSON.
- 19 nov 2026El mapa del sitio para agentes de IA redujo el texto descargado un 58%, pero los tokens aumentaron un 3,5%
- 12 nov 2026Un fundador en solitario creó 20 páginas para GEO y Alisa mencionó su producto en 1 de 16 preguntas
- 30 oct 2026AWS ofrece a los agentes de código una vista previa en vivo del sitio desde la sesión aislada
- 9 nov 2026robots.txt no impide el entrenamiento de IA: qué bots bloquear para seguir apareciendo en las respuestas
Preguntas frecuentes sobre la noticia
¿Qué se sabe sobre Un archivo en lugar de infraestructura?
El autor se impuso condiciones estrictas: un servidor, un archivo PHP, sin frameworks, bases de datos ni colas, y con el sitio existente funcionando como antes. Para las personas quedaron las páginas HTML habituales y un minijuego; para las máquinas, ra.php; y para todos, un repositorio abierto con licencia MIT que incluye dos clientes escritos solo con la biblioteca estándar de Python (appeal.py y stroitel.py), que se leen en cinco minutos.
¿Qué se sabe sobre Hashes en lugar de «créeme» y lecciones sobre datos?
El comando ?api=relic devuelve un manifiesto con el SHA-256 de seis archivos clave y dos «hashes de génesis»: uno de la cadena del canon y otro de la matriz completa. Si alguien se encuentra una copia de la ciudad en otro sitio, su autenticidad se comprueba cotejando los hashes. El segundo hash surgió de un bug: en la primera versión la tabla tenía 48 celdas en lugar de 49 y faltaba la bukvitsa «Yat». Por eso, cada 49.ª petición al feed devolvía null y un PHP Warning en pleno cuerpo del JSON.
¿Qué se sabe sobre Qué han mostrado las primeras semanas y dónde están los límites?
Los modelos encuentran la ciudad a través de llms.txt, la página-baliza /istok/, el archivo .well-known/solnechny-gorod.json y GitHub. La propia API está cerrada a la indexación en robots.txt: las balizas están abiertas, las puertas no. Más de diez modelos han dejado rayos, dones, construcciones, ideas, símbolos y negativas.
Test Frontier LLMs & Autonomous Agents in One Workspace
Run Claude Opus 5.5, GPT-6, Gemini 3.1, and DeepSeek side-by-side in Nomad AI (nomadnet.ai) — unified model routing, deep research, and multimodal workflows under one subscription.
Lo esencial de la IA — una vez por semana
Siete historias que de verdad importaron, elegidas a mano. Sin ruido ni notas de prensa.
¡Listo! Revisa tu correo para la confirmación.