BrowserSkill

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 718 🐛 待处理 127 👀 关注 25
GitHub ↗
GitHub 星标 ★ 9983
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无官网定价信息

项目预览

BrowserSkill 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队Tencent
定价模式🏷️完全免费
价格说明开源免费,无官网定价信息
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型agent,browser-use,dsh-plugin
GitHub 星标★ 9983
上线时间2026-06-22 00:00:00
代码更新2026-11-04
仓库体积15.3 MB
本站数据更新2026-11-04
维护状态活跃
收录时间2026-09-12
浏览次数4

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 9983

使用教程

难度:入门 约 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. 1安装 bsk CLI

    macOS 与 Linux 用户执行该脚本,默认安装到 ~/.local/bin,安装后确认该目录在 PATH 中。

    curl -fsSL https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.sh | sh
  2. 2Windows 安装 CLI

    仅 Windows 用户执行,通过 PowerShell 安装到 ~/.local/bin;macOS/Linux 用户跳过此步。

    irm https://raw.githubusercontent.com/Tencent/BrowserSkill/main/install.ps1 | iex
  3. 3验证 CLI

    运行版本命令,能打印出版本号说明 bsk 已正确安装并可用。

    bsk --version
  4. 4安装浏览器扩展

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

  5. 5安装 Agent Skill

    运行后按空格选择要安装的 Agent 宿主,回车确认;用 --list 可查看内部变体和安装路径。

    bsk install-skill
  6. 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

★ 3889 2026-08-09
OpenReels 开源

一句话生成多平台短视频,从选题到成片全自动

Open-source AI pipeline that turns any topic into a publish-ready YouTube/Instagram/···

★ 232 2026-08-09
browser-control 开源

让 AI 代理用 Rust 快速操控真实浏览器

A tiny, fast Rust CLI that drives a real browser over the Chrome DevTools Protocol —···

★ 3156 2026-08-09
YuYuWechat 开源

定时发消息、批量群发,微信自动化小助手

一个让微信(非WEB版)定时循环发送消息/文件(cron表达式精确到分钟),批量群发消息,定···

★ 895 2026-08-09
fauxnix 开源

Windows 上直接跑 Linux 风格命令,无需 WSL

Run Linux-style commands on Windows via deterministic bash→PowerShell translation. ···

★ 898 2026-11-02
mobilewright 开源

一套 API 搞定 iOS/Android 真机与模拟器自动化测试

Mobilewright is a dev framework for Mobile App Testing and Automation. It allows tes···

★ 462 2026-08-09
banco 开源

在终端里管项目,告别切来切去的 GUI

:file_folder: A project management tool for the command line

★ 58 2026-08-09
kameleo 开源

引擎级指纹伪装,让爬虫自动化不再被封

Anti-detect browser for web scraping and automation. Engine-level fingerprint maskin···

★ 214 2026-10-08
Charge-Grinder 开源

自动刷《Limbus Company》镜像地牢,解放双手

Bot for Limbus Company to grind mirror dungeon so you don't have to (no OCR required···

★ 260 2026-09-19