텐센트, AI가 로그인된 브라우저 활용하는 BrowserSkill 오픈소스화

导语, 이 글에서 배울 수 있는 것

2026년 9월, 텐센트 PCG가 BrowserSkill이라는 프로젝트를 오픈소스로 공개했다. 이것이 해결하는 것은 아주 구체적인 문제, 즉 AI 어시스턴트가 당신 컴퓨터의 Chrome이나 Edge에 이미 로그인된 상태를 그대로 재사용해서 웹페이지를 조작하게 하는 것이다.

이 글은 자동화 워크플로에 '이미 로그인된 브라우저'를 연동해야 하는 개발자와 효율 덕후를 대상으로 하며, 당신은 아래 내용을 보게 될 것이다.

- 전통적인 웹 자동화가 왜 '웹페이지 열기'가 아니라 '신원'에서 막히는가

- BrowserSkill이 택한 세 번째 길, 그리고 그 로컬 아키텍처 경로

- 4단계 설치와 4가지 검수 기준, 코드 블록 명령 포함

- 바로 복사할 수 있는 3가지 프롬프트 템플릿

- 두 개의 스위치, 세 개의 함정, 한 개의 경계, 그리고 저자의 실제 시행착오 경험

읽고 나면 당신은 'AI가 대신 로그인된 백엔드를 조작하게 하는 것'을 독립적으로 돌려볼 수 있고, 어떤 상황에서 이걸 쓰면 안 되는지도 알게 될 것이다.

실제 로그인의 고통에서 시작하며

저자는 멀티 플랫폼 콘텐츠 배포 파이프라인을 하나 가지고 있는데, 가장 자주 막히는 곳은 원고가 아니라 로그인이었다. 며칠 전 아침 9시 40분, 그는 여느 때처럼 그 자동 배포 파이프라인을 돌렸고, 스크립트가 하나씩 내려가다가 푸시 단계에 이르러, 전부 초록이던 것이 전부 빨강으로 바뀌었다. 이유는 딱 한 줄, 브라우저 확장이 연결되지 않았다는 것이었다. 그는 그 에러 메시지를 십여 초 동안 바라보았다. 마음속에 든 건 조바심이 아니라, 너무 익숙해서 저릿해지는 무력감이었다.

이런, 하나의 파이프라인에서 유난히 긴 한 구간이, 하필 유난히 기술적이지도 않은 구간이었다. 원고를 다 썼고, 그림도 다 맞췄고, 레이아웃도 통과했는데, 마지막에 로그인 상태 하나에 막힌 것이다.

솔직히, 이건 그 혼자만의 문제가 아니다. 당신이 AI에게 로그인이 필요한 웹페이지를 다루게 해본 적이 있다면, 누구든 겪어봤을 것이다.

저자는 지난 2년간 장애인연합회 시스템에서 여섯 곳의 AI 교육을 돌았다. 원저우, 푸딩, 항저우, 룽취안, 판안, 칭톈이었는데, 강당에 앉은 사람들은 대부분 직접 가게를 하거나 작은 장사를 하는 친구들이었다. AI가 글을 쓰고, 그림을 그리고, 영상을 편집할 수 있다고 하면 다들 고개를 끄덕였다. 그런데 '그 플랫폼들을 대신 조작하게 하자'는 대목에 이르면 여기서 한 번 브레이크를 밟아야 했다. AI가 먼저 당신 계정에 들어갈 수 있어야 하니까. 이제 이 말은 바꿔 말할 수 있게 되었다.

전통적 방식은 어디서 막히는가, 신원이 바로 문턱이다

AI가 웹 자동화를 하는这件事, 업계는 오랫동안 해왔고, 방식은 두 갈래뿐이다.

한 갈래는 AI에게 깨끗한 브라우저를 만들어 주는 것, 예컨대 헤드리스 브라우저 그 계열이다. 아주 깨끗하고 티끌 하나 없다. 문제는 그것이 아무도 알아보지 못한다는 것이다. 당신의 백엔드에는 들어가지 못하고, 당신의 계정도 없고, 당신이 가서 테스트 계정을 붙여주고, 비밀번호를 스크립트에 써넣고, 매일 유지보수까지 해야 한다.

