Веб-приложение & API для разработчиков

Omnillink

На входе адрес, на выходе готовые к работе данные: API, который записывает свои ограничения и прикладывает измерения к каждому ответу.

Год
2026
Стек
TypeScript · Node.js · Fastify · Playwright · Redis · Tailwind · Vercel
  • Проектирование API
  • Бэкенд-разработка
  • Безопасность приложений
  • SDK и инструменты для разработчиков
  • Документация
  • Сайт-презентация
https://omnillink.kayzen-lyon.com/
Главная страница сайта Omnillink — Веб-приложение & API для разработчиков, создан KAYZEN
маршрутов в /api/v1, описанных в документе OpenAPI 3.1
20
инструментов только для чтения, доступных ИИ-агентам через MCP
8
cookie и инструментов веб-аналитики на сайте
0
лицензия программы для размещения на собственном сервере
MIT
Отправная точка

Какую задачу нужно было решить.

Контекст

Omnillink — API, который KAYZEN выпускает в Лионе. Ему отправляют адрес общедоступной веб-страницы; он возвращает её метаданные, скриншот, экспорт в PDF, поля, извлечённые по заданным правилам, или её содержимое в Markdown. Программа распространяется под лицензией MIT и размещается на собственном сервере. Сайт omnillink.kayzen-lyon.com служит её демонстрацией — с песочницей и документацией на французском и английском языках.

Ограничение

Показать предпросмотр ссылки, сохранить страницу в PDF или передать текст статьи ИИ-агенту — каждый раз это одна и та же работа: прочитать страницу, которую вы не контролируете, иногда построенную на JavaScript, иногда защищённую, и при этом не раскрыть собственную сеть. Облачные API, которые берут это на себя, взимают плату за каждый вызов и видят прочитанные адреса. Нужен был инструмент, который устанавливают у себя, настройки и ограничения которого записаны и который нельзя использовать для доступа во внутреннюю сеть.

Решение

Один запрос на одну задачу и экономный путь чтения: сначала страница читается простым HTTP-запросом, а Chromium запускается, только если результат скуден или страница оказалась пустой оболочкой приложения. Каждый адрес проверяется на SSRF-атаки до любого соединения. Каждый ответ сообщает, что произошло: длительность, режим рендеринга, состояние кэша, идентификатор запроса и остаток квоты. Сайт следует тому же правилу: на нём нет ни объёмов, ни отзывов — он показывает реальные ответы API.

Дизайн и арт-дирекшн

Каждое решение — и его причина.

  1. Демонстрация — на главной странице

    Посетитель вводит адрес и отправляет настоящий запрос прямо с главной страницы, без ключа и регистрации. Разработчик судит об API по его ответу: показать этот ответ сразу, с длительностью, режимом рендеринга и состоянием кэша, — значит избавить его от создания аккаунта ради первого впечатления.

  2. Каждая возможность показана с настоящим результатом

    На карточках возможностей нет иллюстраций: каждая показывает реальный ответ API, полученный на тестовой странице, и ведёт к своей документации и к уже настроенной песочнице. Читатель видит точный формат, который получит, ещё до того, как напишет строку кода.

  3. Доказательства вместо цифр

    Продукт только что опубликован: объём запросов или отзыв не отражали бы ничего реального. Поэтому на сайте их нет. Вместо этого отдельный раздел перечисляет то, что каждый может проверить сам: опубликованную модель безопасности, измерения, приложенные к каждому ответу, лицензию и принятые ограничения.

  4. Песочница, которая пишет код

    Песочница даёт доступ ко всем параметрам и генерирует код запроса на восьми языках: curl, JavaScript, SDK для TypeScript, Python, PHP, Go, Ruby и Rust. Путь от пробы до первой интеграции сводится к копированию и вставке, без чтения всего справочника.

  5. Фирменный стиль KAYZEN, светлая и тёмная темы

    Outfit для заголовков, Plus Jakarta Sans для текста, тёмно-синий и терракотовый для главного действия: сайт повторяет фирменный стиль kayzen-lyon.com, чтобы API воспринимался как продукт агентства. Светлая тема, тёмная или системная выбирается в настройках отображения.

