Cloudflare Browser Run으로 설계하는 AI 에이전트 원격 브라우저 제어

Cloudflare Browser Run의 Chromium 격리, CDP 엔드포인트, Workers 통합과 AI 에이전트 브라우저 자동화 운영 방식을 정리한다.

2026-08-14 · 최초 발행 2026-04-24

Browser Rendering에서 에이전트 실행 환경으로 바뀐 이유

Cloudflare는 2026년 4월 Agents Week에서 기존 Browser Rendering 서비스를 Browser Run으로 바꿨다. 이전 서비스가 스크린샷, PDF 변환, 정적 크롤링에 집중했다면, Browser Run은 에이전트의 브라우저 제어와 사람의 개입, 세션 기록 및 재현까지 포괄한다.

Workers AI와 결합된 관리형 환경에서 에이전트는 실제 Chromium 브라우저를 원격으로 다룬다. 서버를 별도로 준비하지 않아도 Cloudflare 글로벌 엣지에서 브라우저 자동화를 실행할 수 있으며, Claude Desktop, Cursor, OpenCode 같은 AI 코딩 에이전트도 원격 브라우저로 활용할 수 있다.

워밍 Chromium과 세션 상태가 연결되는 구조

Browser Run은 브라우저를 할당하고, 실행 세션을 유지하며, CDP 통신을 전달하는 계층으로 구성된다.

WebSocket 연결Browser 할당격리된 Chromium 인스턴스CDP 메시지DOM 조작 / 스크린샷 / 이벤트세션 상태 관리세션 지속성AI 에이전트 / Worker 코드Browser Run API Gateway워밍 브라우저(Global Edge)Headless Chrome내부 Browser API WorkerDurable Objects

각 Cloudflare 데이터 센터에는 워밍 브라우저 인스턴스 풀이 유지된다. Worker가 브라우저를 요청하면 콜드 스타트 없이 인스턴스를 받으며, 기본 동시 실행 한도는 기존 30개에서 120개로 확대됐다.

세션이 열리면 내부 Browser API Worker가 WebSocket과 Chrome DevTools Protocol(CDP)로 브라우저 통신을 처리한다. Puppeteer와 Playwright는 CDP를 네이티브로 지원하므로, 기존 자동화 스크립트를 이 연결 구조에 붙일 수 있다.

세션 상태는 Durable Objects로 유지한다. 따라서 연속된 에이전트 작업에서 새 세션을 매번 스핀업하지 않고 컨텍스트를 보존할 수 있다. 각 작업은 격리된 Chromium 인스턴스에서 실행되므로 여러 테넌트의 에이전트가 독립된 브라우저 환경을 동시에 사용한다.

CDP를 직접 연결하는 브라우저 제어 경로

2026년 4월 10일 변경 로그에서 Browser Run은 CDP 엔드포인트 직접 노출을 알렸다. CDP는 브라우저의 도메인, 커맨드, 이벤트, 타입에 접근할 수 있는 저수준 프로토콜이다.

LLM은 CDP 명령을 수행하는 JavaScript를 만들고 라이브 브라우저 세션과 상호작용할 수 있다. 기존에 CDP를 쓰던 자동화 스크립트나 에이전트 프레임워크도 이 엔드포인트에 연결하는 방식으로 사용할 수 있다.

"Chromium 인스턴스""CDP Endpoint""Cloudflare Worker""AI LLM""Chromium 인스턴스""CDP Endpoint""Cloudflare Worker""AI LLM"브라우저 제어 명령 생성WebSocket으로 CDP 연결Page.navigate (URL)DOM 준비 이벤트Runtime.evaluate (JS 코드)실행 결과 반환구조화된 JSON 응답페이지 상태 / 스크린샷다음 액션 결정

WebMCP도 이 흐름과 맞물린다. Google Chrome 팀이 Chromium 146+에 도입한 WebMCP는 웹사이트가 AI 에이전트에 도구를 직접 노출하는 브라우저 API다. 에이전트는 페이지에서 사용할 수 있는 액션을 탐색하고 호출할 수 있어, DOM을 파싱하지 않고 구조화된 인터랙션을 수행한다.

자동화 방식은 에이전트의 제어 수준에 맞춰 고른다

Browser Run에서는 코드 중심 자동화, MCP 기반 에이전트 연동, 자연어 실행, CDP 직접 제어를 선택할 수 있다.

