BrowserSkill
<p align="center">
<img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/browserskill-readme-banner.png" alt="BrowserSkill — connect your AI agent to your browser" />
</p>
<p align="center">
<strong>당신의 에이전트. 당신의 브라우저. 하나의 연결.</strong><br />
이미 사용하고 있는 브라우저를 AI 에이전트를 위한 작업 공간으로 만드세요.
</p>
<p align="center">
<a href="https://browserskill.weixin.qq.com/"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/readme-website-en.svg" alt="Visit the BrowserSkill website" /></a>
<a href="#quick-start"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/readme-start-en.svg" alt="Get started with BrowserSkill" /></a>
</p>
<p align="center">
<a href="https://trend.ondo.sh/github/r/Tencent--BrowserSkill/en.html"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/github-trending.svg" alt="BrowserSkill: best recorded GitHub Trending daily rank #4, all languages, September 2026" width="360" /></a>
</p>
<p align="center">
English · <a href="README.zh-CN.md">中文</a><br />
<a href="https://browserskill.weixin.qq.com/">웹사이트</a> ·
<a href="#see-it-in-action">데모</a> ·
<a href="#what-you-can-do">기능</a> ·
<a href="#website-debugging">웹사이트 디버깅</a> ·
<a href="#documentation">문서화</a> ·
<a href="CHANGELOG.md">변경 로그</a>
</p>
BrowserSkill은 사용자의 기존 로그인 정보를 활용하여 AI 에이전트를 Chrome 또는 Microsoft Edge에 연결합니다. 읽기, 클릭, 채우기 또는 조사와 같은 작업을 부여할 수 있습니다. 작업 내용은 별도의 Agent Window에서 계속 표시되며, 필요할 때 사용자가 직접 제어할 수 있습니다. 기존 탭은 작업이 끝날 때 명시적으로 빌려지고 반환될 수 있습니다.
작동 모습 보기
<details>
<summary><strong style="font-size: 1em;">▶ 데모 시청 · 81초 · 영어</strong><br /><picture><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/demo/browserskill-demo-en.png" alt="BrowserSkill demo preview — Your agent. Your browser. One connection." width="960" /></picture></summary>
</details>
<p align="center">
커버를 클릭하여 비디오 확장 · <a href="docs/assets/demo/browserskill-demo-en.mp4">MP4 다운로드</a><br />
로컬 데모 작업 공간에서 기록된 실제 브라우저 동작.
</p>
이미 사용 중인 에이전트 연결하기
<table align="center">
<tr>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/codex.svg" alt="Codex" width="42" height="42" /><br /><strong style="font-size: 1em;">Codex</strong></td>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/claude.svg" alt="Claude Code" width="42" height="42" /><br /><strong style="font-size: 1em;">Claude Code</strong></td>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/cursor.svg" alt="Cursor" width="42" height="42" /><br /><strong style="font-size: 1em;">Cursor</strong></td>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/openclaw.svg" alt="OpenClaw" width="42" height="42" /><br /><strong style="font-size: 1em;">OpenClaw</strong></td>
</tr>
<tr>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/codebuddy.svg" alt="CodeBuddy" width="42" height="42" /><br /><strong style="font-size: 1em;">CodeBuddy</strong></td>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/workbuddy.svg" alt="WorkBuddy" width="42" height="42" /><br /><strong style="font-size: 1em;">WorkBuddy</strong></td>
</tr>
</table>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/pi.svg" alt="Pi" width="42" height="42" /><br /><strong class="text-primary">Pi</strong></td>
<td align="center" width="180"><img src="https://raw.githubusercontent.com/Tencent/BrowserSkill/HEAD/docs/assets/harnesses/hermes.png" alt="Hermes Agent" width="42" height="42" /><br /><strong class="text-primary">Hermes Agent</strong></td>
</tr>
</table>
Qoder, Qoder CN, 그리고 DeepSeek Harness도 스킬 타겟으로 지원됩니다 (bsk install-skill --harness qoder, --harness qoder-cn, 및 --harness dsh). 또한 **DeepSeek Harness**는 번들된 스킬 등록과 온디맨드 bsk CLI 설정을 갖춘 경량 플러그인(@wxg-prc-cpg/browser-skill-dsh-plugin)도 제공합니다.
셸 명령을 실행할 수 있는 이러한 다른 에이전트들도 동일한 bsk CLI를 사용하며, MCP 클라이언트는 bsk mcp(MCP setup)를 통해서도 연결할 수 있습니다. 사용자님이 에이전트와 모델을 선택하면, BrowserSkill이 이를 브라우저에 연결합니다.
할 수 있는 작업 (What you can do)
| 목표 | BrowserSkill이 제공하는 기능 |
|---|
| 로그인된 상태에서 작업하기 | 브라우저의 기존 로그인 상태를 사용하여 문서를 읽고, 내부 사이트를 검색하며, 웹 워크플로우를 완료할 수 있습니다. |
| ... | |
빠른 시작 (Quick Start)
로컬 자동화를 위해서는 AI 에이전트 + bsk CLI + 브라우저 확장 프로그램이 필요합니다. CLI에는 백그라운드 데몬(daemon)이 포함되어 있습니다. 스킬은 에이전트에게 이를 사용하는 방법을 가르칩니다.
| 구성 요소 | 지원 환경 |
|---|
| CLI / daemon | macOS: Apple Silicon 및 Intel · Linux: x64 및 ARM64 · Windows: x64 |
| ... | |
에이전트가 설정하도록 하세요 (Let your agent set it up)
에이전트에게 다음을 전송하세요:
Set up browser-skill on this machine by following https://raw.githubusercontent.com/Tencent/BrowserSkill/main/AGENT_INSTALL.md
이 가이드는 CLI 설치, 스킬 설정, 연결 확인 및 첫 번째 브라우저 작업을 다룹니다. 여전히 사용하려는 브라우저에 확장 프로그램을 설치해야 합니다:
Chrome용 설치 · Edge용 설치
<details>
<summary><b>수동 설정</b></summary>
1. CLI 설치
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh
export PATH="${BSK_INSTALL_DIR:-$HOME/.local/bin}:$PATH"
Windows PowerShell:
irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex
기본적으로 바이너리는 ~/.local/bin에 설치됩니다. 터미널 또는 에이전트 환경에서 이를 확인하십시오:
이미 실행 중인 에이전트가 bsk를 찾지 못하는 경우, 새로운 PATH를 인식하도록 재시작하거나 설치된 바이너리의 절대 경로를 구성해야 합니다.
2. 확장 프로그램 연결
Chrome 웹 스토어 또는 Edge 애드온에서 설치하고, 연결을 활성화한 후 사용을 시작하십시오. 로컬 페어링은 선택 사항입니다. 페어링되지 않은 연결은 계속 사용할 수 있으며 신원 경고를 표시합니다. 연결을 확인하려면 bsk daemon pair를 실행하고 생성된 링크를 연결 설정 → 페어링 링크에 붙여넣으십시오. 페어링 정보는 재시작 및 업그레이드를 거쳐도 유지되며, 페어링된 연결은 실패 후에도 검증 과정을 자동으로 건너뛰지 않습니다. 로컬 페어링을 참조하십시오.
3. 에이전트용 스킬 설치
Space 키를 사용하여 하네스를 선택한 다음 Enter 키를 누르십시오. 비대화형(non-interactive) 설정을 위해서는 명시적으로 선택하십시오:
bsk install-skill --harness cursor --json
지원되는 대상과 경로를 확인하려면 bsk install-skill --list를 사용하십시오. 기존 설치는 --force로 명시적으로 덮어쓰지 않는 한 건너뜁니다. 다른 하네스(harness)의 경우, 전체 crates/bsk-cli/skill/ 디렉토리를 references/를 포함하여 해당 스킬 디렉토리 내에 browser-skill/로 복사하십시오.
MCP 클라이언트의 경우, bsk install-skill --harness codex --mcp는 로컬 stdio 서버도 구성합니다 (claude-code와 cursor도 지원됨). MCP 설정 및 워크플로우를 참조하십시오.
4. 연결 확인
실패한 검사를 해결하고 확장 프로그램이 **연결됨(Connected)**을 표시하는지 확인하십시오. 새 에이전트 세션을 시작하여 browser-skill을 발견할 수 있는지 확인하십시오. 성공적인 닥터(doctor) 검사만으로는 스킬 발견을 확신할 수 없습니다.
첫 번째 작업 시도하기
연결되면 에이전트에게 다음을 요청하십시오:
Use browser-skill to open https://example.com, summarize the page, and end the browser session when finished.
에이전트는 백그라운드에서 자체 창을 열고 페이지를 읽은 다음, 요약을 반환하고 작업을 중지합니다. 작업 창에 나타나는 외부 링크 또는 수동으로 생성된 탭은 가장 최근에 사용한 일반 창으로 이동하며, 남아 있는 사용자 창이 없는 경우 새 사용자 창이 생성됩니다. 라우팅은 탭 생성 후에 발생하므로, 탭이 작업 창에 잠시 나타날 수 있습니다. 페이지에서 열린 탭과 사람의 도움 또는 녹화 기록은 보존됩니다. 스킬 슬래시 커맨드를 지원하는 하네스는 /browser-skill도 사용할 수 있습니다.
제어되는 탭을 원래의 에이전트 창(Agent Window) 밖으로 이동하면 전체 브라우저 세션이 종료되고, 모든 페이지가 그 자리에 보존되며, 제어 표시기가 제거됩니다. 빌려온 탭도 제자리에 머무릅니다. 탭을 다시 이동시킨다고 해서 작업이 재개되는 것은 아니며, 다시 시작하려면 사용자의 결정이 필요합니다. 같은 창 내에서 탭 순서를 재배열하는 것은 영향을 받지 않습니다. 일반적인 세션 중단은 여전히 빌려온 탭을 반환하고 작업 페이지를 정리합니다.
Chrome은 페이지가 네이티브 팝업을 열 때 여전히 창을 활성화할 수 있습니다. 관찰된 작업 팝업의 경우, 사용자가 다른 창으로 전환하지 않았다면 확장 프로그램이 이전 Chrome 창 또는 최소화 상태를 복원합니다. Chrome의 공개 확장 API는 일시적인 활성화가 없거나 포커스를 다른 애플리케이션으로 복원할 것을 보장할 수 없습니다.
<details>
<summary><b>CLI를 직접 사용해 보세요</b></summary>
세션을 시작하고 반환된 session_id를 유지하세요:
아래 각 명령어에서 <id>를 해당 값으로 대체하세요. 여러 개의 연결된 브라우저가 있는 경우, 세션 시작 시 --browser <instance-id-or-name>을 사용하여 하나를 선택하세요. 백그라운드 생성이 기본값입니다. --no-focus는 계속 지원되며, --focus는 새 창을 명시적으로 전경으로 가져옵니다. 사람의 도움 요청 및 대화형 녹화도 여전히 관련 창을 전경으로 가져옵니다.
bsk navigate https://example.com --session <id>
bsk observe --session <id>
bsk screenshot --session <id> --out example.png
...
명령 옵션은 bsk --help 또는 bsk <command> --help를 사용하세요. 작업이 완료되었거나 실패한 경우에도 항상 세션을 중지해야 합니다. 빌려온 탭은 원래 창으로 반환됩니다.
</details>
WorkBuddy/CodeBuddy 또는 명령 자식(command children)을 수확하는 호스트의 경우, 에이전트는 기존 데몬을 재사용하거나 관리되는 백그라운드 작업에서 bsk daemon start --foreground를 실행한 다음, 별도의 도구 호출로 이를 확인해야 합니다. 공유된 BSK_HOME, BSK_AUTO_START=0 및 호스트가 작업을 유지할 수 없는 경우의 독립형 터미널 대체(fallback)에 대해서는 호스트 설정 가이드를 따르세요.
DeepSeek Harness 플러그인
가벼운 DSH 플러그인 (@wxg-prc-cpg/browser-skill-dsh-plugin)은 DeepSeek Harness 프로파일용 표준 browser-skill CLI 스킬을 패키징하고, 호스트의 PATH에 자동으로 ~/.local/bin (또는 설정된 bskPath)를 추가하며, bsk가 아직 설치되지 않은 경우 온디맨드(on-demand) bsk CLI + 확장 프로그램 설정 흐름을 번들링합니다. 내부적으로는 다른 모든 에이전트와 동일한 bsk CLI, 데몬 (DSH_SESSION_ID 암시적 스코핑), 및 Agent Window 런타임을 공유합니다.
dsh plugin --profile web add @wxg-prc-cpg/browser-skill-dsh-plugin
dsh --profile web
web을 사용자의 프로파일 이름으로 대체합니다. 대화에서 /browser-skill을 호출하면, bsk가 누락된 경우 에이전트가 번들링된 설치 프로그램을 실행하고 브라우저 확장 프로그램 연결을 자동으로 안내합니다. 별도의 bsk install-skill 단계는 필요하지 않습니다.
플러그인 사용 및 구성 · npm 패키지
웹사이트 디버깅
에이전트에게 버그의 근거가 되는 브라우저 증거를 제공합니다. 디버깅 권한이 있는 웹사이트에서 문제를 재현하기 전에 캡처를 시작한 다음, 확장 프로그램 또는 에이전트를 통해 결과를 검사합니다.