用途
browser-use 提供命令行形式的浏览器自动化能力,并会在多条命令之间保持浏览器会话,因此适合需要多步连续操作的网页流程。其典型用途包括网页测试、表单填写、截图和数据提取。按资料描述,当用户需要导航网站或与网页交互时可以使用该工具。
主要能力
浏览器模式
chromium:默认使用无头 Chromium;加上--headed可显示窗口。real:使用真实 Chrome 二进制。不加--profile时使用位于~/.config/browseruse/profiles/cli/的持久但空的 CLI 配置;加--profile "ProfileName"可复制实际 Chrome 配置(含 Cookie、登录状态、扩展)。remote:云端托管浏览器,支持代理。
页面操作
- 导航:
open <url>、back、scroll down/up(可用--amount指定像素)。 - 获取状态:
state返回 URL、标题与可点击元素索引;screenshot可输出 base64 或保存到文件,--full为整页截图。 - 交互:
click、type、input、keys、select、hover、dblclick、rightclick,均使用state给出的索引。 - 标签页:
switch、close-tab。
数据提取
eval执行 JavaScript 并返回结果。get title、get html(支持--selector)、get text、get value、get attributes、get bbox。
等待条件
wait selector 可等待元素可见、隐藏或挂载(--state),可用 --timeout 设置超时;wait text 等待文本出现。
Cookie 管理
获取、设置、清除、导出、导入 Cookie,设置时支持 domain、secure、http-only、same-site、expires 等参数。
Python 执行
Python 会话跨命令保持状态,可访问 browser 对象(url、title、html、goto、back、click、type、input、keys、screenshot、scroll、wait、extract 等)。支持 --vars、--reset、--file。
远程 AI 代理任务
browser-use -b remote run "task" 在云端运行代理任务,默认异步。可指定 --llm、--proxy-country、--keep-alive、--session-id、--flash、--wait、--thinking、--no-vision、--start-url、--allowed-domain、--metadata、--skill-id、--secret,以及结构化输出 --structured-output 与评审模式 --judge 等。任务可通过 task list/status/stop/logs 管理,状态可查全部步骤、推理、URL 与动作。
云会话与隧道
- 云会话:
session list/get/stop/create/share,创建时可指定 profile、代理地区、起始 URL、屏幕尺寸、--keep-alive、--persist-memory。 - 隧道:
tunnel <port>将本地端口暴露为 URL(幂等),tunnel list/stop管理;隧道独立于浏览器会话,关闭浏览器后仍可保留。
配置同步
profile list/cookies 查看本地 Chrome 配置;云端配置支持 list/get/create/update/delete。profile sync --from 可同步 Cookie,可按 --domain 限定域名,也可全量同步(资料提示全量同步包含敏感数据,应谨慎)。
使用方式
先确认已安装并配置,运行 browser-use doctor 诊断。核心工作流为:open 打开页面 → state 获取元素索引 → 使用索引 click/input 等交互 → 用 state 或 screenshot 验证 → 重复操作;浏览器在命令间保持打开。会话可用 sessions 列出、close 关闭当前、close --all 关闭全部。
适用场景
网页测试、表单填写、截图、数据提取、需要登录状态浏览站点、在云端运行浏览器代理任务、把本地开发服务器通过隧道暴露给云浏览器访问等。
限制与注意事项
使用前需安装并配置,可用 doctor 检查;隧道依赖 cloudflared 安装。使用需登录的站点前,应先询问用户选择 real 还是 remote、列出可用配置并确认使用哪个;云端配置 Cookie 可能过期;同步 Cookie 前须确认来源配置与域名,不建议默认全量同步。远程任务默认异步执行。资料未提供具体收费、价格或效果数据。