API e MCP

Dados para máquinas

Ainda não há API pública nem servidor MCP. Esta página diz em que pé está a coisa, o que seria servido e porque é que ainda não abriu.

O que já existe, e que não é isto

O sítio tem duas rotas /api/, e as duas são maquinaria interna do fórum: carregar uma imagem para um bitaite e registar um voto. Aceitam só POST, exigem sessão, recusam pedidos de outra origem, e mudam quando o fórum precisar sem aviso nenhum.

Não são uma API pública, não estão documentadas para uso de fora, e apontá-las a um programa era construir em cima de coisa que se move.

Porque é que valeria a pena

A parte interessante deste sítio não são as páginas: é o modelo por baixo delas. Cada dado recolhido entra como uma afirmação com fonte e data, e só depois se resolve num valor mostrável. Quando duas fontes dizem coisas diferentes sobre o mesmo número, a discordância fica registada em vez de desaparecer.

Uma API que servisse isto servia uma coisa que quase nenhuma serve: não o valor, mas o valor e de onde veio, com as fontes que o confirmam e as que o contradizem. É a diferença entre um número e um número que se pode conferir.

Hoje há em base:

• 61 088 afirmações recolhidas, cada uma com a fonte e o momento em que foi vista.
• 12 fontes ligadas, com a política de acesso de cada uma à vista.
• 796 pessoas e 40 jogos.

E o MCP?

O Model Context Protocol é a forma como um assistente de conversa vai buscar dados a um servidor de fora: em vez de adivinhar de memória quantos jogos faltam ou quanto custou um reforço, pergunta a quem sabe e responde com a fonte.

É onde este sítio encaixa melhor do que a maior parte. Um assistente que responda «o Benfica joga sábado» tem de ir buscar isso a algum lado, e um servidor que devolva também de onde tirou o dado é a diferença entre uma resposta e uma resposta verificável. Um servidor MCP daqui serviria exatamente isso: as leituras públicas do sítio, com a proveniência agarrada a cada uma.

O que falta antes de abrir

Nada disto é difícil de servir. O que é preciso resolver primeiro são três coisas, e nenhuma é código:

1. O que se pode redistribuir. Os dados vêm de fontes com licenças diferentes: a Wikidata é CC0 e passa-se adiante sem problema, mas há fontes cujos termos permitem ler e não permitem servir a terceiros. Uma API que misturasse tudo estaria a redistribuir o que não pode, e este sítio não faz isso.
2. Os limites. Este sítio corre num servidor pequeno. Uma rota aberta sem travão é uma rota que alguém deita abaixo na primeira semana.
3. A forma da proveniência. Servir o número é fácil; servir o número com as fontes, as datas e a discordância, numa forma que se aguente sem mudar de mês para mês, é a parte que se faz uma vez e não se desfaz.

Enquanto não abre

Os filtros e as vistas deste sítio são todos endereços, de propósito: ?v=campo, ?ver=agora, ?linha=defesas. Uma vista que te interesse partilha-se e volta a abrir igual, sem depender de nada guardado no browser.

Se estás a construir alguma coisa que precise destes dados, escreve. Saber quem os quer e para quê é o que decide por onde a API começa, e quem escrever fica a saber quando abrir.

Pedir as páginas em massa com um programa não é a solução: além de estar fora dos termos, é a forma mais frágil de o fazer, e a página é a única coisa aqui que muda de forma sem aviso.