다른 갈래는 더 무식하다. 당신이 쓰고 있는 브라우저 창을 그대로 접수하는 것이다. AI가 움직이면 당신은 작업을 멈춰야 한다.

그래서 이 세월 동안 AI가 웹페이지를 조작하는这件事의 막히는 지점은 결코 '웹페이지 열기'가 아니라 '나는 누구인가'였다. 웹페이지를 여는 것은 기계가 2초면 한다. 그런데 그것은 당신이 누구인지 모르니, 가치 있는 무엇도 볼 권한이 없다.

진실은, 웹 자동화의 진짜 문턱은 브라우저 기술이 아니라 신원이라는 것이다.

세 갈래 경로 비교

BrowserSkill이 택한 세 번째 길은 차용이다. 아래 표가 세 갈래 경로를 함께 놓고 본다.

경로 / 방식 / 장점 / 단점 헤드리스 브라우저 / AI에게 깨끗한 브라우저를 만들고 테스트 계정을 붙인다 / 환경이 깨끗하고 통제 가능 / 아무도 알아보지 못하고, 당신 백엔드에 들어가지 못하며, 비밀번호를 스크립트에 써넣고 매일 유지보수해야 함 브라우저 접수 / 당신이 쓰고 있는 브라우저 창을 그대로 접수한다 / 실제 상태를 바로 사용 / AI가 움직이면 당신은 작업을 멈춰야 하고, 체험이 충돌함 로그인 상태 차용(BrowserSkill) / 이미 열린 브라우저에서 별도의 독립 Agent Window를 열어 로그인 상태를 재사용 / 테스트 계정 필요 없고, 비밀번호를 넘길 필요 없으며, 탭을 먼저 빌리고 나중에 반납 / 본机에 커맨드라인 도구와 확장을 설치해야 하고, 컴퓨터 설정을 전혀 안 건드리는 사람에게는 약간의 학습 경사가 있음

차용이라는 길의 핵심 방식은, 당신이 이미 열어둔 브라우저 안에서 별도의, 당신이 볼 수 있는 창을 하나 더 여는 것이다. 이름은 Agent Window다. 이 창은 당신 브라우저에 이미 있는 로그인 상태, Cookie, 로그인 정보를 그대로 사용하며, 전부 당신이 일상적으로 쓰는 그一套다. 테스트 계정도 필요 없고, 비밀번호를 누구에게 넘길 필요도 없다.

당신의 기존 탭들은 쓰던 대로 쓰면 되고, 영향을 받지 않는다. AI가 당신이 이미 열어둔 어떤 탭을 움직여야 한다면, 먼저 당신에게 빌려야 하고, 다 쓰면 돌려주며, 기본적으로는 동의 여부를 묻는 팝업까지 띄운다.

캡차, 2차 인증, 확인 팝업처럼 사람만 처리할 수 있는 일에 부딪히면, AI는 멈추고 당신에게 인계를 요청한다. 당신이 처리를 마치면, 그것은 이어서 계속 실행한다.

아키텍처 경로, 전 과정이 본机을 벗어나지 않는다

이 설계에서 특히 영리한 한 수는 로그인 상태 재사용이 아니라, 그 '차용'이라는 말이다. 그것은 'AI와 당신의 계정'이라는这件事을 블랙박스에서 빌리고 갚는 계약으로 바꿔 놓았다.

전체 경로의 흐름은 이렇다. AI가 명령을 내리면, 명령은 당신 컴퓨터 위의 로컬 소프트웨어(daemon)로 가고, 소프트웨어는 본机의 한 채널을 통해 브라우저 확장에 통지하고, 그제야 확장이 Agent Window에서 움직인다.

전 과정이 당신의 이 컴퓨터를 벗어나지 않으며, 어떤 제3자 서버도 당신의 로그인 정보를 볼 수 없다.

