BrowserSkill

让 AI 直接操作你已登录的真实浏览器，不打断当前工作

BrowserSkill 是一个让 AI 代理直接操控你真实、已登录浏览器的开源工具，由 CLI 与浏览器扩展两部分组成，支持任何能执行 shell 命令的 AI 代理。它解决的核心问题是：现有浏览器自动化方案通常需要启动独立的无头浏览器或全新会话，导致登录态、Cookie、插件和当前页面状态无法复用，AI 操作时还会打断用户正在进行的浏览。BrowserSkill 通过扩展把真实浏览器暴露给代理，代理以命令行方式发送指令，完成点击、输入、导航、读取页面等操作，同时尽量不抢占用户当前标签页，让自动化与人工使用可以并行。项目使用 TypeScript 编写，定位为跨代理的通用浏览器能力层，适合需要让 AI 在已登录网站（如后台系统、社交平台、内部工具）中执行任务的场景。目前星标约 1.9k，属于成长中的早期项目。

开源 free 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2819

维护状态活跃

是否开源是

定价模式 free

项目数据

分类自动化工作流

开发团队Tencent

所属国家

官网地址

GitHubhttps://github.com/Tencent/BrowserSkill

定价模式free

价格说明开源免费，无官网定价信息

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent,browser-use,dsh-plugin

GitHub 星标★ 2819

30天Star增速

HF 下载量

上线时间2026-06-22 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

操作系统：macOS（Apple Silicon / Intel）、Linux（x64 / ARM64）或 Windows x64
浏览器：Chrome 或 Microsoft Edge（其他 Chromium 内核浏览器可装 Chrome 商店版）
一个能执行 shell 命令的 AI 代理（Cursor、Claude Code、Codex 等）
网络可访问 GitHub raw 地址以下载安装脚本

安装与启动步骤

1安装 bsk CLI

macOS 与 Linux 用户执行该脚本，默认安装到 ~/.local/bin，安装后确认该目录在 PATH 中。
```
curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh
```
2Windows 安装 CLI

仅 Windows 用户执行，通过 PowerShell 安装到 ~/.local/bin；macOS/Linux 用户跳过此步。
```
irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex
```
3验证 CLI

运行版本命令，能打印出版本号说明 bsk 已正确安装并可用。
```
bsk --version
```
4安装浏览器扩展

到 Chrome 应用商店或 Edge 加载项页面安装 BrowserSkill 扩展，其他 Chromium 浏览器装 Chrome 商店版。
5安装 Agent Skill

运行后按空格选择要安装的 Agent 宿主，回车确认；用 --list 可查看内部变体和安装路径。
```
bsk install-skill
```
6在会话中试用

新建 Agent 会话，发送需要浏览器的提示词，例如让代理打开页面并总结内容。

关键配置

配置项	必填	说明	示例
`BSK_HOME`	否	共享的 bsk 数据目录，沙箱代理场景下与常驻 daemon 连接使用	`/your/path`
`BSK_AUTO_START`	否	设为 0 时禁止自动启动 daemon，供沙箱代理环境使用	`0`

如何确认成功

bsk --version 有版本输出，扩展已装入浏览器，Agent 会话能按 /browser-skill 提示词成功操作页面。

常见问题

Q：我的 Agent 跑在每次命令后清理后台进程的沙箱里怎么办？

A：参考 docs/sandboxed-agents.md，把 daemon 放在常驻宿主环境，并用共享的 BSK_HOME 加 BSK_AUTO_START=0 连接；普通本地使用默认自动启动即可。

Q：skill 已存在，重新安装没生效？

A：已有安装默认会被跳过，加 --force 才会覆盖；想保留自己的指令用 --source 指定文件，显式 --source 的安装会一直按自定义处理。

Q：支持 Firefox 吗？

A：目前只支持 Chrome 和 Microsoft Edge，其他 Chromium 内核浏览器在支持未打包扩展时可用，Firefox 尚在计划中。

Q：代理会打断我自己的浏览吗？

A：任务在独立可见的 Agent Window 中运行；若需操作你已打开的标签页，代理会显式借用并在完成后归还，其余浏览器不受影响。

Q：怎么查看可安装的宿主和路径？

A：执行 bsk install-skill --list 可查看内部变体与安装路径。

注意事项

手动安装顺序是先装 bsk CLI，再装浏览器扩展，最后装 skill。
本地修改过 SKILL.md 会暂停自动更新，doctor 会给出 WARN 及恢复选项。
遇到验证码、登录或确认弹窗等只能人工完成的步骤时，可让代理请求你接管后继续。
给代理一句安装指令让其自动安装时，需使用 README 中给出的 AGENT_INSTALL.md 链接。

核心亮点

复用真实浏览器的登录态与 Cookie，无需重新认证即可操作需登录的网站
CLI + 扩展架构对代理类型无绑定，任何能执行 shell 的 AI 代理都能接入
尽量不抢占用户当前标签页，自动化与人工浏览可并行进行

不足之处

项目处于早期，文档与社区生态仍在建设中
依赖浏览器扩展，跨浏览器与跨平台兼容性有待验证

适用场景

让 AI 代理在已登录的后台管理系统中批量执行配置或数据录入
在社交平台或内容网站上自动完成发布、回复等需登录的操作
对内部工具或 SaaS 页面做自动化巡检与信息抓取，无需单独维护登录脚本

替代项目

browser-use、Playwright MCP

项目介绍

BrowserSkill 是一个自动化工作流领域的开源项目，官方简介：Let AI agents use your real, logged-in browser without interrupting your work. CLI + extension for browser automation across any shell-capable AI agent.。项目使用 TypeScript 开发，在 GitHub 上获得 1941 星标。

上一篇：cli

下一篇：tokenjuice