Mearl3.0
SkillsEnglish
本页内容

入门

安装 Mearl

先运行 setup，再选择浏览器接入方式，最后验证首个任务。Chrome 扩展是接入日常浏览器的可选方案。

1. 安装 Mearl 环境2. 选择浏览器接入方式

1. 安装 Mearl 环境

安装指南

需要 Node.js 20.18.0 或更高版本。浏览器和独立 Provider 的要求见各自接入指南。

先运行安装器。打算使用 Agent 时，按提示选择对应的 Skill 接入。

Shell
npx @mearl/setup

2. 选择浏览器接入方式

浏览器连接与会话

setup 已准备好本机工具。选择你想用的浏览器，再按下列一种方式接入。

日常浏览器 · 扩展接入
复用已有标签页和登录态，按下方可选步骤安装扩展。
浏览器 / Electron · CDP
接入已开放远程调试的浏览器或 Electron 客户端页面，无需安装 Mearl 扩展。
外部环境 · Provider 接入
通过对应 Provider 接入本地或远端浏览器、设备。可用动作取决于该 Provider 的支持范围。
云端调用 · Cloud Connector
通过 Cloud Server 将请求转发到浏览器所在主机，再使用该主机上配置好的浏览器连接。

可选：接入日常浏览器

查看工具箱用法

在需要复用标签页和登录态的 Chrome 配置中安装扩展，同时获得工具箱和 DevTools 面板。需要 Chrome 120 或更高版本。

Chrome 应用商店下载离线 ZIP 3.0.12

请选择与本机组件同版的扩展。解压 ZIP 后打开 chrome://extensions/，开启「开发者模式」，点击「加载已解压的扩展程序」并选择解压目录。

3. 确认连接

继续快速上手

保持所选环境运行。使用扩展时，在 Mearl 的「设置 → 服务集成」开启「Agent 服务」。检查环境并列出已连接的浏览器。

Shell
mearl check
mearl browser_list

确认列表中出现目标浏览器。连接多个环境时，将目标 browserId 告诉 Agent。

通过 MCP 接入

MCP

确认本机连接正常后，运行 MCP 安装命令，选择客户端并重启，让客户端加载工具。

Shell
npx @mearl/setup --mcp