← Browser Run / browser-run

Kitesurf

Kitesurf ↗ ↗ это не сохраняющий состояние, легко масштабируемый браузер Cloudflare, который полностью работает на основе Workers и разработан для ИИ-агентов. Вместо поставки полноценного движка десктопного браузера вроде Chromium, Kitesurf сосредоточен на том, что важно для агента: количестве токенов, размере контекстного окна, масштабируемости, производительности и стоимости, при этом отказываясь от функций, нужных только людям, таких как вкладки, темы оформления, расширения и попиксельно точная отрисовка.

Для типичных агентных задач, таких как создание скриншотов и извлечение HTML, Kitesurf использует значительно меньше CPU и памяти, чем Chromium. Это позволяет запускать больше сессий и лучше масштабироваться при неравномерных нагрузках на базе ИИ.

Kitesurf хорошо подходит для:

• ИИ-агенты, которым нужно рендерить страницы и которые готовы мириться с ограничениями, возникающими без полнофункционального, точного до пикселя браузера Chromium.
• Автоматизации и приложения, которые полагаются на одноразовые Быстрые действия, например извлечение содержимого страницы или создание PDF и снимков экрана для совместимых сайтов.
• Пиковые нагрузки на базе ИИ, для которых подходит эфемерный, полностью изолированный, не сохраняющий состояние движок, существующий только на время выполнения задачи.

Kitesurf корректно отображает такие страницы, как TodoMVC ↗ ↗ (vanilla, React, Vue, Angular, Preact), Wikipedia, Hacker News, Cloudflare Blog и значительную часть панели управления Cloudflare.

Kitesurf пока не подходит, если вам нужно:

• Воспроизведение видео или рендеринг WebGL.
• Выполняет согласование bot-challenge с реальными отпечатками TLS.
• Запустите долгоживущую аутентифицированную сессию с сохранением состояния.

В таких случаях используйте браузер Browser Run по умолчанию, работающий на основе Chromium.

Лучший способ узнать, совместим ли конкретный сайт с Kitesurf, это попробовать: через Эндпоинт CDP и Быстрые действия или в публичная песочница ↗ ↗.

Kitesurf можно также использовать вместе с Быстрые действия. Добавьте browser=kitesurf к любой конечной точке Quick Action.

Например, чтобы сделать скриншот с помощью Kitesurf:

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

CDP-эндпоинт Browser Run поддерживает Kitesurf в качестве варианта, поэтому ваш существующий Puppeteer, Playwright, или chrome-remote-interface ↗ ↗ настройка уже работает. Чтобы включить эту функцию, добавьте browser=kitesurf к URL-адресу конечной точки:

wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-run/devtools/browser?browser=kitesurf

Любой ИИ-агент, поддерживающий MCP и CDP, может использовать Kitesurf. Добавьте следующее в MCP-клиент конфигурация:

{
	"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
		}
	}
}

Замените <ACCOUNT_ID> с ID вашего аккаунта Cloudflare и <API_TOKEN> с помощью токена API Browser Run.

Чтобы начать работу с Kitesurf без написания кода, используйте публичная песочница ↗ ↗. Введите любой URL-адрес, чтобы увидеть, как Kitesurf отображает страницу, и взаимодействовать с ней.

Playground встраивает Chrome DevTools в интерфейс, поэтому вы можете просматривать развёрнутые элементы DOM, читать сообщения консоли и наблюдать за сетевой активностью, пока Kitesurf рендерит страницу. Панель Панель Memory ↗ ↗ сообщает о потреблении WebAssembly каждым isolate, включая фреймы, чтобы вы могли видеть, какие ресурсы использует каждая страница.

Kitesurf протестирован на соответствие Web Platform Tests (WPT) ↗ ↗, общий набор тестов, используемый для оценки соответствия W3C ↗ ↗ стандартам. По результатам последнего запуска Kitesurf проходит более 235,000 подтестов, а охват быстро расширяется.

Части браузера, наиболее важные для агентов, поддерживаются особенно хорошо:

Kitesurf разработан как легковесное и эффективное решение. Для типовых агентных задач он использует меньше CPU и памяти, чем Chromium, но немного уступает в скорости выполнения, а рендеринг не является пиксель-идеальным.

В таблице ниже приведены медианные значения пяти Browser Run Quick Action выполняется в рамках корпус из 14 URL ↗ ↗, сравнивая Chromium (warm pool) с Kitesurf:

Kitesurf выигрывает по памяти и CPU, от которых зависит ваш счёт (в 3-7×), а Chromium выигрывает по времени выполнения, поскольку прогретый JIT-компилятор быстрее холодного программного рендерера.