用途:让智能体通过 codex-browser MCP 服务器控制真实的 Chrome 或 Edge 浏览器,完成网页导航、元素查找与点击、表单填写、数据提取、截图、网络与状态检查等自动化任务。
主要能力:共 52 个工具,分为标签页(列出、创建、关闭、认领)、导航(跳转、刷新、前进后退、等待加载/元素/URL)、DOM 与无障碍(快照、可见 DOM、按节点点击、按 ARIA 角色与名称查找)、页面检查(URL、标题、执行 JS、资源、控制台日志、设备模拟、性能指标)、捕获(截图、元素截图、打印 PDF、置前、对话框)、输入(点击、填充、悬停、下拉、拖拽、坐标点击/输入/按键/滚动、表单批量填写、文件上传)、网络与状态(Cookie 读写删、localStorage、网络监控)、CDP 诊断及会话管理(命名、收尾、信息、自检)。
使用方式:先调用 codex_doctor 自检,healthy 为 true 表示浏览器管道就绪;若 install.mcp_spawn_ready 为 false,需按 install.suggested_mcp_config 更新 MCP 配置。常用流程包括创建标签页后 codex_nav_and_wait 导航并等待、codex_bring_to_front 置前后截图、codex_find_element 配合 codex_click_element 按角色点击、codex_form_fill 批量填表并提交、codex_file_input 上传文件、codex_evaluate 执行 JS 提取数据或发起异步请求。任务结束调用 codex_finalize 释放标签页。
适用场景:网页自动化操作、SPA 登录与交互、表格数据提取、前端调试(控制台与网络监控)、截图与 PDF 生成、Cookie 与登录状态管理等。
限制:导航仅接受 http:// 与 https:// URL;文件路径须为绝对路径、位于 CODEX_BRIDGE_UPLOAD_BASE 目录内且不超过 10 MB;Cookie 值默认脱敏;截图与 DOM 快照可能含敏感内容;原始 CDP 仅限允许列表,敏感与有状态方法被阻止;可通过 CODEX_BRIDGE_PROFILE 或 --profile 使用 basic(34)、network(51)、full(52,默认)等精简配置。