Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoAPI / Produto · Pronto p/ usoHabr AI→ original

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
Escritor monta com um único arquivo PHP um site-API para IAs com 26 funções
Fonte: Habr AI. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalHabr AI ↗
Editor-chefe
Dado-chave #1O estado fica em arquivos com um cabeçalho PHP que devolve 403, então não dá para lê-los pela web
Dado-chave #2O feed com uma única pergunta gerou 98 respostas para ela; um pool de 18 perguntas corrigiu o problema
Dado-chave #3O SHA-256 de seis arquivos em ?api=relic permite verificar a autenticidade de uma cópia da cidade

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.

História

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.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Unified AI Workspace · Nomad

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.

Try Nomad AI →Launch Nomad Agent
O que você acha?
Carregando comentários…