本页内容

任务指南

浏览器连接与控制会话

要沿用登录状态,就连接已登录的浏览器。要隔离测试,就启动一个独立实例。

Mearl 会发现已连接的浏览器,并返回各实例的 browserId 和连接状态。

  • Chrome 扩展用于当前 Chrome 配置和已有登录态的页面。
  • CDP 可直接连接 Chrome,也可启动独立的托管实例。
  • 云端调用经 Cloud Server 和 Connector 转发到浏览器所在主机,再通过该主机上的浏览器连接执行。
  • Browser Provider 接入其他浏览器平台或设备,动作和生命周期操作由 Provider 声明。
Shell
mearl browser_list

一条命令怎样到达浏览器

使用扩展连接时,动作在选中的 Chrome 配置里执行。如果选的是直连 CDP,Native Host 会通过 CDP 把命令发给 Chrome。

通过 Chrome 扩展控制本机浏览器
  1. CLI / SDK / MCP提交浏览器动作和目标。
  2. Native Host接收本机 IPC 请求,解析浏览器和会话。
  3. Mearl 扩展通过 Native Messaging 接收动作。
  4. Chrome 标签页沿用选中的浏览器配置执行,返回结果。

保持任务目标一致

用返回的 browserId 选择实例,后续页面动作沿用该页的 tabId。控制会话固定路由和任务归属,继续使用浏览器配置中原有的 Cookie 和存储。

Shell
mearl tab_open --browser '<browserId>' --session new --payload '{"url":"https://example.com","reuse":"prefer"}'

遇到登录、验证或需要人工检查时,可以暂停控制会话。用户交还后先重新观察页面,再继续操作。释放会话时通常会保留结果标签页。