Repolode
keon

keon/browser-control

一个基于 Chrome DevTools Protocol 驱动真实浏览器的小型 Rust 命令行工具,专为编码智能体设计。

Star
3,152
Fork
210
未关闭 Issue
1
最近提交
2个月前

这是什么?

browser-control 是一个用 Rust 编写的命令行工具,把浏览器封装成一组可在 shell 中调用的子命令。它可以启动本地 Chrome 或连接已有的 CDP 端点,通过 snapshot 为页面元素生成稳定引用(如 @e1、@e2),随后直接对这些引用执行点击、填写、输入、滚动或上传等操作。CSS 选择器和 x,y 坐标同样可用作目标。

该工具面向已经能运行 shell 命令的编码智能体。高层命令无法表达的操作,可以通过 eval 和 cdp 命令直接发送原始 CDP 请求。后台守护进程会在内存中保留事件、网络请求和控制台消息,命令失败时会在工作区目录下写入精简的追踪文件,便于排查问题。

除本地 Chrome 外,它还可以在 Browser Use、Steel、Hyperbrowser、Browserbase 上创建和停止远程会话,也可通过环境变量接入其他兼容 CDP 的云服务。安装方式包括 cargo install、预编译二进制和源码编译。

核心功能

  • 01snapshot 返回稳定的元素引用,可直接用于点击、填写等操作。
  • 02每项能力都是 shell 子命令,输出紧凑的文本或 JSON。
  • 03通过 eval 和 cdp 命令可直接发送原始 CDP 请求,覆盖封装之外的操作。
  • 04后台守护进程保留最近的事件、网络请求和控制台消息。
  • 05命令失败时会在工作区目录下写入诊断追踪文件。
  • 06本地 Chrome 与云端浏览器服务使用相同的命令。

适用场景

  • 让编码智能体通过 shell 检查网页并与之交互。
  • 在 shell 管道中编写登录、填表等可重复执行的浏览器步骤。
  • 从命令行在 Browser Use、Steel 等云端浏览器上运行会话。
  • 通过查看保存的失败追踪文件排查浏览器自动化流程的问题。

快速上手

  1. 1

    从 crates.io 安装命令行工具

    cargo install browser-control-cli
  2. 2

    创建工作区并启动 Chrome 打开示例页面

    browser-control init && browser-control launch https://example.com
  3. 3

    获取页面快照以列出可操作元素引用

    browser-control snapshot

使用前须知

  • 需要本地安装 Chrome 或 Chromium,或使用付费云服务的 API 密钥来连接远程会话。
  • crate 名称为 browser-control-cli,因为较短的名称已被占用。

收录于专题

标签

常见问题

browser-control 是什么?
一个基于 Chrome DevTools Protocol 驱动真实浏览器的小型 Rust 命令行工具,专为编码智能体设计。 browser-control 是一个用 Rust 编写的命令行工具,把浏览器封装成一组可在 shell 中调用的子命令。它可以启动本地 Chrome 或连接已有的 CDP 端点,通过 snapshot 为页面元素生成稳定引用(如 @e1、@e2),随后直接对这些引用执行点击、填写、输入、滚动或上传等操作。CSS 选择器和 x,y 坐标同样可用作目标。
browser-control 可以免费使用吗?用的什么许可证?
browser-control 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
browser-control 还在维护吗?
半年内有更新。browser-control 最近一次提交是在 2026年8月27日。
browser-control 适合用来做什么?
让编码智能体通过 shell 检查网页并与之交互。 在 shell 管道中编写登录、填表等可重复执行的浏览器步骤。 从命令行在 Browser Use、Steel 等云端浏览器上运行会话。 通过查看保存的失败追踪文件排查浏览器自动化流程的问题。
browser-control 怎么安装和运行?
从 crates.io 安装命令行工具: cargo install browser-control-cli 创建工作区并启动 Chrome 打开示例页面: browser-control init && browser-control launch https://example.com 获取页面快照以列出可操作元素引用: browser-control snapshot
在哪里获取 browser-control?
源代码和安装说明在 GitHub 上:https://github.com/keon/browser-control

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目