跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI大前端

agent-browser:Vercel 开源的 AI 智能体浏览器自动化 CLI 工具

agent-browser 是 Vercel Labs 推出的 AI 智能体专用浏览器自动化 CLI 工具。采用 Rust+Node.js 混合架构,支持跨平台部署。核心功能包括网页导航、元素操作、数据提取等,提供 AI 友好的元素引用机制和多种定位方式。支持本地运行、CDP 协议连接及云浏览器服务集成。通过 npm 或源码编译安装,可无缝集成至各类 AI 智能体系统,降低开发成本。

极客零度发布于 2026/4/6更新于 2026/7/2548 浏览
agent-browser:Vercel 开源的 AI 智能体浏览器自动化 CLI 工具

引言

在 AI 智能体落地过程中,浏览器自动化是连接虚拟智能与现实网页服务的关键桥梁,而传统浏览器自动化工具往往存在配置复杂、AI 适配性差、跨环境部署困难等问题。Vercel Labs 开源的 agent-browser 完美解决了这些痛点,作为一款专为 AI 智能体设计的无头浏览器自动化 CLI 工具,它采用 Rust+Node.js 混合架构,兼顾速度与兼容性,提供了简洁直观的命令集和 AI 友好的交互方式,成为 AI 智能体实现网页操作的首选工具。本文将从项目概况、核心优势与应用、技术原理与部署实践三方面,全面解析这款工具的使用价值与实操方法。

项目概况

agent-browser 是 Vercel Labs 推出的AI 智能体专用浏览器自动化 CLI 工具,基于 Apache-2.0 开源协议,目前在 GitHub 收获 11.8k stars、656 forks,已迭代 13 个版本,最新稳定版为 v0.8.5。该工具专为 AI 智能体设计,核心定位是提供简单、高效、AI 友好的浏览器自动化能力,支持网页导航、元素操作、数据提取、截图录屏、网络拦截等全流程浏览器操作,可无缝集成到各类 AI 智能体系统中。

工具采用创新的'Rust CLI+Node.js 守护进程'架构,Rust 实现的原生二进制文件保证了极致性能,Node.js 作为 fallback 确保跨平台兼容性,支持 macOS、Linux、Windows 等主流操作系统,默认使用 Chromium 浏览器引擎,同时兼容 Firefox、WebKit。核心亮点包括 AI 友好的元素引用(ref)机制、语义化定位器、多会话隔离、持久化配置、CDP 协议支持等,还可集成 Browserbase、Browser Use、Kernel 等云浏览器服务,解决无本地浏览器环境的部署难题。

agent-browser 提供了 npm、源码编译两种安装方式,支持命令行直接调用,无需复杂的代码封装,AI 智能体可通过简单指令即可完成复杂的浏览器操作,大幅降低 AI 与浏览器交互的开发成本。

核心优势与应用场景

核心技术优势
  1. AI 友好设计,无缝适配智能体:创新推出快照(snapshot)+ 元素引用(ref)机制,快照生成包含元素引用的可访问性树,AI 可直接通过@e1、@e2 等确定性引用操作元素,无需复杂的 DOM 查询,配合–json 参数可输出机器可读格式,完美适配 AI 智能体的交互逻辑。
  2. 高性能跨平台架构:核心 CLI 采用 Rust 开发,启动速度快、执行效率高,同时提供 Node.js fallback 方案,兼容无 Rust 环境的运行场景,支持 macOS、Linux、Windows 全平台,Linux 系统还提供一键依赖安装脚本。
  3. 丰富的命令集,覆盖全场景需求:提供核心操作、数据获取、元素查找、等待机制、鼠标控制、浏览器设置、网络拦截、会话管理等 8 大类命令,支持点击、输入、文件上传、截图、PDF 导出、Cookie 管理等全流程浏览器操作,满足各类自动化需求。
  4. 灵活的元素定位方式:支持 AI 友好的 ref 引用、传统 CSS 选择器、文本/XPath 定位、语义化定位(按角色、标签、占位符等),可根据 AI 智能体的识别能力灵活选择,降低元素定位的复杂度。
  5. 多环境部署适配:支持本地浏览器运行、CDP 协议连接现有浏览器、云浏览器服务集成三种部署模式,可适配本地开发、服务器部署、Serverless 等多种场景,解决无本地浏览器环境的部署痛点。
  6. 会话与配置隔离:支持多会话并行运行,每个会话拥有独立的浏览器实例、Cookie 和存储;提供持久化配置文件,可保存认证状态、浏览器设置等,避免重复配置,提升自动化流程的连贯性。
