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

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

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 요청.

사용 대상

유스 케이스	설명
웹 스크래핑 에이전트	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

AI Sparkup