mcpField
R
remote-browser

remote-browser

github.com/browser-useAgent 工作流119.4k4.8k 次安装2 天前更新
代码仓库

关于 remote-browser

供本地没有可用 Chrome 的 Agent 使用的隔离远程浏览器技能,通过 Browser Use CLI 启动、操作和停止指定的云端浏览器。

主要功能

  1. 01启动和停止指定远程浏览器
  2. 02浏览并检查网页
  3. 03与页面元素交互
  4. 04管理标签页并截取屏幕

适用场景

  1. 01在没有本地 Chrome 的机器上执行浏览器任务
  2. 02为并行任务使用独立浏览器会话
  3. 03通过 DOM 检查或截图验证页面操作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/browser-use/browser-use --skill remote-browser

安装后在 Claude Code 中输入/remote-browser确认已加载。

详细介绍

远程浏览器

当 Agent 运行在没有可用本地 Chrome 的机器上,且需要一个隔离的浏览器时,请使用此技能。当前的 Browser Use CLI 从标准输入运行 Python。不要使用已移除的 open、state、click、input、tab、cloud connect 或 --connect 命令。

检查 CLI

browser-use --doctor
browser-use skill show

如果设置失败,请参阅当前的 Browser Use 技能。

启动隔离的浏览器

认证一次:

browser-use auth login

选择一个简短且唯一的名称。下面的 r7k2 仅为示例。

browser-use <<'PY'
start_remote_daemon("r7k2")
PY

在此浏览器的每条命令中使用相同的名称:

BU_NAME=r7k2 browser-use <<'PY'
new_tab("https://example.com")
wait_for_load()
print(page_info())
PY

每个远程守护进程都是一个独立的 Browser Use Cloud 浏览器。每个并行任务使用不同的名称。远程浏览器在停止或超时之前可能会持续计费。

检查和交互

辅助函数已预先导入。条件允许时,请将多步操作放在同一个 heredoc 中。

BU_NAME=r7k2 browser-use <<'PY'
print(page_info())
print(js("document.title"))

fill_input('input[name="q"]', "browser automation")
press_key("Enter")
wait_for_load()

print(page_info())
PY

常用辅助函数:

  • 导航:new_tab(url)、goto_url(url)、wait_for_load()
  • 检查:page_info()、js(code)、cdp(method, ...)
  • 交互:click_at_xy(x, y)、type_text(text)、fill_input(selector, text)、press_key(key)、scroll(x, y)
  • 标签页:list_tabs()、switch_tab(target)、close_tab(target)
  • 文件和取证:capture_screenshot()、wait_for_element(selector)

优先使用无障碍树查找元素:

nodes = cdp("Accessibility.getFullAXTree")["nodes"]

如果无障碍树中没有所需元素,请使用针对性的 js(...) 查询。使用 page_info()、有针对性的 DOM 检查或屏幕截图验证每项操作。

停止浏览器

工作完成后,停止名称完全匹配的浏览器:

browser-use <<'PY'
stop_remote_daemon("r7k2")
PY

不要让未使用的远程浏览器继续运行。

评论

支持 Markdown