SuperAPI AI 工具集

browser-use

测试与质量

查看项目

更新于 11-02 01:29

技能介绍

用途

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 前须确认来源配置与域名,不建议默认全量同步。远程任务默认异步执行。资料未提供具体收费、价格或效果数据。