Tencent BrowserSkill — AI 에이전트가 작업을 방해하지 않고 로그인된 실제 브라우저를 쓰게 하는 CLI+확장 도구

본문

Tencent가 공개한 BrowserSkill은 Cursor, Claude Code, Codex, OpenClaw, CodeBuddy, WorkBuddy, Pi, Hermes Agent, DeepSeek Harness 등 셸 명령을 호출할 수 있는 AI 에이전트라면 무엇이든 사용자가 이미 로그인해 둔 실제 브라우저를 사용할 수 있게 해 주는 도구입니다. 별도의 테스트 계정 없이 기존 로그인 상태를 재사용하면서도, 에이전트의 브라우저 작업은 사용자의 창과 분리된 별도의 'Agent Window'에서 실행되어 사용자의 작업을 방해하지 않는다는 점을 핵심 가치로 내세웁니다. 에이전트가 사용자가 이미 열어 둔 탭을 써야 한다면 명시적으로 해당 탭을 '빌려야(borrow)' 하고, 작업이 끝나면 반환해야 하며, 나머지 브라우저에는 손대지 않습니다.

CLI·데몬·확장으로 구성된 로컬 아키텍처

에이전트는 브라우저와 직접 통신하지 않습니다. 에이전트가 셸로 bsk CLI를 호출하면, 로컬 데몬이 로컬 IPC로 요청을 받아 127.0.0.1의 WebSocket으로 브라우저 확장에 전달하고, 확장이 Agent Window를 자동화하는 구조입니다. 특정 모델이나 에이전트 프레임워크, 하니스에 종속되지 않는 것이 특징이며, DeepSeek Harness는 동일한 경로를 전용 플러그인을 통해 탑니다. 리포지토리는 Cargo + pnpm 워크스페이스로, crates/bsk-cli(CLI와 데몬), crates/bsk-protocol(공유 와이어 타입과 JSON 스키마), apps/extension(브라우저 확장), packages/ui와 packages/i18n(영어·중국어 간체·한국어 지원), packages/dsh-plugin-browserskill, 그리고 에이전트 중립적인 브라우저 capability 평가를 위한 evals/browser로 구성됩니다.

권한 모델과 human-in-the-loop

CAPTCHA, 로그인, 확인 대화상자처럼 사람만 처리할 수 있는 단계에 도달하면 에이전트는 request-help로 사용자에게 개입을 요청하고, 이후 작업을 이어갑니다. 0.3.0부터 --unattended, tab borrow --no-confirm, BSK_REQUEST_HELP=off 같은 우회 수단은 더 이상 확인을 생략하지 못하며 호환성을 위해서만 받아들여집니다. 대신 확장 팝업의 두 가지 독립 설정 — 'Confirm before borrowing tabs'와 'Allow requests for human help' — 이 모든 세션에서 기준이 되며, 둘 다 기본값은 켜짐입니다. 도움 요청을 끄면 request-help는 disabled를 반환하고, 스킬은 에이전트에게 기존 로그인 상태와 허가된 입력, 사용 가능한 도구로 승인된 단계를 완수하도록 합리적인 노력을 지시합니다. 다만 전화 QR 스캔, 얼굴 인증, 수신 불가한 SMS 코드, 텍스트 전용 모델의 이미지 전용 CAPTCHA 등은 여전히 막힐 수 있다고 명시합니다. tab borrow --timeout 60s는 확인 대기 시간을 제어할 뿐 확인 필요 여부를 바꾸지 않습니다. 프로토콜 1.3은 1.0~1.2와 연결 호환성을 유지하지만, request-help는 데몬 프로토콜 1.3을 요구합니다. 구형 데몬은 브라우저에 묻지 않고 로컬에서 응답할 수 있기 때문입니다.

설치, 지원 환경, 원격 연결

macOS(Apple Silicon·Intel), Linux(x64·ARM64), Windows x64를 지원하고, 브라우저는 Chrome과 Microsoft Edge가 공식 지원되며 unpacked 확장을 지원하는 다른 Chromium 계열에서도 동작할 것으로 기대됩니다. Firefox는 계획 중입니다. 설치는 curl로 install.sh를 실행하거나 Windows에서는 PowerShell의 install.ps1로 ~/.local/bin에 CLI를 설치한 뒤, Chrome Web Store 또는 Edge Add-ons에서 확장을 설치합니다. bsk install-skill로 하니스별 스킬을 대화형 또는 비대화형으로 설치할 수 있고, 다른 하니스는 skill/SKILL.md를 수동 복사하면 됩니다. DeepSeek Harness는 npm의 @wxg-prc-cpg/browser-skill-dsh-plugin을 프로필에 추가하면 browser_* 네이티브 도구와 Web UI의 세션 뷰를 제공합니다. bsk doctor가 상태를 점검하고 힌트를 주며, bsk update --yes로 CLI를 갱신하고 확장은 스토어를 통해 업데이트합니다. 각 명령 후 백그라운드 프로세스를 회수하는 에이전트 샌드박스에서는 BSK_HOME을 공유하고 BSK_AUTO_START=0을 설정해 데몬을 호스트에 상주시키는 구성을 안내하고, 서버에서 실행 중인 에이전트를 내장 인증 서비스로 로컬 브라우저와 페어링하는 원격 연결도 지원합니다. 전체 페이지 스크린샷은 확장의 Quick actions 또는 bsk screenshot --session <id> --full-page --out page.png로 캡처할 수 있습니다.

원문: GitHub / 번역·요약: Trawling