Agent Skills
返回列表
浏览器编排助手

浏览器编排助手

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @yahuixun/browser-orchestrator。

技能介绍

解决的问题

当桌面 Agent 需要操作一个真实、有头、本地保留的浏览器时，问题不只是调用 page_click，而是让远程 MCP Relay 能安全地把任务路由到本机浏览器节点，同时登录、MFA、验证码、敏感验证仍由人工完成。Browser Orchestrator 技能把有头浏览器作为 Browser Node 接入 Relay，用短期配对令牌建立节点身份，并保持一条出站长连接接收任务。

工作方式

核心流程是：

  • 用 MCP_RELAY_PAIRING_TOKEN 调用配对，生成本地 .local/relay-node.json 中的 node_secret
  • 用该凭据启动 Worker WebSocket，上报 hello、心跳、进度、日志、完成与失败事件
  • 桌面 Agent 连接 Relay 的 /mcp 端点；优先使用员工浏览器登录 OAuth，回退到 MCP_RELAY_MCP_TOKEN Bearer 调用
  • 对任务执行 page_goto、page_snapshot、page_click、page_fill、page_wait、page_screenshot 等本地 MCP 工具
  • 若需要扩展抓取，使用 capture_trigger；当返回 manual_required 时，请用户点击扩展按钮

它适合把“有头浏览器”作为可被 Relay 调度的工作节点，而不是把 OAuth、令牌或 Web Console 逻辑写进技能本身。

适用边界

  • 不要把 MCP_RELAY_PAIRING_TOKEN 或 node_secret 用于 /mcp 调用
  • 不要在聊天中索要密码、密钥或令牌，也不要打印、提交 .local/relay-node.json、Cookie、浏览器 Profile
  • 登录、MFA、CAPTCHA 必须人工完成；破坏性、付费、改账号或大批量操作前需确认
  • 如果 Relay /mcp 返回 401 却把 authorization_server 指向 http://localhost:5173，优先检查 Relay 服务端元数据，而不是浏览器节点

使用场景

  • 桌面 Agent 需要把远程任务路由到本机有头浏览器，完成点击、填表、等待和截图。
  • 登录、MFA、验证码必须在本机人工完成，Agent 只负责后续页面操作和状态检查。
  • 把多个 Browser Node 接入 MCP Relay，统一接收浏览器任务并查看心跳、进度和日志。
  • 调试页面状态时使用 page_snapshot、page_screenshot 或扩展 capture_trigger 收集证据。

适合人员

  • 需要让桌面 Agent 操作本机有头浏览器执行页面任务的自动化工程师
  • 要把 Browser Node 接入 MCP Relay 并查看连接事件的连接器工程师
  • 需要显式目标页面、人工验证和扩展抓取的受控网页采集负责人
  • 需要用页面快照、截图和扩展抓取排查浏览器自动化的测试工程师