| name | browser-use-zh-remote-browser |
| description | 从沙箱远程机器控制本地浏览器。当代理在沙箱中运行(无 GUI)时,需要导航网站、与网页交互、填写表单、截图或通过隧道暴露本地开发服务器时使用。 |
| allowed-tools | Bash(browser-use:*) |
沙箱代理的浏览器自动化
此技能适用于在沙箱远程机器(云虚拟机、CI、编码代理)上运行的代理,这些代理需要控制无头浏览器。
前置条件
browser-use doctor
安装详情请参见 https://github.com/browser-use/browser-use/blob/main/browser_use/skill_cli/README.md
核心工作流程
- 导航:
browser-use open <url> — 如需要则启动无头浏览器
- 检查:
browser-use state — 返回可点击元素及其索引
- 交互: 使用 state 返回的索引(
browser-use click 5、browser-use input 3 "text")
- 验证:
browser-use state 或 browser-use screenshot 确认结果
- 重复: 浏览器在命令之间保持打开
- 清理: 完成后使用
browser-use close
浏览器模式
browser-use open <url>
browser-use cloud connect
browser-use --connect open <url>
browser-use --cdp-url ws://localhost:9222/... open <url>
命令
browser-use open <url>
browser-use back
browser-use scroll down
browser-use scroll up
browser-use switch <tab>
browser-use close-tab [tab]
browser-use state
browser-use screenshot [path.png]
browser-use click <index>
browser-use click <x> <y>
browser-use type "text"
browser-use input <index> "text"
browser-use keys "Enter"
browser-use select <index> "option"
browser-use upload <index> <path>
browser-use hover <index>
browser-use dblclick <index>
browser-use rightclick <index>
browser-use eval "js code"
browser-use get title
browser-use get html [--selector "h1"]
browser-use get text <index>
browser-use get value <index>
browser-use get attributes <index>
browser-use get bbox <index>
browser-use wait selector "css"
browser-use wait text "text"
browser-use cookies get [--url <url>]
browser-use cookies set <name> <value>
browser-use cookies clear [--url <url>]
browser-use cookies export <file>
browser-use cookies import <file>
browser-use python "code"
browser-use python --file script.py
browser-use python --vars
browser-use python --reset
browser-use close
browser-use sessions
browser-use close --all
Python 的 browser 对象提供:browser.url、browser.title、browser.html、browser.goto(url)、browser.back()、browser.click(index)、browser.type(text)、browser.input(index, text)、browser.keys(keys)、browser.upload(index, path)、browser.screenshot(path)、browser.scroll(direction, amount)、browser.wait(seconds)。
隧道
通过 Cloudflare 隧道将本地开发服务器暴露给浏览器。
browser-use tunnel <port>
browser-use tunnel list
browser-use tunnel stop <port>
browser-use tunnel stop --all
命令链接
命令可以使用 && 链接。浏览器通过守护进程持久存在,因此链接是安全高效的。
browser-use open https://example.com && browser-use state
browser-use input 5 "user@example.com" && browser-use input 6 "password" && browser-use click 7
当不需要中间输出时可以链接命令。当需要解析 state 来发现索引时,应分别运行。
常见工作流程
暴露本地开发服务器
python -m http.server 3000 &
browser-use tunnel 3000
browser-use open https://abc.trycloudflare.com
隧道独立于浏览器会话,在 browser-use close 后仍然存在。
全局选项
| 选项 | 说明 |
|---|
--headed | 显示浏览器窗口 |
--connect | 通过 CDP 自动发现运行中的 Chrome |
--cdp-url <url> | 通过 CDP URL 连接(http:// 或 ws://) |
--session NAME | 指定命名会话(默认:"default") |
--json | 输出为 JSON 格式 |
提示
- 始终先运行
state 以查看可用元素及其索引
- 会话持久存在 — 浏览器在命令之间保持打开,直到你关闭它
- 隧道独立存在 — 在
browser-use close 后仍然保留
tunnel 是幂等的 — 对同一端口再次调用会返回已有的 URL
故障排除
- 浏览器无法启动? 先
browser-use close 再重试。运行 browser-use doctor 检查。
- 找不到元素? 先
browser-use scroll down 再 browser-use state
- 隧道不工作? 用
which cloudflared 检查,用 browser-use tunnel list 查看活跃隧道
清理
browser-use close
browser-use tunnel stop --all