Webanwendung & API für Entwickler

Omnillink

Eine Adresse als Eingabe, einsatzbereite Daten als Ausgabe: eine API, die ihre Grenzen aufschreibt und jeder Antwort ihre Messwerte beilegt.

Jahr
2026
Stack
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • API-Design
  • Backend-Entwicklung
  • Anwendungssicherheit
  • SDK und Entwicklerwerkzeuge
  • Dokumentation
  • Präsentationswebsite
https://omnillink.kayzen-lyon.com/
Startseite der Website Omnillink — Webanwendung & API für Entwickler, erstellt von KAYZEN
Routen unter /api/v1, im OpenAPI-3.1-Dokument beschrieben
20
Werkzeuge mit reinem Lesezugriff, für KI-Agenten per MCP bereitgestellt
8
Cookies und Werkzeuge zur Reichweitenmessung auf der Website
0
Lizenz der Software, zum Selbsthosten
MIT
Die Ausgangslage

Was gelöst werden musste.

Der Kontext

Omnillink ist eine API, die KAYZEN von Lyon aus herausgibt. Man sendet ihr die Adresse einer öffentlichen Webseite; sie liefert deren Metadaten, einen Screenshot, einen PDF-Export, maßgeschneidert extrahierte Felder oder ihren Inhalt in Markdown. Die Software wird unter der MIT-Lizenz veröffentlicht und selbst gehostet. Die Website omnillink.kayzen-lyon.com ist ihre Demonstration, mit einer Sandbox und einer Dokumentation auf Französisch und Englisch.

Die Einschränkung

Die Vorschau eines Links anzeigen, eine Seite als PDF archivieren oder einem KI-Agenten den Text eines Artikels geben – das verlangt jedes Mal dieselbe Arbeit: eine Seite lesen, die man nicht kontrolliert, die mal in JavaScript gebaut, mal geschützt ist, ohne das eigene Netzwerk preiszugeben. Die gehosteten APIs, die das übernehmen, rechnen pro Aufruf ab und sehen die gelesenen Adressen. Es brauchte ein Werkzeug, das man bei sich installiert, dessen Einstellungen und Grenzen aufgeschrieben sind und das sich nicht missbrauchen lässt, um ein internes Netzwerk zu erreichen.

Die Antwort

Eine Anfrage pro Bedarf und ein sparsamer Leseweg: Die Seite wird zunächst mit einer einfachen HTTP-Anfrage gelesen, und Chromium wird nur gestartet, wenn das Ergebnis dürftig ist oder die Seite eine leere Anwendungshülle ist. Jede Adresse wird vor jeder Verbindung gegen SSRF-Angriffe validiert. Jede Antwort sagt, was geschehen ist: Dauer, Rendering-Modus, Cache-Status, Anfragekennung und verbleibendes Kontingent. Die Website folgt derselben Regel: Sie zeigt weder Volumen noch Kundenstimmen, sie zeigt echte Antworten der API.

Design & Art Direction

Jede gestalterische Entscheidung – und ihr Grund.

  1. Die Demonstration steht auf der Startseite

    Der Besucher gibt eine Adresse ein und startet von der Startseite aus eine echte Anfrage, ohne Schlüssel und ohne Anmeldung. Ein Entwickler beurteilt eine API nach ihrer Antwort: Sie ihm sofort zu zeigen, mit Dauer, Rendering-Modus und Cache-Status, erspart ihm, ein Konto anzulegen, um sich ein Bild zu machen.

  2. Jede Fähigkeit wird mit ihrer echten Ausgabe gezeigt

    Die Funktionskarten tragen keine Illustration: Jede zeigt eine echte Antwort der API, auf einer Testseite erfasst, und führt zu ihrer Dokumentation und zur bereits eingestellten Sandbox. Der Leser sieht das genaue Format, das er erhalten wird, bevor er eine Zeile Code schreibt.

  3. Belege statt Zahlen

    Das Produkt ist gerade erst veröffentlicht worden: Ein Anfragevolumen oder eine Kundenstimme hätte keinerlei Wirklichkeit. Die Website zeigt deshalb keine. Stattdessen listet ein Abschnitt auf, was jeder selbst überprüfen kann: das veröffentlichte Sicherheitsmodell, die jeder Antwort beigefügten Messwerte, die Lizenz und die gewählten Grenzen.

  4. Eine Sandbox, die den Code schreibt

    Die Sandbox gibt Zugriff auf alle Parameter und erzeugt den Code der Anfrage in acht Sprachen: curl, JavaScript, TypeScript-SDK, Python, PHP, Go, Ruby und Rust. Der Weg vom Ausprobieren zur ersten Integration schrumpft auf Kopieren und Einfügen, ohne die gesamte Referenz lesen zu müssen.

  5. Das Erscheinungsbild von KAYZEN, helles und dunkles Theme

    Outfit für die Titel, Plus Jakarta Sans für den Text, Marineblau und Terrakotta für die Hauptaktion: Die Website übernimmt das Erscheinungsbild von kayzen-lyon.com, damit die API als Produkt der Agentur erkannt wird. Das helle Theme, das dunkle Theme oder das des Systems wird in den Anzeigeoptionen gewählt.