典型应用场景
  1. AI 智能体网页交互:作为 AI 智能体的浏览器操作插件,实现网页信息爬取、表单自动填写、在线工具调用、网页功能测试等,例如让 AI 智能体自动完成登录、数据查询、报告生成等流程。
  2. 自动化测试与 CI/CD 集成:在开发流程中集成自动化测试,通过命令行批量执行网页功能测试、UI 回归测试,支持无头模式运行,可无缝接入 CI/CD 流水线,提升测试效率。
  3. 网页数据采集与分析:针对需要动态渲染的网页,通过浏览器自动化模拟人工操作,获取渲染后的页面数据,支持文本提取、HTML 获取、截图验证等,适用于舆情监控、数据统计等场景。
  4. Serverless 环境浏览器操作:集成云浏览器服务后,可在 Vercel、AWS Lambda 等 Serverless 环境中实现浏览器自动化,无需担心本地浏览器依赖,适用于无服务器架构的 AI 应用。
  5. 跨浏览器兼容性测试:支持 Chromium、Firefox、WebKit 多种浏览器引擎,可快速切换浏览器进行兼容性测试,验证网页在不同浏览器中的表现。
  6. 智能办公自动化:配合 AI 智能体实现办公流程自动化,例如自动登录办公系统、下载报表、填写表单、生成 PDF 文件等,减少重复办公操作。

技术原理与部署实践

核心技术原理与架构

agent-browser 采用客户端 - 守护进程的架构设计,核心分为三层,各模块协同工作确保高效稳定的浏览器自动化能力:

  1. CLI 客户端层:Rust 开发的命令行客户端,负责解析用户指令、参数校验、与守护进程通信,提供快速的指令处理能力,支持丰富的命令参数和选项配置;
  2. 守护进程层:Node.js 实现的后台守护进程,负责管理 Playwright 浏览器实例,处理 CLI 客户端的指令请求,实现浏览器的创建、操作、关闭等生命周期管理,守护进程会自动启动并持久化,提升后续指令的执行速度;
  3. 浏览器引擎层:默认使用 Chromium 浏览器引擎,通过 Playwright 协议实现浏览器控制,同时支持 Firefox、WebKit 引擎,还可通过 CDP 协议连接外部浏览器或云浏览器服务,扩展运行环境适配能力。

核心工作流程为:CLI 客户端接收用户指令→通过进程间通信将指令发送给 Node.js 守护进程→守护进程通过 Playwright 协议控制浏览器执行对应操作→将执行结果返回给 CLI 客户端并输出。

环境搭建与安装

agent-browser 支持 npm 安装(推荐)和源码编译两种方式,以下是详细安装步骤:

1.npm 安装(推荐,适用于大多数用户)
# 全局安装 agent-browser
npm install -g agent-browser
# 下载 Chromium 浏览器(首次使用需执行)
agent-browser install
# Linux 系统一键安装依赖(可选)
agent-browser install --with-deps 
2.源码编译安装(适用于开发或需最新功能的场景)
# 克隆仓库
git clone https://github.com/vercel-labs/agent-browser
cd agent-browser
# 安装依赖(需先安装 pnpm)
pnpm install
# 编译项目
pnpm build
# 编译 Rust 原生 CLI(需安装 Rust 环境:https://rustup.rs)
pnpm build:native
# 全局链接
pnpm link --global
# 下载 Chromium 浏览器
agent-browser install
快速上手:核心命令实践

agent-browser 支持直接通过命令行执行浏览器操作,以下是常见场景的完整命令示例:

1.基础网页操作流程(登录表单填写)
# 1. 打开目标网页
agent-browser open https://example.com/login
# 2. 生成快照,获取元素引用(AI 智能体可解析快照中的 ref)
agent-browser snapshot --json
# 3. 通过 ref 填写用户名和密码(假设快照中用户名输入框为@e3,密码框为@e4,登录按钮为@e2)
agent-browser fill @e3 "[email protected]"
agent-browser fill @e4 "password123"
# 4. 点击登录按钮
agent-browser click @e2
# 5. 等待页面跳转(等待 URL 包含/dashboard)
agent-browser wait --url "**/dashboard"
# 6. 获取页面标题并截图
agent-browser get title
agent-browser screenshot dashboard.png --full
# 7. 关闭浏览器
agent-browser close
2.传统选择器操作示例
# 打开网页
agent-browser open https://example.com/register
# 按 CSS 选择器填写表单
agent-browser fill "#email" "[email protected]"
agent-browser fill "#password" "password123"
# 按语义化定位选择下拉框选项
agent-browser find role select fill --name "Country" "China"
# 按文本定位并点击注册按钮
agent-browser find text "Register" click
# 等待成功提示文本出现
agent-browser wait --text "Registration successful"
# 导出页面为 PDF
agent-browser pdf registration_success.pdf
3.云浏览器服务集成(Browserbase 示例)
# 配置环境变量(替换为实际的 API 密钥和项目 ID)
export BROWSERBASE_API_KEY="your-api-key"
export BROWSERBASE_PROJECT_ID="your-project-id"
# 使用云浏览器打开网页
agent-browser -p browserbase open https://example.com
# 执行操作(命令与本地浏览器一致)
agent-browser snapshot --json
agent-browser get text @e1
4.CDP 协议连接现有浏览器
# 1. 启动本地 Chrome 并开启远程调试(命令行执行)
google-chrome --remote-debugging-port=9222
# 2. agent-browser 通过 CDP 连接
agent-browser --cdp 9222 open https://example.com
# 3. 执行操作
agent-browser click "#submit"
关键配置与注意事项
  1. 调试模式:添加–headed 参数可显示浏览器窗口,方便调试操作流程;–debug 参数可输出详细日志,排查执行问题。
  2. HTTPS 错误忽略:对于自签名证书的网页,添加–ignore-https-errors 参数可忽略 HTTPS 证书错误。