적용 범위, 누가 쓸 수 있는가

공식이 제시한 호환 목록에는 아홉 가지 AI가 있는데, Cursor, Claude Code, Codex, CodeBuddy, WorkBuddy 같은 것들이 모두 포함된다. 저장소에 있는 그 설치 설명 한 줄을 당신의 AI에게 던져주면, 그것이 알아서 일을 해낸다.

저자는 공식이 내세운 포지셔닝을 보고 조금 동의하지 않았다. 그들은 이 프로젝트를 '개발자를 위한 브라우저 자동화 능력'으로 소개했지만, 저자는 그건 작게 말한 것이라고 생각했다. 진짜 로그인 상태에 발목 잡히는 것은 프로그래머가 아니라, 매일 다섯 개의 백엔드에 로그인해야 하는 평범한 사람과 작은 사장들이다.

생각해 보라, 한 사람이 위챗 공식계정, 즈후, 바이자하오, 숏폼 백엔드, 회사 내부 시스템을 관리하는데, 매일 첫 번째 일이 하나씩 로그인하는 것이다. Cookie가 만료되면 다시 로그인한다. 이런 일은 한 푼의 가치도 없지만, 그것이 잡아먹는 것은 당신 하루 중 상태가 특히 좋은 그 시간이다.

저자는 50세의 제조업 사장 한 명을 아는데, 프로그래밍 배경이 전혀 없이 AI로 주문 추적 시스템을 스스로 만들어냈다. 첫 버전은 기능이 세 개뿐이었다. 주문 입력, 상태 조회, 만료 알림. 그는 나중에 한마디 했다. 원래 내가 어렵게 생각한 거였구나.

이 말을 저자는 오래 기억했다. 대부분의 경우 우리를 막는 것은 정말로 기술이 아니라, 우리가 그것이 어렵다고 여기는 마음이기 때문이다.

4단계 설치와 검수

아래에서 세 가지 일을 함께 돌려보자. 읽고 나면 당신도 스스로 재현할 수 있을 것이다. 첫째, AI가 당신이 이미 로그인해 둔 웹페이지를 열고, 페이지 내용을 읽어서 요약해주게 한다. 둘째, AI가 당신이 이미 로그인한 어떤 백엔드에 들어가, 정보를 표 하나나 초안으로 정리하게 한다. 셋째, 캡차처럼 사람만 할 수 있는 일에 부딪히면 AI가 멈추고, 당신이 처리를 마치면 그것이 이어서 한다.

먼저 설치해야 할 세 가지를 분명히 보자

이 프로젝트는 소프트웨어 하나가 아니라, 세 가지가 협력해 동작하는 것이다. 하나는 AI에게 조작 규칙을 보여주는 스킬 파일. 하나는 컴퓨터에 설치되어 명령 실행을 담당하는 커맨드라인 도구, 명령은 bsk 라고 불린다. 하나는 브라우저에 설치되어 브라우저 연결을 담당하는 확장이다.

세 가지 중 하나라도 빠지면 돌아가지 않으며, 스킬 파일 한 부만 복사해두는 것은 소용없다. 지원하는 컴퓨터 시스템은 Windows 64비트, macOS, Linux이고, 브라우저는 현재 Chrome과 Edge만 인식한다. 파이어폭스는 공식이 계획 중이라고 했지만, 아직은 아니다.

커맨드라인 도구 설치

Windows 사용자는 PowerShell을 열고 아래 한 줄을 그대로 붙여 넣고 엔터를 누른다.

irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex

macOS와 Linux 사용자는 이 줄로 바꾼다.

curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh

설치 후 먼저 검증한다. 이 줄을 입력하면, 버전 번호가 보이면 설치된 것이다.

bsk --version

여기 미리 말해둘 함정이 하나 있다. 설치 스크립트는 당신이 현재 쓰는 터미널 창의 경로 설정을 바꾸지 못하므로, 명령을 찾을 수 없는 상황이 생길 수 있다. 이때는 터미널 창을 새로 열어 다시 시도하거나, 설치 안내에 따라 경로를 추가하라.

