browser 命令

浏览器控制 CLI，用于自动化浏览器操作。

用法

moltbot browser <subcommand> [选项]

子命令

管理命令

子命令	描述
status	查看浏览器状态
start	启动浏览器
stop	停止浏览器
reset-profile	重置浏览器配置
tabs	列出打开的标签页
open <url>	打开 URL
focus <targetId>	聚焦标签页
close [targetId]	关闭标签页

配置文件管理

子命令	描述
profiles	列出所有配置
create-profile --name <name>	创建新配置
delete-profile --name <name>	删除配置

检查命令

子命令	描述
screenshot [targetId]	截图
snapshot	获取页面快照
console	获取控制台日志
pdf	生成 PDF

操作命令

子命令	描述
navigate <url>	导航到 URL
resize <width> <height>	调整窗口大小
click <ref>	点击元素
type <ref> <text>	输入文本
press <key>	按键
hover <ref>	悬停
drag <startRef> <endRef>	拖拽
select <ref> <values...>	选择下拉选项
upload <paths...>	上传文件
fill	填充表单
dialog --accept|--dismiss	处理对话框
wait	等待条件
evaluate --fn <code>	执行 JavaScript

选项

选项	描述
--browser-profile <name>	使用指定配置
--target-id <id>	指定目标标签页
--json	JSON 格式输出

示例

基本使用

# 启动浏览器
moltbot browser start

# 打开网页
moltbot browser open https://example.com

# 截图
moltbot browser screenshot

# 停止浏览器
moltbot browser stop

页面交互

# 导航
moltbot browser navigate https://example.com

# 获取页面结构
moltbot browser snapshot

# 点击链接（需要先获取快照）
moltbot browser click 12

# 输入文本
moltbot browser type input-1 "Hello World"

# 按键
moltbot browser press Enter

多配置管理

# 列出配置
moltbot browser profiles

# 创建新配置
moltbot browser create-profile --name work --color #FF5733

# 使用指定配置
moltbot browser start --browser-profile work

复杂操作

# 等待页面加载
moltbot browser wait --time 5000

# 执行 JavaScript
moltbot browser evaluate --fn "document.title"

# 处理文件上传
moltbot browser upload /path/to/file.pdf

# 处理对话框
moltbot browser dialog --accept --prompt "Enter value"

与工具集成

浏览器命令与智能体工具配合使用：

{
  "action": "browser",
  "subaction": "snapshot",
  "profile": "default"
}

故障排除

浏览器无法启动

# 检查状态
moltbot browser status

# 重置配置
moltbot browser reset-profile

# 重新启动
moltbot browser stop
moltbot browser start

元素定位失败

# 重新获取快照
moltbot browser snapshot

# 使用更精确的 ref
moltbot browser click e12

相关资源

• 浏览器工具 - 智能体工具文档