
BrowserSkill
让 AI 直接操作你已登录的真实浏览器,不打断当前工作
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 9983
技术标签
使用教程
环境要求
- 操作系统: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
上一篇:cli
下一篇:tokenjuice
同类项目推荐
tracecat
开源
拖拽搭建安全自动化流程,让 AI 代理帮你处理告警和响应。
Open-source security automation platform for teams and AI agents
OpenReels
开源
一句话生成多平台短视频,从选题到成片全自动
Open-source AI pipeline that turns any topic into a publish-ready YouTube/Instagram/···
browser-control
开源
让 AI 代理用 Rust 快速操控真实浏览器
A tiny, fast Rust CLI that drives a real browser over the Chrome DevTools Protocol —···
YuYuWechat
开源
定时发消息、批量群发,微信自动化小助手
一个让微信(非WEB版)定时循环发送消息/文件(cron表达式精确到分钟),批量群发消息,定···
fauxnix
开源
Windows 上直接跑 Linux 风格命令,无需 WSL
Run Linux-style commands on Windows via deterministic bash→PowerShell translation. ···
mobilewright
开源
一套 API 搞定 iOS/Android 真机与模拟器自动化测试
Mobilewright is a dev framework for Mobile App Testing and Automation. It allows tes···
banco
开源
在终端里管项目,告别切来切去的 GUI
:file_folder: A project management tool for the command line
kameleo
开源
引擎级指纹伪装,让爬虫自动化不再被封
Anti-detect browser for web scraping and automation. Engine-level fingerprint maskin···
Charge-Grinder
开源
自动刷《Limbus Company》镜像地牢,解放双手
Bot for Limbus Company to grind mirror dungeon so you don't have to (no OCR required···