Kitesurf: браузер для агентов, который живёт внутри Workers

Вопрос «а не написать ли свой браузер» всплывал в Cloudflare каждые несколько месяцев и каждый раз откладывался: сложность не окупалась. В этот раз совпали два события. Wasm в Workers дозрел, появились Dynamic Workers, Durable Objects на SQLite, RPC между воркерами, service bindings и поднятые лимиты. Одновременно вырос Browser Run: агентам нужен браузер, без него многие задачи просто не решаются.

Толчком стала obscura — headless-движок на Rust для AI-автоматизации с девизом «no Chrome, no Node.js, no dependencies». Порт на Workers делали с помощью AI-агента, и сперва получалось плохо. Заработало, когда агенту дали внятный план и определение успеха — достаточно подробное, чтобы он мог крутиться в цикле сам и задавать вопросы по ходу.

рис. из статьи

Команда понимала: путь от прототипа до браузера, полезного в продакшене, требует множества итераций, и без AI такой темп не удержать. Отсюда пять принципов, которые задали рамку всей работе.

рис. из статьи

♻️Stateless, где получается

Состояние делает отказ дорогим. Если восстанавливать нечего, восстановление после падения сводится к новому запуску и повтору запроса.

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

Клиент шлёт Page.navigate по CDP-вебсокету. Engine обходит и запекает статический граф модулей, поднимает через Worker Loader свежий изолят PageScript, тот парсит HTML, строит DOM и выполняет скрипты страницы. Дальше начинается цикл кадров: renderFrame по JSRPC, PageRenderer тянет сцену через RenderPort, растеризует её и отдаёт байты, а Engine пересылает клиенту Page.screencastFrame.

рис. из статьи

Таблица собрана из описаний компонентов в статье: Engine хранит состояние сессии, все остальные компоненты в тексте названы stateless.

Чтобы отрисовать чужую страницу, браузер тянет из интернета произвольные картинки, шрифты, CSS, JavaScript и Wasm. Это одна из самых опасных операций, которые он вообще делает. В Kitesurf её выполняет ровно один компонент — SandboxOutbound, и больше никто не касается сети напрямую; права раздают Dynamic Workers.

рис. из статьи

🚪Что делает шлюз

SandboxOutbound применяет CORS, подставляет заголовки, похожие на браузерные, фильтрует ответы и держит cookies каждой страницы в отдельной банке.

Всё, что не прошло политику, получает 403. Каждому компоненту достаётся ровно та сеть, которая ему нужна, и ничего сверх того.

Почему это работает. Ограничение живёт не в соглашении между разработчиками, а в платформе: доступ выдают Dynamic Workers, и обойти его изнутри компонента нельзя.

Engine держит вебсокет Chrome DevTools Protocol и HTTP REST API, отдаёт служебную страницу для внутреннего тестирования и хранит состояние каждой сессии. Остальные компоненты состояния не имеют. По словам авторов, из всех частей Kitesurf он самый простой, вопреки названию.

рис. из статьи

🔌Зачем именно CDP

Протокол даёт совместимость с тем, что уже используют: Puppeteer, Playwright, chrome-remote-interface и сам фронтенд Chrome DevTools. Направьте их на Kitesurf — и они заработают.

На том же протоколе построен Browser Run, поэтому переключение сводится к одному параметру в адресе эндпоинта.

🧵Почему Engine хранит состояние

Состояние сессии где-то жить обязано: клиент открывает соединение и ждёт, что страница между командами никуда не денется. Cloudflare собрала его в одном компоненте, чтобы остальные остались одноразовыми.

Каждая следующая страница или внепроцессный iframe (OOPIF) получает через Dynamic Workers собственный долгоживущий изолят: чистый globalThis и объект document. Без Dynamic Workers, по прямому признанию авторов, Kitesurf не появился бы вовсе.

рис. из статьи

🧱Из чего собран парсинг

DOM наполняется результатами разбора HTML и выполнения всех скриптов. HTML и CSS разбирают части Blitz, модульного движка рендеринга, и Stylo, быстрый CSS-парсер Firefox. Оба написаны на Rust.

Каждый найденный тег <script> и каждый файл .wasm исполняется в том же изоляте.

🌀Отдельная история с eval

Нативный eval в Workers по соображениям безопасности не поддерживается, а поднять под него отдельный изолят нельзя: у него не будет доступа к globalThis.

Решение — Boa JS, движок ECMAScript на Rust, скомпилированный под Workers. Получается рантайм поверх рантайма. Авторы прямо пишут: выглядит неоптимально, так оно и есть, но редкие eval в чужом коде это обрабатывает. Когда в Workers появится нативная поддержка, от Boa уйдут.

