用途:让智能体在浏览器和桌面之间选择正确的操作面,按任务类型路由到隔离浏览器、运行环境自带的 Chrome 扩展,或原生桌面工具 peekaboo,并强调同一目标不要叠加使用多种方式。
主要能力与选择规则:
- 隔离或沙盒浏览器、localhost、设备宽度、录制场景:优先使用该运行环境内置的浏览器工具(如果存在)。
- 已登录站点、现有标签页、SSO、2FA、真实 Chrome 场景:使用运行环境自带的 Chrome 扩展;没有自带扩展的环境使用 agent-browser。
- 原生应用、系统对话框、菜单栏、canvas 或无 DOM 场景:使用 peekaboo。
必要用法:
- Claude Code 使用 claude-in-chrome(mcp__claude-in-chrome__*),先做一次 ToolSearch select 加载工具,再在操作任何内容前调用 tabs_context_mcp。
- Codex 使用 Codex Chrome 插件,通过 mcp__node_repl__js 驱动,无 browser_* 工具;从插件 scripts/browser-client.mjs 导入 setupBrowserRuntime,使用 agent.browsers.get("chrome"),先读 chrome.documentation(),再访问标签页前调用 chrome.user.openTabs()。
- 无自带扩展的环境使用 agent-browser:先用 search_tool 发现工具(agent-browser、status、tabs、open),先调用 status;未连接或扩展过期时提示用户重新加载未打包的 Agent Browser 扩展(chrome://extensions)。
- peekaboo 先调用 see,再基于快照中的元素 ID 操作;已有 DOM 快照的网页不要用截图点击。
安装与配置:agent-browser 随技能目录提供 extension/(未打包 MV3 扩展)、native-host/bridge.mjs 和 mcp/agent-browser.mjs。全局安装路径为 ~/.agents/skills/computer-and-browser/mcp/agent-browser.mjs,在运行环境的 MCP 配置中以 node 启动该脚本。扩展需在 chrome://extensions 开启开发者模式手动加载一次。peekaboo 需要授予屏幕录制、辅助功能和事件合成权限。
限制与安全:不要使用 chrome-devtools --autoConnect,也不要使用 hangwin chrome-mcp-server。扩展在用户已登录的 Chrome 中操作,误点即真实操作;发送邮件、提交表单、购买或输入凭据前应先询问。不要未经用户要求授予 peekaboo 前台光标控制。缺失信息:资料未提供价格、收费、支持的平台范围和效果说明。