Omnillink
Um endereço à entrada, dados prontos a usar à saída: uma API que escreve os seus limites e junta as suas medições a cada resposta.
- Ano
- 2026
- Stack
- TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
- Conceção de API
- Desenvolvimento back-end
- Segurança aplicacional
- SDK e ferramentas para programadores
- Documentação
- Site de apresentação

- rotas em /api/v1, descritas no documento OpenAPI 3.1
- 20
- ferramentas só de leitura expostas aos agentes de IA por MCP
- 8
- cookies e ferramentas de medição de audiência no site
- 0
- licença do software, para alojar por conta própria
- MIT
O que era preciso resolver.
O contexto
O Omnillink é uma API editada pela KAYZEN a partir de Lyon. Envia-se-lhe o endereço de uma página web pública; ela devolve os seus metadados, uma captura de ecrã, uma exportação em PDF, campos extraídos à medida ou o seu conteúdo em Markdown. O software é distribuído sob licença MIT e aloja-se por conta própria. O site omnillink.kayzen-lyon.com é a sua demonstração, com uma área de testes e documentação em francês e em inglês.
A restrição
Mostrar a pré-visualização de uma ligação, arquivar uma página em PDF ou dar o texto de um artigo a um agente de IA exige sempre o mesmo trabalho: ler uma página que não se controla, por vezes construída em JavaScript, por vezes protegida, sem expor a própria rede. As API alojadas que tratam disso faturam por chamada e veem passar os endereços lidos. Era preciso uma ferramenta que se instala em casa, cujas definições e limites estejam escritos, e que não possa ser desviada para alcançar uma rede interna.
A resposta
Um pedido por necessidade, e um caminho de leitura económico: a página é lida primeiro por um simples pedido HTTP, e o Chromium só é lançado se o resultado for pobre ou se a página for uma casca de aplicação vazia. Cada endereço é validado contra ataques SSRF antes de qualquer ligação. Cada resposta diz o que aconteceu: duração, modo de renderização, estado da cache, identificador do pedido e quota restante. O site segue a mesma regra: não apresenta volumes nem testemunhos, mostra respostas reais da API.
Cada opção, e a sua razão.
A demonstração está na página inicial
O visitante introduz um endereço e lança um pedido real a partir da página inicial, sem chave nem registo. Um programador avalia uma API pela sua resposta: mostrá-la de imediato, com a duração, o modo de renderização e o estado da cache, poupa-lhe a criação de uma conta só para formar uma opinião.
Cada capacidade é mostrada com a sua saída real
Os cartões de funcionalidades não têm ilustração: cada um apresenta uma resposta real da API, capturada numa página de teste, e conduz à respetiva documentação e à área de testes já configurada. O leitor vê o formato exato que vai receber antes de escrever uma linha de código.
Provas em vez de números
O produto acaba de ser publicado: um volume de pedidos ou um testemunho não teria qualquer realidade. O site, por isso, não os apresenta. Em vez disso, uma secção enumera o que cada um pode verificar por si: o modelo de segurança publicado, as medições juntas a cada resposta, a licença e os limites adotados.
Uma área de testes que escreve o código
A área de testes dá acesso a todos os parâmetros e gera o código do pedido em oito linguagens: curl, JavaScript, SDK TypeScript, Python, PHP, Go, Ruby e Rust. O caminho entre o ensaio e a primeira integração reduz-se a copiar e colar, sem passar pela leitura completa da referência.
A identidade gráfica da KAYZEN, tema claro e tema escuro
Outfit para os títulos, Plus Jakarta Sans para o texto, azul-marinho e terracota para a ação principal: o site retoma a identidade gráfica de kayzen-lyon.com, para que a API seja identificada como um produto da agência. O tema claro, o tema escuro ou o do sistema escolhe-se nas opções de visualização.
Sistema tipográfico
Títulos
Outfit
Texto corrido
Plus Jakarta Sans
As duas famílias de kayzen-lyon.com, para que a API seja reconhecida como um produto da agência.
O que está por baixo do capô.
- TypeScript
- Node.js
- Fastify
- Playwright
- Redis
- Tailwind
- Vercel
HTTP primeiro, navegador só se for necessário
Lançar o Chromium para cada página custa tempo e memória. A página é, por isso, lida primeiro por um pedido HTTP e analisada; o navegador só intervém se o resultado for pobre, se a página for uma casca de aplicação vazia ou se o site tiver servido uma página de bloqueio. O campo meta.source indica o caminho seguido.
Uma proteção SSRF em cada ligação
Uma API que visita endereços fornecidos por quem a chama pode servir para alcançar uma rede interna. Os endereços privados, de loopback e de metadados de cloud são recusados, e a resolução DNS fica fixada à ligação. No navegador, todo o tráfego sai por um proxy interno que revalida cada ligação, redirecionamentos incluídos.
Nenhum código fornecido por quem chama é executado
A API não executa nenhum script enviado pelo cliente. O que antecede uma captura descreve-se por parâmetros e seletores CSS: clicar, deslocar a página, esperar por um elemento. É uma função a menos, e é intencional: código arbitrário no navegador contrariaria o isolamento e a proteção SSRF.
Nem cookie nem credencial transmitidos à página lida
Quem chama só pode definir três cabeçalhos: Accept-Language, User-Agent e Referer. Cookie e Authorization estão excluídos, porque as respostas são guardadas em cache por endereço e servidas a todos: uma página obtida com a sessão de um utilizador seria servida ao seguinte.
Cache, desduplicação e disjuntor por anfitrião
Os resultados são guardados em cache, em memória ou no Redis, e pedidos idênticos recebidos ao mesmo tempo desencadeiam um único processamento. Um disjuntor deixa de contactar um anfitrião após várias falhas de rede consecutivas. Uma página lenta ou muito pedida não monopoliza, assim, os navegadores disponíveis.
Uma referência OpenAPI extraída do código de validação
Os parâmetros do documento OpenAPI 3.1 derivam dos esquemas de validação das rotas: a referência publicada descreve o que o servidor aceita realmente. Cada falha tem um código estável, de EINVALIDURL a ETIMEOUT, com o estado HTTP correspondente, para que o código cliente a trate sem analisar uma mensagem.
Um ponto de acesso MCP para os agentes de IA
Oito ferramentas só de leitura estão expostas em POST /mcp. Passam pelos mesmos serviços que as rotas REST e, portanto, pelos mesmos controlos. Qualquer resultado que contenha conteúdo de página começa por um aviso: este texto vem da web, é um dado a avaliar e não uma instrução a seguir.
Uma única função serve a API e o site
Na Vercel, o site é compilado e depois integrado no bundle da API: uma única função responde a tudo. O orçamento de tempo de um pedido é de 55 segundos por omissão, logo abaixo da duração máxima da função (60 segundos), para que a API responda ela própria com um erro legível em vez de ser interrompida pela plataforma.
Como o site se torna encontrável.
Dezasseis páginas, cada uma em francês e em inglês
O mapa do site declara 32 endereços: página inicial, área de testes, referência da API, dez guias, estado do serviço, acessibilidade e aviso legal, em duas línguas ligadas por etiquetas hreflang. Um programador procura uma resposta precisa; cada assunto tem, por isso, a sua própria página em vez de uma secção de uma página única.
Ficheiros llms.txt para os assistentes
O site publica /llms.txt, que lista a documentação com uma linha de resumo por página, e /llms-full.txt, que dá o seu texto integral. Um assistente de código questionado sobre a API pode assim ler a documentação atualizada em vez de adivinhar parâmetros.
Dados estruturados, e API mantida fora do rastreamento
A página inicial declara em JSON-LD o editor, a API (tipo WebAPI), o software e as suas perguntas frequentes. O ficheiro robots.txt afasta /api/ do rastreamento: as respostas da API são dados sobre outros sites, não páginas a indexar sob o nome Omnillink.
Nem cookies nem medição de audiência
O site não coloca nenhum cookie e não carrega nenhuma ferramenta de medição de audiência; as preferências de tema, de língua e de acessibilidade ficam no navegador. Não há, portanto, nenhuma faixa de consentimento a ultrapassar antes de ler a documentação.
Utilizável por todos.
Desde junho de 2025, o Ato Europeu da Acessibilidade exige a acessibilidade digital a uma grande parte dos serviços online. Tratamo-la na conceção, não como correção posterior.
Um painel de opções em cada página
Um botão abre as definições de visualização: tamanho do texto, contraste reforçado, tipo de letra Atkinson Hyperlegible, entrelinha, ligações sublinhadas, animações reduzidas. As escolhas ficam guardadas no navegador e valem para todas as páginas, sem depender das definições do sistema.
O que foi verificado, e o que não foi
A página Acessibilidade lista as verificações de 18 de novembro de 2026: contrastes calculados para os dois temas, percurso com o teclado num navegador automatizado, ausência de deslocamento horizontal a 375 píxeis. Escreve também o que falta: nenhum ensaio com um leitor de ecrã, nenhuma auditoria WCAG ou RGAA por uma pessoa formada. Dizê-lo evita dar a entender uma conformidade que não foi estabelecida.
O que foi entregue.
- Página inicial — demonstração em direto, capacidades, funcionamento, auto-alojamento, perguntas frequentes
- Área de testes — todos os parâmetros, código gerado em oito linguagens
- Referência da API — rotas, parâmetros, erros, quotas e cache
- Guias — primeiros passos, auto-alojamento, SDK, agentes de IA, receitas, segurança, limites
- Estado do serviço
- Acessibilidade, aviso legal e privacidade
As etapas do projeto.
API de base
Metadados, captura de ecrã, PDF, extração e conteúdo legível; validação dos endereços, cache e implementação numa única função na Vercel.
Reforço da segurança
Proxy interno que valida cada ligação do navegador, redirecionamentos incluídos; parâmetros desconhecidos ignorados em vez de recusados.
Ferramentas para programadores
SDK TypeScript, linha de comandos, servidor MCP, componente React, ação GitHub e exemplos de integração.
Site e publicação
Área de testes, guias, pesquisa, versão inglesa, ponto de acesso MCP alojado e registo de alterações; colocação online em novembro de 2026.
O que nos perguntam com frequência.
Outros projetos
Aplicação web e inteligência artificialStudio AI
Dezoito ferramentas de foto e vídeo com IA, cada uma a indicar se corre no navegador ou online: a privacidade passa a ser uma caixa a assinalar, não uma promessa.
Aplicação Web & SEOKayzen Trust
Um indicador de ligações cujo método é público: a confiança mede-se, e a diferença face à popularidade denuncia as ligações compradas.
Software livre & Aplicação de secretáriaKAYZEN Flux
Um conversor sem servidor: o ficheiro nunca sai do computador, e o código é público para o comprovar.
O mesmo nível de exigência, para o seu site.
Auditoria gratuita do seu site atual, orçamento em 24 h e um raciocínio por escrito — como o que acabou de ler. Pagamento em três prestações sem juros; apoios locais verificados antes da assinatura.