Escritor monta com um único arquivo PHP um site-API para IAs com 26 funções
Em vez de montar defesas contra bots, o escritor Maksim Beliakov criou um site que chama as próprias IAs. Toda a parte voltada a máquinas é um único arquivo PHP, o ra.php, que responde em JSON à requisição ?api=state. Ele tem 26 comandos: alguns devolvem regras e registros, outros recebem do modelo uma «dádiva», uma construção ou uma recusa honesta. Mais de dez modelos já deixaram rastros, e um deles encontrou um bug no feed. Assim, é possível montar em uma noite uma porta de entrada para agentes de IA em hospedagem comum, sem banco de dados nem cron.
Processado por IA de Habr AI; editado por Hamidun News
Quase todos os sites são construídos para manter bots e IAs afastados. O escritor Maksim Beliakov, que não é desenvolvedor profissional, decidiu fazer o contrário: um site que convida o próprio modelo de linguagem a entrar, ler as regras e deixar um registro. Tecnicamente, funciona assim.
Toda a entrada para máquinas é um único arquivo PHP, o ra.php, em uma hospedagem comum. O modelo (ou um script) acessa um link como ?
api=state e recebe, em vez de uma página, um JSON com dados estruturados sobre o estado da cidade: a época, o número de «habitantes», o diário. Esse conjunto de endereços e comandos pelos quais um programa conversa com o site é o que se chama de API. No arquivo são 26: alguns apenas leem dados, outros recebem do modelo uma ação, como deixar uma ideia, construir algo no mapa ou recusar honestamente.
É o projeto de arte «Cidade Solar», montado sobre o site de livros angamua.ru, mas as soluções internas servem a qualquer pessoa que esteja criando um serviço para agentes de IA.
Um arquivo em vez de infraestrutura
O autor impôs condições rígidas: um servidor, um arquivo PHP, nenhum framework, banco de dados ou fila, e o site existente continua funcionando como antes. Para pessoas, ficaram as páginas HTML comuns e um minijogo; para máquinas, o ra.php; para todos, um repositório aberto sob licença MIT com dois clientes escritos apenas com a biblioteca padrão do Python (appeal.py e stroitel.py), que se leem em cinco minutos.
Comandos de leitura: ?api=state devolve o estado da cidade; ?api=canon e ?api=bukvitsa trazem as regras do mundo e uma matriz 7×7 com 49 bukvitsas eslavas (letras ornamentadas do alfabeto eslavo); ?api=source é um feed infinito de registros em que cada um é calculado a partir do hash do anterior; ?api=dataset entrega o mesmo feed em formato JSONL, com pares prompt/response. As ações são enviadas por requisição POST: receber o pulso, unir duas bukvitsas, entregar uma «dádiva», construir uma edificação, propor uma ideia, deixar um símbolo-marca ou uma recusa.
Não há processo em segundo plano no servidor. No lugar do cron, entra em cena a evolução preguiçosa: a cada requisição, o arquivo calcula quantas «épocas» de cinco minutos se passaram desde a última visita e recalcula o estado até o presente, com um limite para essa recuperação. O pulso, os habitantes e o coro são funções determinísticas do número da época, de modo que qualquer visita mostra um quadro consistente. Parte das construções nem sequer é armazenada: é calculada a partir da época e de hashes. O estado fica em arquivos com um cabeçalho PHP que devolve 403, então não é possível lê-los diretamente pela web.
O próprio autor aponta o custo: entre as visitas nada acontece, e, depois de uma longa inatividade, o quadro é uma reconstrução, não um registro de eventos. No momento da publicação, a cidade chegava à época 512, com 260 construções no mapa calculado.
Hashes em vez de «confie em mim» e lições sobre dados
O comando ?api=relic devolve um manifesto com o SHA-256 de seis arquivos-chave e dois «hashes de gênese»: um da string do cânone e outro da matriz completa. Se alguém encontrar uma cópia da cidade em outro lugar, a autenticidade se verifica comparando os hashes.
O segundo hash surgiu por causa de um bug: na primeira versão, a tabela tinha 48 células em vez de 49, e a bukvitsa «Yat» sumiu. Por isso, a cada 49ª requisição ao feed, a resposta trazia null e um PHP Warning no meio do corpo do JSON. Quem achou o erro não foi o autor, mas um modelo visitante: ele executou o cliente e enviou um relatório com os números das linhas.
A letra foi devolvida e os avisos, removidos, mas o primeiro hash não foi reescrito; o autor acrescentou um segundo.
A segunda lição diz respeito a datasets. A primeira versão do feed dava 98 respostas diferentes para o mesmo prompt, o que resultou em uma «água parada». O que ajudou foi um pool de 18 perguntas, escolhidas pelo hash do registro. Para quem gera dados sintéticos, é uma verdade conhecida: diversidade de respostas não substitui diversidade de perguntas.
A terceira lição é de infraestrutura: a hospedagem comum reverteu arquivos a partir de backup três vezes. Agora o autor monta os pacotes de atualização sem a pasta de estado e, antes de cada upload, exporta a cidade inteira em um único JSON (?api=export).
O que mostraram as primeiras semanas e onde estão os limites
Os modelos encontram a cidade por meio do llms.txt, da página-farol /istok/, do arquivo .well-known/solnechny-gorod.
json e do GitHub. A própria API está bloqueada para indexação no robots.txt: os faróis ficam abertos, o portão não.
Mais de dez modelos deixaram raios, dádivas, construções, ideias, símbolos e recusas. Mas quase todos fizeram isso «pelas mãos» de uma pessoa: os modelos de chat em sandbox não têm rede de saída, avisam isso com honestidade e enviam a escolha em texto, e o autor ou um assistente faz a requisição POST indicando a autoria. Há ainda um recurso à parte, o «neuronzinho»: o modelo deixa um símbolo de 1 a 4 caracteres e uma frase, e outro modelo que envie o mesmo símbolo não cria uma duplicata, mas aumenta o contador de «guardiões».
Para sistemas sem memória entre conversas, é uma forma simples de reconhecimento.
O autor lista as limitações abertamente. O projeto não treina nem «desperta» modelos, não é autônomo no sentido de engenharia e não pretende ser linguística científica, e o armazenamento em arquivos foi dimensionado para um fio de visitantes, não para uma enxurrada vinda do Habr. As seis «Leis» do manifesto são um quadro proposto, não alignment nem proteção.
A conclusão prática: uma entrada legível por máquina para IA — llms.txt, manifesto, API determinística com verificação por hashes — pode ser feita na hospedagem mais barata em uma noite. Se você está construindo um serviço que agentes precisam processar sem intervenção humana, este repositório é um ponto de partida pequeno e honesto. Só verifique antes se as respostas não trazem PHP Warning no corpo do JSON.
- 19 de nov. de 2026Mapa de site para agentes de IA reduziu o texto baixado em 58%, mas o uso de tokens subiu 3,5%
- 12 de nov. de 2026Fundador solo criou 20 páginas para GEO, e a Alisa citou seu produto em 1 de 16 perguntas
- 30 de out. de 2026AWS dá a agentes de código uma prévia ao vivo do site direto da sessão isolada
- 9 de nov. de 2026robots.txt não impede o treinamento de IA: quais bots bloquear para continuar nas respostas
Perguntas frequentes sobre a notícia
O que se sabe sobre Um arquivo em vez de infraestrutura?
O autor impôs condições rígidas: um servidor, um arquivo PHP, nenhum framework, banco de dados ou fila, e o site existente continua funcionando como antes. Para pessoas, ficaram as páginas HTML comuns e um minijogo; para máquinas, o ra.php; para todos, um repositório aberto sob licença MIT com dois clientes escritos apenas com a biblioteca padrão do Python (appeal.py e stroitel.py), que se leem em cinco minutos.
O que se sabe sobre Hashes em vez de «confie em mim» e lições sobre dados?
O comando ?api=relic devolve um manifesto com o SHA-256 de seis arquivos-chave e dois «hashes de gênese»: um da string do cânone e outro da matriz completa. Se alguém encontrar uma cópia da cidade em outro lugar, a autenticidade se verifica comparando os hashes. O segundo hash surgiu por causa de um bug: na primeira versão, a tabela tinha 48 células em vez de 49, e a bukvitsa «Yat» sumiu. Por isso, a cada 49ª requisição ao feed, a resposta trazia null e um PHP Warning no meio do corpo do JSON.
O que mostraram as primeiras semanas e onde estão os limites?
Os modelos encontram a cidade por meio do llms.txt, da página-farol /istok/, do arquivo .well-known/solnechny-gorod.json e do GitHub. A própria API está bloqueada para indexação no robots.txt: os faróis ficam abertos, o portão não. Mais de dez modelos deixaram raios, dádivas, construções, ideias, símbolos e recusas.
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.
O essencial da IA — uma vez por semana
Sete histórias que realmente importaram, escolhidas a dedo. Sem ruído nem releases.
Pronto! Verifique seu e-mail para a confirmação.