TL;DR

BetterWright는 특정 생태계의 단순 Playwright wrapper가 아니라, AI 에이전트가 장기 브라우저 세션을 안전하게 조작하도록 만든 standalone browser tool이자 library-SDK, CLI tool, MCP server입니다. 압축 snapshot과 diff 처리로 관찰 token을 줄이고, `exec`는 전체 브라우징 과정을 내부에 감춘 뒤 JSON 결과와 proof screenshot을 반환합니다. credential vault, 요청별 network policy, sandbox, live-view handoff가 포함되어 로그인과 사람 승인이 필요한 자동화에 적합하지만 Node.js 22+와 별도 모델의 function calling이 필요합니다. 사이트별 자동화와 에이전트 위임을 한 패키지로 운영하려는 경우 유용하며, 대규모 scraping이나 anti-bot 우회가 목적이면 README의 사용 범위와 맞지 않습니다.

핵심 포인트

• BetterWright는 Playwright 위에서 동작하는 AI 에이전트용 persistent browser이자 CLI·JS API·MCP server를 함께 제공하는 TypeScript 도구입니다. `betterwright init`이 브라우저 설치와 에이전트 연동을 자동화하고, `run()` 또는 `exec`로 브라우저 작업을 실행합니다. Claude Code, Codex, Pi, Cursor, 자체 에이전트, MCP client와 연결할 수 있어 특정 프레임워크에 종속되지 않습니다.
• 에이전트가 매 턴 전체 HTML이나 accessibility tree를 다시 읽지 않도록 Playwright의 AI snapshot을 압축하고 diff·interactive-only 필터를 적용합니다. `exec`는 관찰·행동·검증·proof screenshot 과정을 내부에서 처리한 뒤 하나의 JSON 결과만 반환합니다. 긴 브라우저 작업을 coding agent의 단일 도구 호출로 위임할 때 주 에이전트의 context와 token 사용량을 줄이는 구조입니다.
• 브라우저 worker가 persistent context와 sandboxed globals를 유지해 로그인·탐색 상태를 세션과 재시작 이후에도 보존합니다. 모델 코드에는 파일·프로세스·임의 network-routing API를 노출하지 않고, 모든 요청을 network policy로 검사하며 cloud metadata endpoint를 차단합니다. AES-256-GCM credential vault와 다운로드 승인, live-view handoff를 함께 사용해야 로그인·MFA·결제 같은 민감한 작업을 운영할 수 있습니다.
• 내장 agent loop는 Claude, Codex, Grok, OpenRouter, Ollama, vLLM 및 OpenAI-compatible endpoint를 실제 model id로 선택하며 function calling이 필요합니다. `captcha.solve()`는 checkbox·Turnstile·slider를 처리하고 image grid는 vision handoff로 넘기며, WebMCP page tools는 typed capability를 탐색하고 호출합니다. README의 Online-Mind2Web 수치는 278/300, 92.7%이지만 BetterWright 자체 strict multimodal judge와 반복 검증을 사용한 비공식 결과입니다.

벤치마크