Mearl3.0
SkillsEnglish
本页内容

任务指南

自动化操作网页

用页面快照找到控件，操作后核对结果；也可以直接调用站点提供的 WebMCP 工具。

先读取页面快照

示例中的 tabId 替换为 tab_open 或 tab_list 返回的实际值。交互快照精简输出视口内的控件，可用返回的元素引用点击、输入、悬停或选择。页面跳转或引用失效后重新取快照。

Shell
mearl page_snapshot --payload '{"tabId":12345,"mode":"interactive"}'

用动作结果判断下一步

页面动作指南网页调试

页面动作可以返回控件变化、通知、跳转和新标签页。先读这些结果，再决定是否需要补快照。用截图检查视觉布局，用页面检查定位元素遮挡或裁切。

  1. 查订单时，先读取筛选区域的快照，再填写订单号并提交查询。
  2. 从动作结果中核对结果数量或匹配的订单。动作结果不足时，补读结果区域的快照。
  3. 如果站点打开了新标签页，沿用返回的新 tabId，核对订单号后再读详情。

编排可复用的流程

把流程封装成 SkillCLI 和 SDK 参考MCP 工具

用 mearl run 编写包含条件、循环、浏览器动作和 Skill 命令的 JavaScript。应用可直接调用 TypeScript SDK。MCP 客户端既可调用共享动作，也可通过 browser_run_code 运行一组脚本步骤。

发现和调用 WebMCP 工具

在 Chrome 中启用 WebMCPMCP 工具

WebMCP 让站点可以提供查订单等操作。Mearl 会发现所选 Chrome 标签页的主文档注册的工具。扩展连接和直连 CDP 都支持发现与调用，实际可用范围取决于浏览器提供的 WebMCP 能力。

  1. 查看 tab_open、page_navigate 或 page_snapshot 返回的 webmcp 数组。发现过程在后台运行。目录缺失或被截断时，把 includeWebMcp 设为 "full" 显式补查。
  2. 用返回的 ref 和工具的输入 Schema 调用 page_call_tool。SDK 入口是 pageCallTool，MCP 入口是 browser_page_call_tool。页面跳转或引用失效后重新获取目录。
  3. WebMCP 在 Chrome 中仍是实验功能，需要站点或浏览器启用。浏览器只能列出工具时，Mearl 返回 discovery-only 状态。没有可调用工具时，可继续使用前面的快照工作流。
Shell
mearl page_snapshot --payload '{"tabId":12345,"includeWebMcp":"full"}'
mearl page_call_tool --payload '{"tabId":12345,"toolRef":"<ref>","arguments":{"orderId":"123"}}'