안녕하세요.
Codex나 Claude Code로 일하다 보면 브라우저에서 해야 하는 작업이 꼭 나옵니다. 로그인해야 보이는 관리 화면 확인, 자료 조사, 반복 입력 같은 것들입니다.
기존 방법은 대부분 두 가지였습니다. 별도 브라우저를 띄우거나(로그인을 처음부터 다시 해야 함), 쿠키를 내보내서 옮기거나. 둘 다 번거롭고, 쿠키를 옮기는 건 찜찜했습니다.
그래서 이미 쓰고 있는 Chrome과 프로필, 로그인을 그대로 두고 에이전트가 거기서 작업하게 하는 확장 프로그램과 로컬 브리지를 만들었습니다. MIT 라이선스로 공개했습니다.
어떻게 동작하나
- Chrome 확장 프로그램 + 로컬 브리지 + MCP 서버
- 에이전트는 로컬 stdio MCP로 붙습니다 (Codex, Claude Code, OpenCode 등)
- 작업은 백그라운드 창에서 돌고, 사람이 언제든 멈추고 넘겨받을 수 있습니다
- 도구는 용도별로 나뉩니다: 페이지 읽기(snapshot, read_text, query, screenshot), 이동(navigate, tabs), 조작(act, click, type, fill …), 네트워크(network, fetch, download, upload) 등
일반 로컬 사용은 무료이고, BeatBrowser 계정이나 API 키가 필요 없습니다. 에이전트는 자기 모델 접근 권한을 그대로 씁니다.
왜 클릭보다 act 하나로 묶었나
에이전트 브라우저 작업에서 시간이 가장 많이 드는 건 브라우저 동작이 아니라, 동작과 동작 사이에 에이전트가 생각하는 턴이었습니다. 그래서 예측 가능한 여러 단계를 act 한 번에 보내고, 각 단계의 효과를 확인한 뒤 마지막에 스냅샷 하나만 돌려주게 했습니다. 최종 제출 같은 단계 앞에서 멈추라고 작업 지시에 넣어 두면, 사람이 확인한 뒤 진행할 수 있습니다.
솔직하게 말씀드릴 부분
- 작업 창은 그 Chrome 프로필의 쿠키와 저장소를 공유합니다. 편한 대신, 에이전트가 내 로그인 상태로 움직인다는 뜻입니다. 민감한 계정은 별도 프로필을 쓰시길 권합니다.
- 클라우드 에이전트 연결은 미리보기입니다. 기본은 로컬 모드이고, 설치만으로 원격 접근이 열리지는 않습니다. 원격은 직접 터널과 인증을 구성해야 합니다.
- 캡차, QR 로그인, OTP는 사람이 합니다. 에이전트가 우회하지 않고 사람에게 넘깁니다.
설치
Node.js 20 이상, Chrome 116 이상이 필요합니다. 로컬 도구를 설치하고 확장 프로그램을 로드하면 됩니다. 자세한 순서는 저장소의 설치 문서에 있습니다.
질문
에이전트에게 실제 로그인 세션을 맡기는 것에 대해 어떻게 생각하시나요? 저희는 "별도 프로필 + 최종 제출 전 사람 확인"으로 선을 그었는데, 다른 방식으로 경계를 두신 분이 있으면 듣고 싶습니다.
https://github.com/BeatAPI/BeatBrowser