byob

Bring Your Own Browser — AI 어시스턴트가 이미 열려 있는 Chrome을 사용하도록 하세요.

English · 中文

이 도구로 무엇을 할 수 있나요?

Claude(또는 Cursor / Cline)에게 웹에서 무언가를 하라고 요청하세요. byob는 사용자의 실제 Chrome에서 이를 실행합니다. 즉, 이미 Twitter, GitHub, Gmail, 업무 도구 등에 로그인되어 있는 바로 그 브라우저를 사용합니다.

사람들이 실제로 요청하는 몇 가지 예시입니다:

"내 트위터 타임라인을 읽고 상위 5개 게시물을 알려줘"

byob가 탭을 열고 스크롤하며 텍스트를 가져옵니다. 사용자의 실제 브라우저이기 때문에 트윗이 그대로 표시됩니다. 가짜 계정도 필요 없고, 쿠키를 복사/붙여넣기 할 필요도 없으며, 캡차(captcha) 문제도 없습니다.

"'mcp protocol spec'을 구글링하고, 첫 번째 결과를 클릭한 뒤 페이지를 읽어줘"

byob가 google.com으로 이동하여 검색어를 입력하고, Enter를 누르고, 결과를 기다린 뒤 첫 번째 링크를 클릭하고 읽습니다. 모두 하나의 프롬프트로 가능합니다.

"스크립트에서 curl을 사용할 수 있게 내 github 세션 쿠키를 줘"

byob가 쿠키를 제공합니다. 이제 curl https://github.com/... 명령어가 마치 로그인된 것처럼 작동합니다.

"example.com의 스크린샷을 찍어줘"

byob가 PNG 파일을 디스크에 저장하고 Claude에게 위치를 알려줍니다. (Claude의 컨텍스트에 base64를 덤프하지 않으므로 토큰을 낭비하지 않습니다.)

"내 Gmail 탭을 열고 읽지 않은 메일이 몇 개인지 알려줘"

클라우드 헤드리스 브라우저는 로그인되어 있지 않기 때문에 Gmail을 볼 수 없습니다. 하지만 byob는 사용자의 브라우저 그 자체이기 때문에 가능합니다.

Related MCP server: agent-browser-mcp

왜 WebFetch나 Puppeteer가 아닌가요?

5분 설치

git clone https://github.com/<you>/byob ~/code/byob
cd ~/code/byob && bun install

# one command does everything: makes a key, builds the extension,
# tells Chrome about it
( cd packages/bridge && bun run dev:cli install --dev )

# load the extension in Chrome:
#   chrome://extensions  →  Developer mode  →  Load unpacked
#   pick: packages/extension/.output/chrome-mv3
# then fully quit Chrome (⌘Q) and open it again

# check it works
( cd packages/bridge && bun run dev:cli doctor )
# four green ✓ means you're good

# tell Claude Code about byob
claude mcp add byob -s user -- /Users/$USER/code/byob/packages/mcp-server/node_modules/.bin/tsx /Users/$USER/code/byob/packages/mcp-server/bin/byob-mcp.ts

새로운 Claude Code 세션을 열고 *"use byob to ..."*라고 말하세요.

byob가 할 수 있는 10가지 작업

전체 입/출력 형태: shared/src/schemas.ts.

실제 작동 방식

Claude Code  ─→  byob-mcp  ─→  byob-bridge  ─→  Chrome extension  ─→  your Chrome tab

모두 사용자의 노트북에서 4단계로 이루어집니다. 어떤 데이터도 기기를 떠나지 않습니다. Chrome을 닫으면 모든 것이 종료되며, 백그라운드 프로세스가 남지 않습니다.

안전 관련 참고 사항

• 🔒 browser_eval (JS 실행)은 기본적으로 꺼져 있습니다. — Claude조차도 이 기능의 존재를 알지 못합니다. MCP를 등록할 때 BYOB_ALLOW_EVAL=1을 설정하여 켤 수 있습니다. 켜져 있을 때는 모든 호출이 기록되며 Chrome 알림이 표시됩니다.

• 🚫 일부 사이트는 기본적으로 차단됩니다. — chrome://, file://, Google/Microsoft/Apple 로그인 페이지 등입니다. 따라서 Claude가 실수로 비밀번호 관리자나 /etc/passwd를 읽을 수 없습니다.

• 🔑 사용자만의 확장 프로그램 키가 제공됩니다. — 설치 시 byob가 사용자만을 위한 키를 생성합니다. 두 사람이 byob를 실행해도 서로 다른 확장 프로그램 ID를 가지므로 충돌이 없습니다.

• 📁 파일은 비공개입니다. — 소켓은 0600, 폴더는 0700 권한을 가집니다. 컴퓨터의 다른 사용자는 이를 읽을 수 없습니다.

• 📡 byob는 외부로 데이터를 전송하지 않습니다. — 분석 도구, 자동 업데이트 핑, 충돌 보고서가 없습니다. 외부로 나가는 트래픽이 전혀 없습니다.

• ⚠️ Chrome 페이지 상단에 "byob가 이 탭을 디버깅 중입니다"라는 메시지가 표시됩니다. — 이를 숨길 방법은 없습니다. 이는 byob의 버그가 아니라 Chrome의 보안 기능입니다. Chrome의 디버거를 사용하는 모든 도구는 동일한 배너를 표시합니다.

일상적인 명령어

byob install     # set everything up (or fix it after Chrome breaks)
byob doctor      # check what's working and what's not
byob bridges     # show me the running bridges
byob logs [-f]   # tail the log
byob uninstall   # nuke the launcher and manifests

더 자세히 알고 싶으신가요?

• 설계 노트 — byob의 내부 작동 원리와 이유

• 변경 로그 — 완료된 작업 및 예정된 작업

• 기여 방법 — PR을 보내는 방법

• 테스트 체크리스트 — 각 릴리스 전에 시도해 볼 사항

여전히 해결되지 않나요? byob doctor를 실행하세요. 어떤 단계가 고장 났는지 정확히 알려줍니다.

MIT 라이선스. byob는 사용자의 브라우저에 대한 많은 접근 권한을 가집니다. 본인 소유의 기기와 계정에서만 실행하세요.