더 쉽게 간과되는 함정이 하나 더 있다. 설치를 마친 뒤, 실행 중이던 그 AI 세션을 재시작해야 한다. 그러지 않으면 방금 설치한 것을 읽지 못한다. 저자는 처음에 재시작을 안 해서 화면을 반 분 동안 멍하니 바라봤다.

브라우저 확장 수동 설치

이 단계는 반드시 당신이 직접 해야 하며, AI가 대신할 수 없다. Chrome 웹 스토어나 Edge 추가 기능 스토어를 열고, BrowserSkill을 검색하고, 추가를 누르고, 브라우저 안내에 따라 확인하라.

회사 네트워크에서 스토어를 열 수 없다면, 프로젝트의 Releases 페이지에서 확장 압축 파일을 내려받아, 브라우저에서 개발자 모드를 켜고 '압축 해제된 확장 프로그램 로드'를 선택하면 된다.

설치 후, 브라우저 툴바의 확장 아이콘을 한 번 클릭해서, 팝업의 연결 상태가 초록으로 바뀌어야 비로소 자리를 잡은 것이다.

스킬을 당신의 AI에 설치

터미널로 돌아와, 이 줄을 입력한다.

bsk install-skill

그것은 당신 컴퓨터에 설치된 AI를 자동으로 스캔하고, 감지된 것을 나열하며, 스페이스 키로 체크하고, 엔터로 확인한다.

어떤 것을 지원하고 어느 디렉터리에 설치하는지 보고 싶다면, 먼저 이 줄을 실행할 수 있다.

bsk install-skill --list

상호작용을 건너뛰고 바로 지정하려면, 예컨대 Cursor에 설치한다면, 이렇게 쓸 수 있다.

bsk install-skill --harness cursor --json

설치 후 AI 세션을 재시작하라. 이 단계는 위의 그 조항과 같은 이치다. 재시작하지 않으면 인식하지 못한다.

마지막으로 한 번 건강검진

bsk doctor

빨간색에 놀라지 마라. 확장이 아직 연결되지 않았을 때, 한 항목이 FAIL로 표시되는 것은 정상이며, 설치가 망가진 것이 아니다. 안내에 따라 확장을 설치하고 상태가 초록으로 바뀐 뒤, 다시 한 번 돌려서 전부 ok가 되어야 비로소 진짜로 뚫린 것이다.

저자가 스스로 정한 검수 기준은 네 가지이며, 당신도 그대로 대조하면 된다.

첫째, bsk --version 이 버전 번호를 출력할 수 있다. 둘째, 확장 팝업의 연결 상태가 초록이다. 셋째, bsk doctor 에 FAIL이 없다. 넷째, AI 세션을 새로 열어, 웹페이지를 성공적으로 열고 내용을 요약해낼 수 있다.

네 가지를 모두 통과하면, 이 기초는 잘 다져진 것이다.

AI에게 어떻게 말할 것인가, 이게 설치보다 더 중요하다

도구를 설치하는 것은 시작일 뿐이고, 잘 쓰느냐는 전적으로 당신이 어떻게 작업을 지시하느냐에 달려 있다. 저자가 시험해 본 결과, 좋은 프롬프트의 템플릿은 이렇다. 어디를 열고, 무엇을 하고, 무엇을 출력하고, 어떻게 하면 완료로 치는가.

처음 실행할 때는, 먼저 공개 페이지 하나로 연습하라. 시작부터 백엔드로 들어가지 마라.

browser-skill을 사용해 https://example.com 을 열고, 페이지 제목과 본문을 읽고, 3개의 중국어 요점으로 요약해줘. 읽기만 하고, 로그인하지 말고, 표를 채우지 말고, 제출하지 말고, 완료하면 세션을 종료해.

독립된 창이 자동으로 하나 튀어나와 페이지에 접속하고, 요약을 당신에게 돌려주고, 스스로 닫히는 것을 볼 수 있다면, 엔드투엔드는 뚫린 것이다.

