← Browser Run / browser-run

Kitesurf

Kitesurf ↗ ↗ je bezstavový, vysoce škálovatelný prohlížeč od Cloudflare, který běží zcela nad Workers a je navržen pro AI agenty. Namísto dodávání plnohodnotného desktopového enginu prohlížeče, jako je Chromium, se Kitesurf soustředí na to, na čem agentům záleží: počet tokenů, kontextová okna, škálovatelnost, výkon a náklady, přičemž se vzdává funkcí potřebných pouze pro lidi, jako jsou karty, motivy, rozšíření a pixelově přesné vykreslování.

U běžných agentních úloh, jako je pořizování snímků obrazovky a extrakce HTML, spotřebovává Kitesurf výrazně méně CPU a paměti než Chromium. Díky tomu můžete spouštět více relací a lépe škálovat pro nárazové úlohy řízené AI.

Kitesurf se hodí pro:

• AI agenti, kteří potřebují vykreslovat stránky, ale mohou akceptovat kompromisy plynoucí z nepoužívání plnohodnotného, pixelově přesného prohlížeče Chromium.
• Automatizace a aplikace, které se spoléhají na jednorázové Rychlé akce, jako je extrahování obsahu ze stránky nebo generování PDF a snímků obrazovky pro kompatibilní weby.
• Nárazové úlohy řízené AI, pro které se hodí dočasný, plně izolovaný a bezstavový engine navržený tak, aby existoval pouze po dobu trvání úlohy.

Kitesurf správně vykresluje stránky, jako je TodoMVC ↗ ↗ (vanilla, React, Vue, Angular, Preact), Wikipedii, Hacker News, Cloudflare Blog a velkou část dashboardu Cloudflare.

Kitesurf zatím není vhodnou volbou, pokud potřebujete:

• Přehrávat video nebo vykreslovat WebGL.
• Vyjednat handshake typu bot-challenge se skutečnými TLS otisky.
• Spusťte dlouhotrvající ověřenou relaci, která vyžaduje trvalý stav.

Pro tyto případy použijte výchozí prohlížeč Browser Run, který je založený na Chromiu.

Nejlepší způsob, jak zjistit, zda je konkrétní web kompatibilní s Kitesurf, je vyzkoušet ho, a to buď prostřednictvím Koncový bod CDP a Rychlé akce nebo v veřejný playground ↗ ↗.

Kitesurf můžete použít i s Rychlé akce. Přidejte browser=kitesurf na libovolný koncový bod Quick Action.

Chcete-li si například pořídit snímek obrazovky pomocí 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"

Koncový bod CDP Browser Run podporuje Kitesurf jako možnost, takže vaše stávající Puppeteer, Playwright, nebo chrome-remote-interface ↗ ↗ nastavení již funguje. Chcete-li se zapojit, přidejte browser=kitesurf k URL adrese koncového bodu:

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

Kitesurf může použít jakýkoli AI agent, který komunikuje pomocí MCP a CDP. Přidejte následující do svého klient MCP konfigurace:

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

Nahraďte <ACCOUNT_ID> s ID vašeho účtu Cloudflare a <API_TOKEN> s tokenem Browser Run API.

Chcete-li začít objevovat Kitesurf bez psaní kódu, použijte veřejný playground ↗ ↗. Zadejte libovolnou adresu URL a podívejte se, jak Kitesurf stránku vykreslí, a rovnou s ní pracujte.

Playground vkládá do uživatelského rozhraní nástroje Chrome DevTools, takže můžete zkoumat rozbalené prvky DOM, číst zprávy konzole a sledovat síťovou aktivitu, zatímco Kitesurf vykresluje stránku. Memory panel ↗ ↗ hlásí spotřebu WebAssembly u každého izolátu, včetně snímků, takže vidíte, jaké prostředky každá stránka spotřebovává.

Kitesurf se testuje vůči Web Platform Tests (WPT) ↗ ↗, sdílená sada používaná k měření shody s W3C ↗ ↗ standardů. Podle posledního běhu Kitesurf projde více než 235,000 podtestů, a pokrytí se rychle rozšiřuje.

Části prohlížeče, na kterých agentům nejvíce záleží, mají silnou podporu:

Kitesurf je navržen tak, aby byl lehký a efektivní. Pro běžné agentní úlohy spotřebuje méně CPU a paměti než Chromium, a to za cenu mírně delšího skutečného času běhu a vykreslování, které není pixelově přesné.

Tabulka níže ukazuje mediány pěti Browser Run Quick Action běží napříč korpus 14 adres URL ↗ ↗, při porovnání Chromium (warm pool) s Kitesurf:

Kitesurf vítězí ve spotřebě paměti a CPU, která ovlivňuje vaše náklady (3× až 7×), zatímco Chromium vítězí ve skutečném čase běhu, protože zahřátý just-in-time kompilátor porazí studený softwarový renderer.