BrowserSkill：让AI智能体操控你的真实浏览器

这是什么

BrowserSkill 是腾讯开源的一个浏览器自动化工具，它让 AI 智能体（如 Cursor、Claude Code、Codex 等）能够直接操控你电脑上已登录的 Chrome 或 Edge 浏览器。它由 CLI 工具、浏览器扩展和技能文件组成，AI 智能体通过 bsk 命令与浏览器交互，完成网页读取、表单填写、截图、调试等任务。

与传统的浏览器自动化工具不同，BrowserSkill 强调“使用你真实的、已登录的浏览器”，这意味着 AI 可以访问你已登录的网站（如内部系统、个人账户），无需重复登录，同时任务在独立的“Agent Window”中运行，不会干扰你当前的工作。

适合谁

内容创作者：需要从多个网页收集资料、截图或填写表单。
开发者：需要调试网站问题，查看请求、响应和控制台日志。
效率办公人群：希望用 AI 自动完成重复的网页操作，如数据录入、信息查询。
一人公司创业者：需要自动化处理日常网页任务，节省时间。

能做什么

使用现有账户：利用浏览器当前的登录状态，读取文档、搜索内部网站、填写表单、完成网页工作流。
保持任务可见：为 AI 提供独立的窗口，必要时借用现有标签页，并可在登录、验证等需要人工参与的步骤时接管。
读取、交互和捕获：检查页面文本和控件，点击和输入，管理标签页，捕获视口或整页截图，在本地模式下上传或下载文件。
网站调试：将操作与请求、响应体、控制台消息和页面变化关联起来，检查性能、慢 API 和疑似重复请求，使用显式 HTTP 规则或请求重放来测试假设。
选择浏览器：命名浏览器实例，将任务绑定到特定配置文件，或将服务器上的智能体与电脑上的浏览器配对。
审查操作：重新打开浏览器本地的调试历史，导出 JSON 证据，或启用单独的操作审计来审查任务活动。

使用前准备

安装 Chrome 或 Microsoft Edge 浏览器（基于 Chromium 125 或更高版本）。
准备一个支持 shell 命令的 AI 智能体，如 Cursor、Claude Code、Codex、OpenClaw、CodeBuddy、WorkBuddy、Pi、Hermes Agent 等。
对于 DeepSeek Harness 用户，需要安装专门的 DSH 插件。

安装方法

最简单的方式是让 AI 智能体自动安装，发送以下指令给你的智能体：

Set up browser-skill on this machine by following https://raw.githubusercontent.com/Tencent/BrowserSkill/main/AGENT_INSTALL.md

或者手动安装：

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

验证安装：

bsk --version

2. 连接浏览器扩展

从 Chrome Web Store 或 Edge Add-ons 安装扩展，打开弹窗，启用本地连接。

3. 为智能体安装技能

bsk install-skill

选择你的智能体平台，或指定：

bsk install-skill --harness cursor --json

4. 检查连接

bsk doctor

确保扩展显示“Connected”。

使用示例

连接成功后，向智能体发送指令：

Use browser-skill to open https://example.com, summarize the page, and end the browser session when finished.

智能体将打开一个 Agent Window，读取页面，返回摘要，然后结束任务。

也可以直接使用 CLI：

bsk session start --no-focus --json
bsk navigate https://example.com --session 
bsk observe --session 
bsk screenshot --session  --out example.png
bsk session stop

风险与注意事项

隐私风险：Agent Window 共享所选配置文件的登录状态，它不是独立的账户或安全沙箱。智能体可以以已登录网站的权限进行操作，因此请选择你信任的任务和智能体。
数据泄露：捕获和编辑功能有限，保留的证据可能仍包含敏感信息。请谨慎处理。
请求重放风险：请求重放会使用页面当前的会话发送新请求，可能改变服务器数据。
兼容性：其他 Chromium 浏览器可能可以工作，但不保证兼容。
远程模式限制：远程模式目前不支持文件上传或下载。