BrowserSkill
让AI代理使用你的真实已登录浏览器,不打断你的工作。
- Star 数
- ★ 9.2k
- 最近更新
- 4 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 开发者在 Cursor 中让代理直接使用已登录的 GitHub 或公司内部系统进行操作,无需额外配置测试账号。
- 不适合
- 只使用 Firefox 的用户,目前仅支持 Chromium 125+ 的 Chrome/Edge
- 需要完全离线、不安装本地守护进程与扩展的团队
- 不愿让 AI 以已登录账号权限操作真实浏览器的用户
这个 Agent 能做什么,适合哪些场景?
BrowserSkill 是腾讯开源的一个本地桥接工具,它通过 CLI(bsk)和浏览器扩展,让 Cursor、Claude Code、Codex、OpenClaw 等支持 shell 的 AI 代理连接到你的真实浏览器。它复用你已登录的会话,在独立的 Agent Window 中执行任务,避免干扰你的正常浏览。核心组件包括 bsk CLI/守护进程和浏览器扩展,支持 macOS、Linux、Windows 以及 Chrome/Edge 浏览器。其独特的借标签页机制确保代理仅在你明确授权时借用标签页,并在任务完成后归还。项目采用 MIT 许可证,并针对多个代理框架提供了预置技能安装。
BrowserSkill 通过本地 WebSocket 协议(127.0.0.1)连接代理的 shell 命令(bsk CLI)与浏览器扩展。代理调用 bsk 命令请求浏览器任务,守护进程将请求路由到扩展,扩展在 Agent Window 中执行自动化操作(如打开网页、读取内容)。它支持借出单个标签页给代理,并在任务完成后自动归还。内置人工介入环节,当遇到验证码或登录确认时,代理可暂停并请求用户接管。安装时通过 bsk install-skill 将技能文件(skill/SKILL.md)安装到特定代理框架(如 Cursor、Claude Code、Codex)中,使代理学会使用 bsk 命令。
- 开发者在 Cursor 中让代理直接使用已登录的 GitHub 或公司内部系统进行操作,无需额外配置测试账号。
- Claude Code 用户需要代理访问个人 Gmail 或网盘,但不想暴露密码,可以复用现有登录状态。
- 在进行多步骤网页操作时,遇到验证码或二次确认,代理请求用户手动完成后继续。
- 用户希望代理操作一个特定标签页,而不干扰其他浏览器窗口,通过借标签页机制实现。
- 在 Windows 或 Linux 环境下的 Codex 或 OpenClaw 用户,通过 bsk CLI 快速集成浏览器自动化。
如何安装或部署这个 Agent?
- 安装 CLI:macOS/Linux 运行
curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh;Windows PowerShell 运行irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex。 - 验证
bsk --version。 - 从 Chrome Web Store 安装扩展:https://chromewebstore.google.com/detail/hhcmgoofomhgciiibhipgmgkgnoenaoi
- 运行
bsk install-skill并按空格选择目标代理框架(如 Cursor、Claude Code 等)。
如何使用这个 Agent?
安装后,启动一个新的代理会话,输入提示词,例如 /browser-skill open example.com and summarize what is on the page.。代理会通过 bsk CLI 执行浏览器任务,在独立的 Agent Window 中展示结果。
这个 Agent 有哪些优点和局限?
- 复用真实登录状态,无需额外测试账号,适合内部系统访问。
- 独立 Agent Window,不干扰用户正常浏览。
- 支持多种代理框架(Cursor、Claude Code、Codex、OpenClaw 等),无模型锁定。
- 内置人工介入机制,可处理验证码和确认对话框。
- 仅支持 Chrome/Edge 等 Chromium 浏览器,Firefox 尚未支持。
- 需要安装本地 daemon 和扩展,增加部署复杂性。
- 代理的浏览器操作受限于浏览器扩展的能力,可能无法执行所有高级操作。
- 借标签页机制需要用户明确授权,可能在自动化流程中增加交互延迟。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| BrowserSkill 当前 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 9.2k | 4 天前 | TypeScript | Codex · Claude Code |
| Surf CLI | 77 · 存在缺口 | 命令行工具免费 | ★ 638 | 13 天前 | TypeScript | Claude Code |
| Puppetmaster | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 468 | 今天 | Python | Codex · Claude Code |
| OpenCodeReview | 53 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 48k | 今天 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:README明确说明代理必须显式借用标签页并在任务完成后归还,且内置人工介入(human-in-loop)机制,表明有最小权限和用户确认的设计意图。但未提供具体实现细节,如权限清单、确认对话框的具体触发条件,也未说明数据流如何透明化。依赖安全方面,Cargo.toml列出了依赖但未提供漏洞扫描或审计证据。外部影响方面,扩展会自动化浏览器操作,但未说明如何限制影响范围。回滚机制未提及。来源归属方面,仓库归属Tencent,但发布者未验证。因此,多数标准仅得1分,回滚为0分。
证据显示:README、Cargo.toml、package.json和CI配置在结构上一致,表明项目内部一致性良好。依赖版本在Cargo.toml中明确指定,且CI使用--locked确保可重复构建,依赖可用性较好。但失败消息方面,未提供错误处理或用户提示的具体示例,因此得1分。
证据显示:README明确列出了支持的代理(Cursor、Claude Code等)和操作系统/浏览器,受众和场景清晰。能力边界方面,说明了代理只能通过CLI操作浏览器,且必须借用标签页,边界明确。触发精度方面,提供了具体的命令示例(/browser-skill open example.com),但未详细说明触发条件。环境适配方面,支持多种OS和浏览器,但Firefox仅计划中。因此各标准得2分。
证据显示:README结构清晰,包含快速开始、工作原理、开发者指南等,信息架构良好。安装说明详细,包括自动和手动安装步骤。命名方面,CLI和扩展名称一致(bsk)。示例和FAQ方面,提供了基本示例但无FAQ。已知限制方面,仅提及Firefox计划,未列出其他限制。许可证为MIT,明确。版本控制方面,Cargo.toml有版本号,但无CHANGELOG。维护责任方面,仓库归属Tencent,但未明确维护者。因此多数得2分,示例和已知限制、版本控制、维护责任得1分。
证据显示:输出可用性方面,CLI提供命令和技能安装,输出应可直接使用。边际价值方面,复用登录状态和保持用户工作不中断是明显优势。成本效益方面,安装简单,但需要用户安装扩展和技能,成本较低。因此各得2分。
证据显示:README中的声明(如支持多种代理)有部分代码和配置支持,但未提供独立验证。跨来源佐证方面,仅依赖仓库内部证据,无外部验证。事实与推断分离方面,README区分了事实(支持列表)和推断(预期支持),但不够明确。因此各得1分。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- 发布者身份未验证,需谨慎对待来源。
- 未提供回滚机制,若自动化操作出错可能难以恢复。
- 依赖安全未提供审计证据,建议检查依赖漏洞。
- 数据流透明性不足,用户可能不清楚代理如何访问浏览器数据。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
cli-v0.3.3 bsk CLI 0.3.3
发布说明摘录
What's Changed * fix(geometry): unify cross-frame coordinates and screenshot conversion | 统一跨 frame 坐标与截图转换 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/195 * refactor(observation): decouple DOM processing from capture orchestration | 解耦 DOM 处理与采集流程 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/198 * refactor(observation): unify cross-frame capture coordination and data ownership | 统一跨 frame 采集协调与数据归属 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/200 …在 GitHub 查看 ↗ -
ext-v0.3.3 BrowserSkill Extension 0.3.3
发布说明摘录
What's Changed * fix(geometry): unify cross-frame coordinates and screenshot conversion | 统一跨 frame 坐标与截图转换 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/195 * refactor(observation): decouple DOM processing from capture orchestration | 解耦 DOM 处理与采集流程 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/198 * refactor(observation): unify cross-frame capture coordination and data ownership | 统一跨 frame 采集协调与数据归属 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/200 …在 GitHub 查看 ↗ -
cli-v0.3.2 bsk CLI 0.3.2
发布说明摘录
What's Changed * fix(geometry): unify cross-frame coordinates and screenshot conversion | 统一跨 frame 坐标与截图转换 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/195 * refactor(observation): decouple DOM processing from capture orchestration | 解耦 DOM 处理与采集流程 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/198 * refactor(observation): unify cross-frame capture coordination and data ownership | 统一跨 frame 采集协调与数据归属 by @Ljy-0827 in https://github.com/Tencent/BrowserSkill/pull/200 …在 GitHub 查看 ↗