Компонент превращает вычисленные объекты страницы в настоящие пиксели и работает в цикле с Engine. Когда движку нужен кадр, PageRenderer забирает у PageScript объект страницы (сцену), подтягивает внутренние шрифты и картинки из Static Assets, растеризует всё в буфер и возвращает его в формате, который поймёт клиент: JPEG, PNG или PDF.

рис. из статьи

🖌️Кто рисует

Основную работу берёт на себя ещё один модуль Blitz — blitz-paint. Он опирается на Parley: та превращает символы в глифы, подбирает шрифты и разбивает текст на строки.

📞RPC вместо схем и токенов

У Workers есть встроенный RPC: можно вызывать методы других воркеров, передавать объекты и вызывать методы уже у них. Не нужны ни схемы API, ни типы, ни аутентификация — просто remoteFunction(...params).

Engine одним вызовом renderFrame() получает PNG. Рендерер не держит состояния страницы, только одноразовый кэш, поэтому движок спокойно убивает и перезапускает его на любом упавшем или зависшем вызове. Каждый запрос на отрисовку самодостаточен и допускает повтор.

Kitesurf проходит около 215 000 сабтестов WPT и прибавляет сотни каждую неделю. Области, которые важны агентам, — CSS, DOM, HTML, selection, SVG и XHR — покрыты уже прилично; даже streams, не самая нужная агенту вещь, поддержаны сносно.

рис. из статьи

рис. из статьи

Числа считаны с отчёта WPT на картинке выше. Полный список областей — в оригинальном скриншоте.

Kitesurf против Chromium на корпусе из 14 URL

Медианы пяти прогонов quick-action в Browser Run. Chromium работает из прогретого пула.

Kitesurf доступен в Browser Run бесплатно на время беты, за лимитами на аккаунт. CDP-эндпоинт Browser Run принимает его как опцию, так что ваш нынешний клиент — Puppeteer, Playwright, chrome-remote-interface или любой агент, говорящий на MCP и CDP, — уже работает. Достаточно добавить к эндпоинту параметр browser=kitesurf.

{
  "mcp": {
    "kitesurf": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "chrome-devtools-mcp@latest",
        "--wsEndpoint=wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-run/devtools/browser?browser=kitesurf",
        "--wsHeaders={\"Authorization\":\"Bearer <API_TOKEN>\"}"
      ],
      "enabled": true
    }
  }
}

Конфигурация для Opencode из раздела документации «Using with MCP clients (CDP)».

curl -X POST 'https://api.cloudflare.com/client/v4/accounts/<accountId>/browser-run/screenshot?browser=kitesurf' \
  -H 'Authorization: Bearer <apiToken>' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://example.com"
  }' \
  --output "screenshot.png"

Быстрый скриншот через Quick Actions: тот же параметр browser=kitesurf в адресе.

рис. из статьи

Kitesurf уже корректно рисует TodoMVC на vanilla, React, Vue, Angular и Preact, Wikipedia, Hacker News, блог Cloudflare и большую часть дашборда Cloudflare. Авторы описывают его как эфемерный, полностью изолированный движок без состояния, который существует ровно на время задачи и хорошо масштабируется под всплески агентной нагрузки.

Проекту двенадцать недель, первый коммит был в мае. Четыре направления работы команда называет открыто.

Клик по разделу открывает нужное место в оригинале. Cloudflare Blog не отдаёт якоря у заголовков, поэтому ссылки построены на scroll-to-text: Chrome, Edge и Safari проскроллят к тексту и подсветят его, Firefox откроет статью сверху.

How it started

читать ↗

obscura, порт на Workers с помощью AI-агента и пять принципов: тесты, Rust, обработка исключений, изоляция, отказ от состояния.

рис.

рис.

How we built it

читать ↗

Жизнь запроса целиком, затем разбор четырёх компонентов: сеть, Engine, PageScript, PageRenderer.

рис.

рис.

рис.

рис.

рис.

Kitesurf passes 215,000+ WPT tests and growing

читать ↗

Динамика прохождения WPT, покрытие по областям и таблица бенчмарков против Chromium. Здесь же — Doom из старого эксперимента Cloudflare, запущенный в Kitesurf.

рис.

рис.

Try it today in Browser Run

читать ↗

Параметр browser=kitesurf, конфиг MCP, curl для Quick Actions и playground со встроенным Chrome DevTools.

рис.

When is Kitesurf better? · What Kitesurf is not yet able to do · Where it goes

читать ↗

Совместимые сайты, честный список того, что пока не работает, и четыре направления развития.

Final notes

читать ↗

Планы на open source, ссылки на playground, changelog и Discord.

Две группы шагов: попробовать сам Kitesurf и забрать инженерные приёмы, которые работают вне этого проекта.

// попробовать Kitesurf

// забрать приёмы в свой проект