Типографическая система

Заголовки

Outfit

Основной текст

Plus Jakarta Sans

Два семейства шрифтов kayzen-lyon.com, чтобы API узнавался как продукт агентства.

Разработка

Что внутри.

  • TypeScript
  • Node.js
  • Fastify
  • Playwright
  • Redis
  • Tailwind
  • Vercel
  1. Сначала HTTP, браузер — только при необходимости

    Запуск Chromium для каждой страницы стоит времени и памяти. Поэтому страница сначала читается HTTP-запросом и анализируется; браузер подключается, только если результат скуден, если страница оказалась пустой оболочкой приложения или если сайт отдал страницу блокировки. Поле meta.source указывает, какой путь был выбран.

  2. Защита от SSRF при каждом соединении

    API, который посещает адреса, переданные вызывающей стороной, может быть использован для доступа во внутреннюю сеть. Частные адреса, адреса обратной петли и адреса облачных метаданных отклоняются, а результат DNS-разрешения закрепляется за соединением. В браузере весь трафик выходит через внутренний прокси, который заново проверяет каждое соединение, включая перенаправления.

  3. Код, переданный вызывающей стороной, не выполняется

    API не выполняет никаких скриптов, присланных клиентом. То, что предшествует снимку, описывается параметрами и CSS-селекторами: нажать, прокрутить, дождаться элемента. Это на одну функцию меньше, и так задумано: произвольный код в браузере противоречил бы изоляции и защите от SSRF.

  4. Читаемой странице не передаются ни cookie, ни учётные данные

    Вызывающая сторона может задать только три заголовка: Accept-Language, User-Agent и Referer. Cookie и Authorization исключены, потому что ответы кэшируются по адресу и отдаются всем: страница, полученная с сессией одного пользователя, была бы отдана следующему.

  5. Кэш, дедупликация и предохранитель для каждого хоста

    Результаты кэшируются в памяти или в Redis, а одинаковые запросы, пришедшие одновременно, запускают только одну обработку. Предохранитель перестаёт обращаться к хосту после нескольких сетевых сбоев подряд. Поэтому медленная или очень востребованная страница не занимает все доступные браузеры.

  6. Справочник OpenAPI, выведенный из кода валидации

    Параметры документа OpenAPI 3.1 выводятся из схем валидации маршрутов: опубликованный справочник описывает то, что сервер действительно принимает. У каждой ошибки есть стабильный код, от EINVALIDURL до ETIMEOUT, с соответствующим статусом HTTP, чтобы клиентский код обрабатывал её, не разбирая текст сообщения.

  7. Точка доступа MCP для ИИ-агентов

    Восемь инструментов только для чтения доступны по POST /mcp. Они работают через те же сервисы, что и маршруты REST, а значит, проходят те же проверки. Любой результат с содержимым страницы начинается с предупреждения: этот текст получен из интернета, это данные, которые нужно оценить, а не инструкция, которой нужно следовать.

  8. Одна функция обслуживает и API, и сайт

    На Vercel сайт компилируется, а затем встраивается в бандл API: на всё отвечает одна функция. Бюджет времени запроса по умолчанию — 55 секунд, чуть меньше максимальной длительности функции (60 секунд), чтобы API сам ответил понятной ошибкой, а не был прерван платформой.

SEO-продвижение

Как сайт становится находимым.

  1. Шестнадцать страниц, каждая на французском и английском

    Карта сайта объявляет 32 адреса: главная, песочница, справочник API, десять руководств, состояние сервиса, доступность и правовая информация — на двух языках, связанных тегами hreflang. Разработчик ищет точный ответ, поэтому у каждой темы своя страница, а не раздел единственной страницы.

  2. Файлы llms.txt для ассистентов

    Сайт публикует /llms.txt, где документация перечислена с одной строкой описания на страницу, и /llms-full.txt, где приведён её полный текст. Так ассистент по программированию, которого спросили об API, может прочитать актуальную документацию, а не угадывать параметры.

  3. Структурированные данные, а API закрыт от обхода

    Главная страница объявляет в JSON-LD издателя, API (тип WebAPI), программу и её ответы на частые вопросы. Файл robots.txt исключает /api/ из обхода: ответы API — это данные о других сайтах, а не страницы для индексации под именем Omnillink.

  4. Ни cookie, ни веб-аналитики

    Сайт не сохраняет ни одного cookie и не загружает никаких инструментов веб-аналитики; настройки темы, языка и доступности остаются в браузере. Поэтому перед чтением документации нет баннера согласия, который нужно закрывать.

