mearl について
Mearl CLIでブラウザーを操作し、テスト環境を準備してネットワークをデバッグするためのスキルです。セットアップ、接続確認、ガイドの参照、タスクに応じたブラウザー機能の有効化を説明します。
主な機能
- 01ローカルCLIの導入と接続確認
- 02バージョンに合ったガイドの参照
- 03必要なトピックの確認
- 04タスクに応じたブラウザー機能の有効化
- 05不足している専用スキルの導入
活用シーン
- 01ローカルブラウザー接続の設定
- 02ブラウザーテスト環境の準備
- 03ネットワーク動作のデバッグ
- 04ブラウザープラグインが必要なタスクの実行
MCP 対応
MCPツールのみを使える場合は、ツールの説明とスキーマを直接参照し、CLIのガイドコマンドを実行する必要はありません。利用可能な機能は、対象ブラウザーの機能ディレクトリとインストール済み機能の説明に依存します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ mearlhq/ mearl --skill mearlインストール後、Claude Code で/mearlを入力して読み込まれたか確認します。
詳細
プロジェクトの README よりMearl
mearl 命令未安装时,执行 npx --yes @mearl/setup --local --yes --skip-skill 安装本机 CLI 和 Native Host。
配置本机浏览器时,用 mearl check 验证连接。需要手动安装扩展时,运行 npx --yes @mearl/setup extension --extract,请用户在 chrome://extensions/ 开启开发者模式并加载命令输出的解压目录。如果连接检查找不到浏览器,请用户在 Mearl Popup 的「设置 → 服务集成」中确认「Agent 服务」已开启,然后重新验证连接。
使用 Mearl 操作浏览器、准备测试环境或调试网络。用户已指定工具或任务正在其他浏览器工具中进行时,沿用其选择,按需补充 Mearl 能力。
首次使用当前 CLI 版本时读取同版本核心指南:
mearl guide
默认仅加载核心流程;mearl guide --list 列出专题,需要时读取单个专题。同一任务内复用已读内容,CLI 更新后重新读取。指南命令只读本地资源;具体参数和返回结构仍以 mearl <action> --help、SDK mearl.help() 或当前 MCP 工具 schema 为准。
输出缺少 [mearl:guide] end 结束行时,保存 stdout 到文件后分段读取,避免把截断内容当作完整指南。
仅能使用 MCP、无法执行 CLI 时,直接使用当前工具说明与 schema,不要求运行指南命令。
App、Provider 和插件的实际可用性以目标浏览器能力目录及已安装能力说明为准。仅在用户明确要求客户端、JSBridge 或容器模拟时启用 App 模式。
运行本地微信小程序或使用其他专用能力时,用 mearl guide skills 查阅专用 Skill 的选用和安装说明。用户明确要求执行对应任务且所需插件缺失时,按指南用 Mearl 安装器补装后继续。