익숙해지면, 이 세 가지 자주 쓰는 템플릿으로 바꿔라.

템플릿 하나, 장문 읽기, 자료 정리.

browser-skill로 【글 링크】를 열고, 전문을 통독하고, 필요에 따라 스크롤해서 펼쳐. 제목, 저자, 발행일, 핵심 논점, 핵심 데이터, 원문 링크를 추출해. 사실과 의견을 분리하고, 확인할 수 없는 것은 확인 필요로 표시해. 읽기만 하고 스크린샷을 찍어, 로그인하지 말고 댓글 달지 말고, 완료하면 세션을 닫아.

템플릿 둘, 여러 페이지 비교.

browser-skill로 이 3개의 공개 페이지를 차례로 열어, 링크는 여기에 써. 페이지 제목, 발행일, 핵심 결론, 데이터 기준, 원문 링크를 담은 목록 하나로 정리해. 페이지 간에 모순되는 것은 나란히 진술하고, 억지로 통일하지 마. 읽기만 하고, 다운로드하지 말고, 로그인하지 마.

템플릿 셋, 자기 백엔드에 들어가 초안만 채우고 제출은 금지.

browser-skill로 내가 이미 로그인한 백엔드를 열어, 이름은 여기에 써. 아래 내용을 새 초안에 채워 넣어. 초안 생성과 편집은 허용하되, 발행, 제출, 전송, 확인 버튼 클릭은 금지해. 다 채우면 스크린샷을 찍고 일시정지해서, 내가 사람이 검사하길 기다려. 로그인, 캡차, 권한 또는 결제 단계에 부딪히면, 즉시 멈춰.

템플릿 셋의 정수는 바로 그 '제출 금지' 한마디로, 마지막 버튼을 누를 권리를 든든하게 자기 손에 남겨두는 것이다.

저자가 돌려본 세 가지 일

첫째, 저자는 AI에게 로그인해 둔 여러 콘텐츠 플랫폼에 가서 그날의 인기 순위를 베껴 오게 하고, 제목과 링크를 함께 가져와 주제 선정 참고 자료 한 부로 정리하게 했다. 원래는 플랫폼 하나하나를 직접 넘겨보던 것을, 이제 한마디면 된다.

둘째, AI에게 어떤 글 아래의 댓글을 보게 하고, 진짜 수요가 담긴 댓글을 골라내어 고객 리드 표 한 장으로 만들게 했다. 이 일은 예전에는 자투리 시간에 넘겨보는 것에 의존했는데, 절반쯤 보다가 끊기곤 했다.

셋째, AI에게 백엔드에 가서 초안을 작성하게 하고, 원고를 채워 넣고, 스크린샷을 저자에게 보여주고, 그리고 멈추게 했다. 마지막 발행은 직접 눌렀다.

세 가지 일을 다 돌리고 나서 저자가 느낀 것은 빠르다는 게 아니라, 드디어 매일 다섯 개 백엔드에 먼저 로그인하지 않아도 된다는 것이었다. 저자는 이전에 월간 계획 정리 작업을 AI에 맡겼는데, 원래는 하루 종일 걸리던 것이 이제 한 시간이면 끝난다. 같은 발상으로, 로그인 이 단계도 이제 넘겨줄 때가 된 것이다.

두 개의 스위치, 세 개의 함정, 한 개의 경계

두 개의 스위치는 확장 팝업에서 기본적으로 모두 켜져 있으며, 먼저 끄지 않는 것을 권한다. 하나는 탭을 빌리기 전 확인이며, 이걸 끄면 확인 없이 곧바로 당신의 탭을 빌린다. 하나는 사람의 도움을 요청할 수 있음이며, 이걸 끄면 캡차에 부딪혔을 때 스스로 방법을 강구할 수밖에 없다.

저자가 이해하는 일상 사용 등급은, AI가 일하고 당신이 검수하는 이쪽이 더 편하다는 것이다. 정말로 무인으로 배치 처리를 돌리려면, 그때 가서 끄는 것을 고려하라.