적합한 사용 사례제어 방식Playwright API(코드 기반)Playwright MCP(에이전트 통합)Stagehand(자연어 AI)CDP 직접(최대 제어)스크립트 자동화테스트 파이프라인Claude / CursorAI 코딩 에이전트복잡한 태스크자연어 지시저수준 제어커스텀 프레임워크

Playwright API는 Microsoft가 개발한 오픈소스 자동화 라이브러리다. Browser Run의 관리형 Chromium에 연결해 직접 작성한 코드나 에이전트가 생성한 스크립트를 실행하는 상황에 맞는다.

@cloudflare/playwright-mcp는 Cloudflare가 포크한 Playwright MCP 서버다. Browser Run과 통합돼 Claude Desktop, Cursor 같은 에이전트가 MCP 프로토콜로 브라우저를 제어한다. Workers AI 에이전트가 웹 페이지와 구조화된 데이터를 주고받는 용도로 설계됐다.

Stagehand는 자연어 지시를 브라우저 태스크로 변환하는 AI 기반 오픈소스 자동화 라이브러리다. Cloudflare Workers에서 직접 실행할 수 있으며, “로그인 후 최신 주문 목록을 가져와라” 같은 명령을 DOM 인터랙션으로 변환한다.

CDP를 직접 쓰는 방식은 가장 높은 제어 수준이 필요한 프레임워크에 적합하다. CDP 기반 자동화 코드를 수정 없이 연결할 수 있다는 점도 이 경로의 특징이다.

자동화가 멈추는 순간의 운영 흐름

에이전트는 로그인 페이지, 캡차, 복잡한 엣지 케이스처럼 스스로 처리하기 어려운 상태를 만날 수 있다. Browser Run의 Human-in-the-Loop(HITL) 흐름은 이때 사람에게 제어권을 넘긴다.

  1. 에이전트가 장애물을 감지하고 인간 개입 신호를 전송한다.
  2. 운영자는 실시간 Live View에서 해당 브라우저 세션을 확인한다.
  3. 사람이 문제를 처리한 뒤 제어권을 돌려준다.
  4. 에이전트는 유지된 세션 컨텍스트에서 작업을 다시 시작한다.

Session Recordings는 DOM 변경, 마우스·키보드 이벤트, 페이지 탐색을 구조화된 JSON으로 캡처한다. recording: true 옵션으로 활성화하며, 세션 종료 뒤 Cloudflare 대시보드의 Runs 탭 또는 API에서 조회해 rrweb-player로 재현할 수 있다. 에이전트 디버깅, 감사 로그, 리그레션 테스트에 연결되는 기록이다.

Live View는 에이전트가 보는 화면과 수행 중인 액션을 실시간으로 보여준다. 작업이 의도한 대로 진행되는지 확인하거나 문제가 난 지점을 시각적으로 진단할 때 사용한다.

자체 Playwright 운영과 관리형 브라우저의 차이

기준 Playwright (자체 운영) Cloudflare Browser Run
인프라 관리 직접 서버/컨테이너 운영 완전 관리형 (서버리스)
배포 위치 단일 서버 또는 클라우드 Cloudflare 글로벌 엣지
콜드 스타트 브라우저 스핀업 시간 발생 워밍 풀로 즉시 반환
동시 실행 서버 사양에 의존 기본 120 동시 세션
AI 에이전트 통합 Playwright MCP 별도 구성 네이티브 MCP/CDP 지원
세션 녹화 별도 솔루션 필요 내장 Session Recordings
HITL 지원 직접 구현 내장 핸드오프 흐름
비용 모델 서버 고정비 사용량 기반 과금
WebMCP 지원 미지원 Chromium 146+ 기반 지원

대규모 에이전트 오케스트레이션에서는 Browser Run이 브라우저 인프라 운영 부담을 덜어주는 선택지가 된다. 반대로 온프레미스 환경이 필요하거나 인프라를 세밀하게 제어해야 한다면 자체 Playwright 운영이 더 맞을 수 있다.

Browser Run은 헤드리스 브라우저 실행 기능에 Workers 런타임, Chromium 격리, CDP 직접 연결, Durable Objects 기반 세션 지속성을 결합한다. 여기에 HITL, 세션 녹화, Live View를 더해 자동화의 실행뿐 아니라 개입과 감사까지 다루는 브라우저 인프라를 구성한다.

Sources

CloudflareAI 에이전트브라우저 자동화PlaywrightCDP