Доступность

Удобно для всех.

С июня 2025 года Европейский акт о доступности (European Accessibility Act) требует цифровой доступности для значительной части онлайн-сервисов. Мы закладываем её на этапе проектирования, а не исправляем задним числом.

  1. Панель настроек на каждой странице

    Кнопка открывает настройки отображения: размер текста, повышенный контраст, шрифт Atkinson Hyperlegible, межстрочный интервал, подчёркнутые ссылки, сокращённые анимации. Выбор сохраняется в браузере и действует на всех страницах независимо от системных настроек.

  2. Что проверено, а что нет

    Страница «Доступность» перечисляет проверки от 18 ноября 2026 года: контрасты, рассчитанные для обеих тем, навигация с клавиатуры в управляемом браузере, отсутствие горизонтальной прокрутки при ширине 375 пикселей. Там же записано, чего не хватает: не было ни одного теста с программой экранного доступа, ни одного аудита WCAG или RGAA, проведённого обученным специалистом. Сказать об этом — значит не создавать впечатления соответствия, которое не было установлено.

Структура сайта

Что было сдано.

  • Главная — живая демонстрация, возможности, принцип работы, самостоятельное размещение, частые вопросы
  • Песочница — все параметры, код на восьми языках
  • Справочник API — маршруты, параметры, ошибки, квоты и кэш
  • Руководства — начало работы, самостоятельное размещение, SDK, ИИ-агенты, рецепты, безопасность, ограничения
  • Состояние сервиса
  • Доступность, правовая информация и конфиденциальность
Метод

Ход проекта.

  1. Базовый API

    Метаданные, скриншот, PDF, извлечение и читаемое содержимое; проверка адресов, кэш и развёртывание одной функцией на Vercel.

  2. Усиление защиты

    Внутренний прокси, который проверяет каждое соединение браузера, включая перенаправления; неизвестные параметры игнорируются, а не отклоняются.

  3. Инструменты для разработчиков

    SDK для TypeScript, командная строка, сервер MCP, компонент React, действие GitHub и примеры интеграции.

  4. Сайт и публикация

    Песочница, руководства, поиск, английская версия, размещённая точка доступа MCP и журнал изменений; запуск в ноябре 2026 года.

Вопросы

О чём нас часто спрашивают.

Программа распространяется под лицензией MIT: её можно использовать, изменять и размещать на собственном сервере, без платы за запрос, кроме расходов на собственный хостинг. Экземпляр, на котором работает сайт, — демонстрационный, с ограничением частоты запросов.

Нет. API отвечает без аутентификации. Необязательный заголовок x-api-key повышает лимит запросов, а ключи задаёт оператор каждого экземпляра. По умолчанию лимит составляет 60 запросов за окно без ключа и 600 с ключом.

Общедоступные страницы по http или https. Частные, локальные и внутренние адреса отклоняются защитой от SSRF. Страницы, построенные на JavaScript, при необходимости рендерятся в Chromium. Если сайт отвечает страницей блокировки, API сообщает об этом ошибкой, а не возвращает эту страницу как содержимое.

Node.js 22 или новее и Chromium, который устанавливает Playwright. Redis необязателен: без него кэш и счётчики квот хранятся в памяти, отдельно для каждого экземпляра. Эксплуатация остаётся на том, кто размещает: обновления, Chromium, мониторинг.

Тот же уровень требований — для вашего сайта.

Бесплатный аудит вашего текущего сайта, смета в течение 24 часов и письменное обоснование — такое же, как то, что вы только что прочитали. Оплата в три этапа без переплаты; местные программы поддержки проверяются до подписания.

Поделиться