세 개의 함정은 모두 저자가 직접 겪었거나 남들이 겪는 것을 본 것이다.

버전을 맞춰야 한다. 커맨드라인의 버전과 확장의 버전을 함께 업그레이드해야 하며, 그러지 않으면 긴 스크린샷 같은 기능이 괜히 먹통이 된다.

기업 네트워크가 로컬 통신을 가로막을 수 있다. 확장이 감지되지 않으면, 먼저 IT에 가서 화이트리스트를 추가해 달라고 하라.

대규모 병렬 수집에는 적합하지 않다. 그것의 설계는 차용이지, 강탈이 아니다. 크롤러로 쓰지 마라.

한 개의 경계는 따로 떼어 말하겠다. 로그인 상태는 곧 권한이다. AI가 빌려간 각 탭은 모두 당신 계정의 완전한 신원을 지니고 있다. 결제, 송금, 삭제 이 세 가지 작업은 항상 사람에게 남겨두어라. 민감한 페이지는 다 쓴 뒤 수동으로 닫는 것이 더 안전하다.

여기까지 말했으니, 저자가 독자에게 솔직히 한마디 하겠다. 이 물건은 지금 아직 충분히 성숙하지 않다. 갓 3개월째 반복 개발 중인 오픈소스 프로젝트로, 명령줄 버전과 확장 버전을 자주 함께 업그레이드해야 하며, 컴퓨터 설정을 전혀 건드리지 않는 사람에게는 여전히 약간의 학습 난이도가 있다. 이것은 열자마자 바로 쓸 수 있는 소비자용 소프트웨어가 아니다.

요약, 핵심 요점

- BrowserSkill은 텐센트 PCG가 2026년 9월에 오픈소스로 공개한 프로젝트로, MIT 라이선스, TypeScript로 작성, 별 6천여 개, 반복 개발이 매우 활발함

- 이는 "로그인 상태 차용"이라는 제3의 길을 가며, 전통적인 헤드리스 브라우저, 브라우저 점유 방식과 대비를 이룸

- 아키텍처는 로컬 폐쇄 루프로, AI 명령이 본체 daemon, 본체 채널, 브라우저 확장을 거쳐 Agent Window로 전달되며 전 과정이 본체를 벗어나지 않음

- 아홉 종의 AI에 대응하며, Cursor, Claude Code, Codex, CodeBuddy, WorkBuddy가 모두 포함됨

- 설치는 세 단계 컴포넌트에 점검을 더하는 방식이고, 검수는 네 가지 기준으로 봄

- 프롬프트는 긴 글 읽기, 여러 페이지 비교, 백엔드 임시 저장 세 가지 템플릿으로 나뉘며, 백엔드 템플릿의 핵심은 제출 금지임

- 두 개의 스위치는 기본으로 켜져 있고, 세 가지 함정은 버전 정렬, 기업 네트워크, 병렬 크롤링이며, 경계는 로그인 상태가 곧 권한이라는 것임

- 진짜로 로그인 상태에 갇히는 사람은 매일 백엔드 다섯 개에 로그인하는 일반인이며, 프로그래머가 아님

그것의 진정한 가치는 얼마나 대단한가에 있지 않고, 로그인이라는 이름의 그 벽을 당신 앞에서 치워 준 데 있다. 당신이 매일 컨디션이 특히 좋은 그 몇 시간은, 원래 계정과 비밀번호를 입력하는 데 써서는 안 되는 시간이다. AI는 반복 노동을 맡고, 사람은 그 마지막 한 발을 맡는다.

당신도 해 보고 싶다면, 가장 단순한 그 템플릿부터 시작해 공개 페이지만 하나로 돌려 보고, 그다음에 백엔드를 건드리길 권한다. 돌려 본 뒤 돌아와 저자에게 한마디 해 주면, 당신은 그 말을 하게 될 것이다. 원래 내가 어렵게 생각했던 거였구나.

샤오후 AI 라이프

164

글

144k

조회

184

팬