会话管理:使用–session 参数创建独立会话,支持多会话并行执行,例如:

agent-browser --session session1 open https://example.com
agent-browser --session session2 open https://test.com

持久化配置:使用–profile 参数指定配置目录,可持久化保存 Cookie、登录状态等,避免重复登录,例如:

agent-browser --profile ~/.my-profile open https://example.com

目录

  1. 引言
  2. 项目概况
  3. 核心优势与应用场景
  4. 核心技术优势
  5. 典型应用场景
  6. 技术原理与部署实践
  7. 核心技术原理与架构
  8. 环境搭建与安装
  9. 1.npm 安装(推荐,适用于大多数用户)
  10. 全局安装 agent-browser
  11. 下载 Chromium 浏览器(首次使用需执行)
  12. Linux 系统一键安装依赖(可选)
  13. 2.源码编译安装(适用于开发或需最新功能的场景)
  14. 克隆仓库
  15. 安装依赖(需先安装 pnpm)
  16. 编译项目
  17. 编译 Rust 原生 CLI(需安装 Rust 环境:https://rustup.rs)
  18. 全局链接
  19. 下载 Chromium 浏览器
  20. 快速上手:核心命令实践
  21. 1.基础网页操作流程(登录表单填写)
  22. 1. 打开目标网页
  23. 2. 生成快照,获取元素引用(AI 智能体可解析快照中的 ref)
  24. 3. 通过 ref 填写用户名和密码(假设快照中用户名输入框为@e3,密码框为@e4,登录按钮为@e2)
  25. 4. 点击登录按钮
  26. 5. 等待页面跳转(等待 URL 包含/dashboard)
  27. 6. 获取页面标题并截图
  28. 7. 关闭浏览器
  29. 2.传统选择器操作示例
  30. 打开网页
  31. 按 CSS 选择器填写表单
  32. 按语义化定位选择下拉框选项
  33. 按文本定位并点击注册按钮
  34. 等待成功提示文本出现
  35. 导出页面为 PDF
  36. 3.云浏览器服务集成(Browserbase 示例)
  37. 配置环境变量(替换为实际的 API 密钥和项目 ID)
  38. 使用云浏览器打开网页
  39. 执行操作(命令与本地浏览器一致)
  40. 4.CDP 协议连接现有浏览器
  41. 1. 启动本地 Chrome 并开启远程调试(命令行执行)
  42. 2. agent-browser 通过 CDP 连接
  43. 3. 执行操作
  44. 关键配置与注意事项
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • MySQL Workbench 导入 SQL 文件操作指南
  • VSCode 本地部署 DeepSeek 模型实现私有化 AI 编码辅助
  • 基于 AI 分类器与飞书机器人的智能工单系统搭建
  • 《人工智能的底层逻辑》:清华大学 AI 通识经典
  • 基于 LangChain 的 RAG 与对话记忆实现
  • Lychee多模态重排序模型:AR场景下3D模型与操作指南匹配
  • DeepSeek-R1-Distill-Llama-8B 模型 Ollama 部署及 HTTP API 鉴权配置
  • Linux 进程信号处理机制与操作系统运行原理解析
  • 半小时搭建 AI 量化系统:微软开源三件套实测
  • Ubuntu 下 VLC 启动崩溃(Segmentation fault)修复方案
  • SLAM Toolbox 机器人定位与建图实践
  • 开源 C2 框架 AdaptixC2 安装与使用指南
  • Whisper-CTranslate2 高效语音识别与 AI 翻译工具
  • GitHub Copilot 学生身份认证与免费开通教程
  • AI 产品经理面试 20 道高频问题及解题技巧与注意事项
  • OpenClaw 浏览器控制:保留登录状态与自动连接方案
  • 基于 Coze 与 OpenClaw 搭建飞书机器人群组
  • GitHub Copilot 学生身份认证与激活指南
  • FPGA 调试:PCIE XDMA 无 Link Up 使用 LTSSM 定位问题
  • 使用 Trae IDE 配合 MCP Server - Figma AI Bridge 生成前端代码

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online