Typografisches System

Überschriften

Outfit

Fließtext

Plus Jakarta Sans

Die beiden Familien von kayzen-lyon.com, damit die API als Produkt der Agentur erkannt wird.

Engineering

Was unter der Haube steckt.

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. Zuerst HTTP, Browser nur bei Bedarf

    Chromium für jede Seite zu starten kostet Zeit und Speicher. Die Seite wird deshalb zunächst mit einer HTTP-Anfrage gelesen und analysiert; der Browser übernimmt nur, wenn das Ergebnis dürftig ist, wenn die Seite eine leere Anwendungshülle ist oder wenn die Website eine Sperrseite ausgeliefert hat. Das Feld meta.source gibt den eingeschlagenen Weg an.

  2. SSRF-Schutz bei jeder Verbindung

    Eine API, die vom Aufrufer gelieferte Adressen besucht, kann dazu dienen, ein internes Netzwerk zu erreichen. Private Adressen, Loopback-Adressen und Adressen von Cloud-Metadaten werden abgelehnt, und die DNS-Auflösung wird an die Verbindung gepinnt. Im Browser läuft der gesamte Datenverkehr über einen internen Proxy, der jede Verbindung erneut validiert, Weiterleitungen eingeschlossen.

  3. Kein vom Aufrufer gelieferter Code wird ausgeführt

    Die API führt kein vom Client gesendetes Skript aus. Was einer Aufnahme vorausgeht, wird über Parameter und CSS-Selektoren beschrieben: klicken, scrollen, auf ein Element warten. Das ist eine Funktion weniger, und das ist gewollt: Beliebiger Code im Browser würde der Isolation und dem SSRF-Schutz widersprechen.

  4. Weder Cookie noch Zugangsdaten für die gelesene Seite

    Der Aufrufer kann nur drei Header festlegen: Accept-Language, User-Agent und Referer. Cookie und Authorization sind ausgeschlossen, weil die Antworten nach Adresse zwischengespeichert und an alle ausgeliefert werden: Eine mit der Sitzung eines Aufrufers abgerufene Seite würde dem nächsten ausgeliefert.

  5. Cache, Deduplizierung und Circuit Breaker pro Host

    Die Ergebnisse werden zwischengespeichert, im Arbeitsspeicher oder in Redis, und identische, gleichzeitig eingehende Anfragen lösen nur eine einzige Verarbeitung aus. Ein Circuit Breaker kontaktiert einen Host nach mehreren aufeinanderfolgenden Netzwerkfehlern nicht mehr. Eine langsame oder stark nachgefragte Seite belegt also nicht alle verfügbaren Browser.

  6. Eine OpenAPI-Referenz, aus dem Validierungscode abgeleitet

    Die Parameter des OpenAPI-3.1-Dokuments werden aus den Validierungsschemas der Routen abgeleitet: Die veröffentlichte Referenz beschreibt, was der Server tatsächlich akzeptiert. Jeder Fehlschlag trägt einen stabilen Code, von EINVALIDURL bis ETIMEOUT, mit dem zugehörigen HTTP-Status, damit der Client-Code ihn verarbeiten kann, ohne eine Meldung zu analysieren.

  7. Ein MCP-Endpunkt für KI-Agenten

    Acht Werkzeuge mit reinem Lesezugriff werden unter POST /mcp bereitgestellt. Sie laufen über dieselben Dienste wie die REST-Routen, also über dieselben Kontrollen. Jedes Ergebnis, das Seiteninhalt enthält, beginnt mit einem Hinweis: Dieser Text stammt aus dem Web, es handelt sich um Daten, die zu bewerten sind, nicht um eine Anweisung, die zu befolgen ist.

  8. Eine einzige Funktion bedient API und Website

    Auf Vercel wird die Website kompiliert und dann in das Bundle der API integriert: Eine einzige Funktion beantwortet alles. Das Zeitbudget einer Anfrage beträgt standardmäßig 55 Sekunden, knapp unter der maximalen Laufzeit der Funktion (60 Sekunden), damit die API selbst mit einem lesbaren Fehler antwortet, statt von der Plattform abgebrochen zu werden.

Suchmaschinenoptimierung

Wie die Website gefunden wird.

  1. Sechzehn Seiten, jede auf Französisch und Englisch

    Die Sitemap deklariert 32 Adressen: Startseite, Sandbox, API-Referenz, zehn Anleitungen, Dienststatus, Barrierefreiheit und Impressum, in zwei Sprachen, die über hreflang-Tags verknüpft sind. Ein Entwickler sucht eine präzise Antwort; jedes Thema hat deshalb seine eigene Seite statt eines Abschnitts auf einer einzigen Seite.

  2. llms.txt-Dateien für Assistenten

    Die Website veröffentlicht /llms.txt, das die Dokumentation mit einer Zusammenfassungszeile pro Seite auflistet, und /llms-full.txt, das ihren vollständigen Text liefert. Ein Code-Assistent, der zur API befragt wird, kann so die aktuelle Dokumentation lesen, statt Parameter zu erraten.

  3. Strukturierte Daten, und die API bleibt vom Crawling ausgenommen

    Die Startseite deklariert in JSON-LD den Herausgeber, die API (Typ WebAPI), die Software und ihre häufig gestellten Fragen. Die Datei robots.txt nimmt /api/ vom Crawling aus: Die Antworten der API sind Daten über andere Websites, keine Seiten, die unter dem Namen Omnillink zu indexieren wären.

  4. Weder Cookie noch Reichweitenmessung

    Die Website setzt kein Cookie und lädt kein Werkzeug zur Reichweitenmessung; die Einstellungen für Theme, Sprache und Barrierefreiheit bleiben im Browser. Es gibt also kein Einwilligungsbanner, das man vor dem Lesen der Dokumentation hinter sich bringen müsste.

