AI 에이전트, 이미 로그인한 브라우저를 그대로 쓰는 법

브라우저를 조작하는 AI 에이전트가 부쩍 흔해졌어요. 코드 하나로 양식을 채우고, 주문을 넣고, 페이지 요약을 해오는 흐름이 이제는 드물지 않죠.

그런데 애매한 지점이 항상 남았어요. 에이전트가 띄우는 무인 브라우저는 내가 쓰던 로그인 세션을 몰라서, 인증이 필요한 서비스는 아예 다른 프로필에서 처음부터 시작해야 했습니다.

텐센트가 GitHub에 공개한 오픈소스 BrowserSkill은 바로 그 지점을 겨냥해요. AI 에이전트가 이미 로그인된 내 브라우저를, 내 작업을 방해하지 않으면서 빌려 쓰도록 만드는 도구입니다. 공개 후 5.5천 개가 넘는 스타를 받으며 브라우저 에이전트 트렌드에서 주목받고 있는데, 에이전트 생태계 전반을 붙잡으려는 드문 설계라 분석할 만해요.

참고 — 이 글에서 다루는 프로젝트
이름: BrowserSkill (Tencent)
라이선스: MIT
레포: github.com/Tencent/BrowserSkill
주요 구성: bsk CLI/데몬 + 브라우저 확장 프로그램 + 에이전트 스킬
핵심 약속: '로그인된 브라우저를 빌려 쓰되, 내 작업과 탭은 건드리지 않는다'

이미 로그인된 브라우저를 빌려 쓰는 설계

BrowserSkill의 차이는 관점에 있어요. 기존 도구들이 새 브라우저를 만들어 에이전트에게 넘겨주는 데 집중했다면, BrowserSkill은 사용자가 이미 쓰고 있는 브라우저에서 필요한 탭만 잠시 빌려 쓰는 쪽입니다.

에이전트가 여러 사이트에 로그인하거나 별도 테스트 계정을 준비할 필요가 없어요. 내가 평소에 해둔 로그인 상태를 그대로 활용하니까요. 필요하면 그 탭을 명시적으로 빌려달라고 요청하고, 일이 끝나면 되돌려줍니다. 나머지 브라우저 창은 건드리지 않는 것을 원칙으로 삼았어요.

bsk CLI부터 확장 프로그램까지 세 덩어리 구조

이 도구는 로컬에서 두 개의 런타임으로 움직여요. 하나는 bsk라는 CLI와 데몬, 다른 하나는 크롬/엣지용 브라우저 확장 프로그램이에요.

에이전트는 브라우저에 직접 말을 걸지 않고 항상 셸에서 bsk ...를 호출합니다. 그 요청이 로컬 데몬으로 전달되고, 데몬이 확장 프로그램과 WebSocket으로 연결되어 에이전트 전용 에이전트 창(Agent Window)을 조작하는 흐름이에요.

레포는 Cargo와 pnpm 워크스페이스로 묶여 있어요. CLI·데몬은 Rust 계열(crates/bsk-cli, crates/bsk-protocol), 브라우저 확장은 TypeScript(apps/extension)로 작성됐고, 전체 언어 비중은 TypeScript 약 66%, Rust 약 31%예요. DeepSeek Harness를 쓰는 팀을 위한 전용 npm 플러그인도 함께 배포해, 해당 환경에서는 별도의 browser_* 도구와 웹 UI의 세션 뷰로 바로 쓸 수 있게 했어요.

핵심 장점 네 가지

첫 번째가 로그인 상태 재사용이에요. 별도 테스트 계정 없이 실서비스에 대한 작업이 가능합니다.

두 번째는 비간섭인데, 에이전트 작업이 별도의 에이전트 창에서 돌아서 내가 쓰는 브라우저를 막거나 탭을 가로채지 않아요.

세 번째는 에이전트 무관성이에요. 셸을 호출할 수 있는 에이전트라면 bsk CLI 하나로 족하고, 특정 모델이나 에이전트 프레임워크에 종속되지 않습니다.

