Browser Run – AI 에이전트에게 클라우드 브라우저를 제공하는 Cloudflare 인프라

배경과 필요성
주요 기능
브라우저 실행 및 제어
관찰성(Observability)
인간 개입(Human in the Loop)
크롤 및 Quick Actions
동시성 및 확장
Cloudflare Containers 마이그레이션
사용 대상
설치
관련 문서
참고 자료

Browser Run은 Cloudflare가 제공하는 AI 에이전트용 클라우드 브라우저 실행 인프라다. 기존 Browser Rendering에서 리브랜딩하면서 에이전트 워크플로우에 필수적인 기능들을 대거 추가했다. 관리형 Chrome 인스턴스를 전 세계 Cloudflare 네트워크에서 온디맨드로 실행하고, AI 에이전트가 웹을 탐색·스크래핑·자동화하는 모든 작업을 처리한다.

배경과 필요성

AI 에이전트가 웹을 활용하려면 브라우저가 필요하다. 하지만 자체 Chrome 인프라를 운영하는 것은 버전 관리, 동시성 확장, 디버깅 모두 복잡하다. Browser Run은 이 인프라를 완전히 위탁받아, 에이전트 개발자가 브라우저 제어 로직에만 집중할 수 있게 한다.

주요 기능

브라우저 실행 및 제어

Chrome DevTools Protocol(CDP) 엔드포인트: 저수준 CDP를 직접 노출해 Puppeteer·Playwright·기타 에이전트 프레임워크가 WebSocket 한 줄만 교체해 사용 가능

// Before: 로컬 Chrome
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser'
});

// After: Browser Run
const browser = await puppeteer.connect({
  browserWSEndpoint: 'wss://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/browser-rendering/devtools/browser',
  headers: { 'Authorization': 'Bearer <API_TOKEN>' }
});

MCP 클라이언트 지원: chrome-devtools-mcp 패키지를 통해 Claude Desktop, Cursor, Codex 등 AI 코딩 어시스턴트가 Browser Run을 원격 브라우저로 사용 가능
WebMCP 지원: 웹사이트가 에이전트에게 직접 도구를 선언하는 Chrome의 신규 브라우저 API. 에이전트가 UI를 분석하지 않고 사이트가 제공하는 인터페이스를 직접 호출

관찰성(Observability)

기능	설명
Live View	실행 중인 브라우저 세션을 실시간으로 모니터링. DOM·콘솔·네트워크 요청 포함
Session Recordings	세션 전체를 JSON으로 캡처해 종료 후 재생 가능 (`recording: true` 옵션)
대시보드 리디자인	스크린샷·PDF·크롤 등 모든 요청을 Runs 탭에서 통합 조회

인간 개입(Human in the Loop)

에이전트가 로그인 페이지나 CAPTCHA 같은 예외 상황에 막혔을 때 자동화를 멈추지 않고 사람이 해당 세션을 인수해 처리한 뒤 제어권을 돌려줄 수 있다.

크롤 및 Quick Actions

/crawl 엔드포인트: URL 하나로 사이트 전체 크롤. HTML·Markdown·JSON 형식 출력, robots.txt 준수
Quick Actions: 스크린샷·PDF·Markdown 추출을 단일 REST 호출로 처리

동시성 및 확장

최대 120개 브라우저 동시 실행(기존 30개에서 4배 증가). Quick Actions는 초당 10 요청.

Cloudflare Containers 마이그레이션

2026년 5월 업데이트에서 Browser Run은 기존 Browser Isolation 공유 인프라에서 Cloudflare Containers 기반 전용 인프라로 이동했다. 배경은 AI 에이전트 사용량 증가다. 짧고 급격한 headless browser 요청이 늘면서 기존 Browser Isolation의 긴 세션 중심 워크로드와 충돌했고, 전 세계 지연 시간과 가용성도 병목이 됐다.

새 구조는 지역별로 미리 데운 Durable Object 기반 브라우저 컨테이너 풀을 유지한다. 요청이 들어오면 사용자와 가까운 Durable Object-컨테이너 쌍을 할당해 지연 시간을 낮춘다. 컨테이너 상태 저장은 Workers KV에서 D1로 옮겼고, 상태 업데이트는 Queues로 배치 처리한다. 이 설계는 컨테이너마다 5초마다 상태를 보고하면서도 지역별 수십만 컨테이너까지 확장할 수 있는 여지를 만든다.

Quick Actions도 개선됐다. 이전에는 워커가 원격 브라우저와 WebSocket을 맺고 페이지 열기, 이동, 대기, 스크린샷 같은 단계를 순차 실행했다. 전용 컨테이너에서는 파라미터를 단일 HTTP 요청으로 보내고 컨테이너 내부에서 전체 흐름을 처리해 왕복 지연을 줄인다. 독립 브라우저 이미지 덕분에 Chrome 업그레이드, WebGL, WebMCP 같은 기능도 더 빠르게 적용할 수 있다.

사용 대상

유스 케이스	설명
웹 스크래핑 에이전트	JavaScript 렌더링 페이지에서 데이터 추출
UI 테스트 자동화	Playwright·Puppeteer 스크립트를 인프라 걱정 없이 실행
AI 구매/예약 에이전트	인간 개입 지원으로 인증이 필요한 단계 처리
MCP 원격 브라우저	Claude Code 등 코딩 에이전트에게 브라우저 접근 제공

설치

Workers 없이 REST API나 기존 CDP 라이브러리로 사용 가능:

# Wrangler로 세션 생성 (WebMCP 실험 풀)
npm i -g wrangler@latest
wrangler browser create --lab --keepAlive 300

참고 자료

Browser Run: now running on Cloudflare Containers — Cloudflare Blog (2026-05-14)

Like?

AI Sparkup