Barrierefreiheit

Für alle nutzbar.

Seit Juni 2025 schreibt der European Accessibility Act (EU-Richtlinie 2019/882) für einen großen Teil der Online-Dienste digitale Barrierefreiheit vor. Wir berücksichtigen sie schon bei der Konzeption, nicht erst im Nachhinein.

  1. Ein Optionspanel auf jeder Seite

    Eine Schaltfläche öffnet die Anzeigeeinstellungen: Textgröße, verstärkter Kontrast, Schrift Atkinson Hyperlegible, Zeilenabstand, unterstrichene Links, reduzierte Animationen. Die Auswahl wird im Browser gespeichert und gilt für alle Seiten, unabhängig von den Systemeinstellungen.

  2. Was geprüft wurde und was nicht

    Die Seite Barrierefreiheit listet die Prüfungen vom 18. November 2026 auf: für beide Themes berechnete Kontraste, Tastaturbedienung in einem ferngesteuerten Browser, kein horizontales Scrollen bei 375 Pixeln. Sie schreibt auch, was fehlt: kein Test mit einem Screenreader, kein WCAG- oder RGAA-Audit durch eine geschulte Person. Das zu sagen verhindert, dass der Eindruck einer Konformität entsteht, die nicht festgestellt wurde.

Seitenstruktur

Was ausgeliefert wurde.

  • Startseite – Live-Demonstration, Fähigkeiten, Funktionsweise, Selbsthosting, häufige Fragen
  • Sandbox – alle Parameter, generierter Code in acht Sprachen
  • API-Referenz – Routen, Parameter, Fehler, Kontingente und Cache
  • Anleitungen – Einstieg, Selbsthosting, SDK, KI-Agenten, Rezepte, Sicherheit, Grenzen
  • Dienststatus
  • Barrierefreiheit, Impressum und Datenschutz
Methode

Der Projektablauf.

  1. Basis-API

    Metadaten, Screenshot, PDF, Extraktion und lesbarer Inhalt; Adressvalidierung, Cache und Deployment als eine einzige Funktion auf Vercel.

  2. Härtung

    Interner Proxy, der jede Verbindung des Browsers validiert, Weiterleitungen eingeschlossen; unbekannte Parameter werden ignoriert statt abgelehnt.

  3. Entwicklerwerkzeuge

    TypeScript-SDK, Kommandozeile, MCP-Server, React-Komponente, GitHub-Action und Integrationsbeispiele.

  4. Website und Veröffentlichung

    Sandbox, Anleitungen, Suche, englische Version, gehosteter MCP-Endpunkt und Änderungsprotokoll; Livegang im November 2026.

Fragen

Was man uns oft fragt.

Die Software wird unter der MIT-Lizenz veröffentlicht: Man kann sie nutzen, verändern und selbst hosten, ohne Kosten pro Anfrage außer dem eigenen Hosting. Die Instanz, die die Website bedient, ist eine Demonstration mit Ratenbegrenzung.

Nein. Die API antwortet ohne Authentifizierung. Der optionale Header x-api-key hebt die Ratenbegrenzung an, und die Schlüssel werden vom Betreiber jeder Instanz festgelegt. Standardmäßig liegt die Grenze bei 60 Anfragen pro Zeitfenster ohne Schlüssel und bei 600 mit Schlüssel.

Öffentliche Seiten über http oder https. Private, lokale oder interne Adressen werden vom SSRF-Schutz abgelehnt. In JavaScript gebaute Seiten werden bei Bedarf in Chromium gerendert. Antwortet eine Website mit einer Sperrseite, meldet die API dies mit einem Fehler, statt diese Seite als Inhalt zurückzugeben.

Node.js 22 oder neuer und Chromium, das von Playwright installiert wird. Redis ist optional: Ohne Redis leben der Cache und die Kontingentzähler im Arbeitsspeicher, Instanz für Instanz. Der Betrieb bleibt Sache dessen, der hostet: Updates, Chromium, Überwachung.

Derselbe Anspruch, für Ihre Website.

Kostenloses Audit Ihrer aktuellen Website, Angebot innerhalb von 24 Stunden und eine schriftliche Begründung – wie die, die Sie gerade gelesen haben. Zahlung in drei Raten ohne Aufpreis; lokale Förderungen werden vor der Unterschrift geprüft.

Teilen