네 번째가 휴먼 인 더 루프입니다. 캡차, 로그인, 확인 다이얼로그 같은 사람만 처리할 수 있는 단계를 만나면 에이전트가 나에게 직접 도움을 요청하고, 처리가 끝난 뒤 이어서 진행해요.

보안 설정은 기본 켜짐, 무인 실행은 어렵게

확장 프로그램에는 두 개의 자동화 설정이 있고 둘 다 기본으로 켜져 있어요. 탭 빌리기 전 확인(Confirm before borrowing tabs)과 사람 도움 요청 허용(Allow requests for human help)이 그것인데, 브라우저 프로필에 저장되어 세션마다 적용됩니다.

둘 다 끄면 마치 무인 모드처럼 동작하지만, 이런 동작은 이제 확장 프로그램 설정으로만 제어돼요. 0.3.0부터는 예전에 쓰던 --unattended, --no-confirm, 환경변수 방식은 호환성으로만 남고 우선순위가 없어졌습니다. 즉 무인 실행을 하려면 사용자가 브라우저에서 일부러 해제해야 해요. 이건 기본은 사람이 통제한다는 설계 의도가 코드에 그대로 반영된 부분이에요.

설치부터 첫 실행까지

설치는 크게 세 단계예요. 먼저 CLI를 설치하고, 다음으로 브라우저 확장 프로그램을 크롬/엣지 스토어에서 설치하고, 마지막으로 에이전트에 스킬을 심는 방식입니다. macOS와 Linux는 한 줄 스크립트로, Windows는 PowerShell로 설치할 수 있어요. 설치가 끝나면 bsk --version으로 확인하고, bsk install-skill로 내가 쓰는 에이전트 하네스를 골라 스킬을 넣은 뒤 bsk doctor로 연결 상태를 점검해요.

# macOS/Linux에 bsk CLI 설치
curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh
# 버전 확인
bsk --version
# 에이전트에 스킬 설치 (Space로 하네스 선택 후 Enter)
bsk install-skill
# 연결 상태 점검
bsk doctor

먼저 에이전트를 쓰는 사용자라면 위 설치 명령 대신, "이 머신에 browser-skill을 셋업해줘" 같은 한 줄을 에이전트에게 보내는 것만으로도 CLI와 스킬까지 알아서 설치하도록 유도할 수 있어요. 전체 페이지 스크린샷처럼 부가 기능도 있고, bsk screenshot --session <id> --full-page로 산출물을 받아갑니다.

한계와 실용 시사점

드러나 있는 벽도 있어요. 지원 브라우저가 크롬과 엣지 중심이고, 파이어폭스는 계획 단계입니다. 다른 크로미움 계열 브라우저는 확장 프로그램 지원 여부에 따라 동작이 갈릴 수 있어요. 운영체제는 macOS(인텔/애플 실리콘), 리눅스(x64/ARM64), 윈도우 x64를 지원하고요.

로그인 세션을 그대로 쓴다는 장점이 곧 보안 고려 대상이기도 해요. 에이전트가 건드릴 수 있는 탭의 범위를 통제하는 설정이 명시적으로 존재하는 이유이기도 하죠. 서버에 있는 에이전트를 내 로컬 브라우저에 연결하는 원격 연결 기능도 공식 문서로 제공하는데, 인증 서비스와 게이트웨이 사용을 전제로 하니 별도 고려가 필요해요.

결국 이 프로젝트가 보여주는 방향은 명확해요. 에이전트가 사람의 작업을 대신 새로 시작하기보다 사람이 쓰는 환경을 안전하게 빌려 쓰는 쪽으로 옮겨가고 있다는 점입니다. 로그인 재사용, 에이전트 무관성, 휴먼 인 더 루프라는 세 축이 한 도구에 담긴 사례라, 브라우저 자동화를 도입하려는 팀이라면 직접 탭 빌림 흐름을 실행해보면 판단이 빨라질 거예요.

참고 링크

• BrowserSkill GitHub 저장소
• BrowserSkill README (영문)
• 전체 페이지 스크린샷 가이드