Browser-tools

Browser-tools 是一个 Codex 技能，用 Chrome DevTools MCP 与 Playwright MCP 协作操作网页。它默认尝试连接用户已经打开且可验证的浏览器，保留该实例的插件、历史和登录状态；没有可用连接证据时会说明阻塞原因。只有用户明确要求无痕、一次性或独立配置，才使用隔离浏览器。

能做什么

• Playwright：导航、页面快照、点击、填写、键盘操作、标签页和截图。
• Chrome DevTools：控制台、网络请求、性能跟踪、页面目标和调试。
• 两个 MCP 可在同一任务中接力，也可共同验证同一浏览器端点；按需加载能力，不强制二选一。
• 通过共享配置保存浏览器选择、CDP 端点、用户目录、镜像顺序和 MCP 开关。

安装

在仓库根目录执行：

py -3 -X utf8 scripts/browser_tools.py 检查依赖
py -3 -X utf8 scripts/browser_tools.py 安装依赖
py -3 -X utf8 scripts/browser_tools.py 安装技能

安装依赖默认先使用 https://registry.npmmirror.com；只有 installation.allowOfficialFallback 为 true 才会尝试 npm 官方源。安装技能默认部署到 .codex/skills/browser-tools 和 .agents/skills/browser-tools，并让两个目录共享主配置。参数、手工目标和故障处理见安装说明。

使用

直接提出“使用我已打开的浏览器打开网页并填写搜索框”或“检查当前页面网络请求和控制台”。需要时可说“用 Edge”，这只改变目标浏览器，仍使用本技能的 MCP 路由。用户问配置、安装、连接限制或两个 MCP 的协作方式时，Agent 会读取相应的参考说明。

常用只读检查：

py -3 -X utf8 scripts/browser_tools.py 读取配置
py -3 -X utf8 scripts/browser_tools.py 发现浏览器
py -3 -X utf8 scripts/browser_tools.py 规划会话
py -3 -X utf8 scripts/browser_tools.py 验证会话 --端点 http://127.0.0.1:9222

已验证端点需要同时给两个 MCP 使用时：

py -3 -X utf8 scripts/browser_tools.py 生成配置片段 --端点 http://127.0.0.1:9222

把输出合并到宿主 MCP 配置后，重新加载 MCP 或重启 Codex；脚本不擅自修改宿主配置。完整流程见双工具协作。

重要限制

运行中的浏览器没有 CDP 端点、Playwright 桥接扩展或 Chrome 144+ 自动连接授权时，不能无感复用。Chrome 从 136 起还禁止对默认数据目录直接启用远程调试端口，端口方式必须指定非默认用户目录；这可能不包含日常登录态。参见会话说明和Chrome 官方说明。

两个 MCP 不应分别以同一用户目录启动浏览器；同一页面的写操作串行执行。技能不会导出 Cookie、密码或令牌，也不会为结束任务关闭用户原有浏览器。发送、购买、删除和提交等高影响操作遵循用户授权。

目录

SKILL.md 是入口；references/ 按需提供发现会话、Playwright、Chrome DevTools、双工具协作、安装和对话说明；config/default.json 是公开默认值；scripts/browser_tools.py 提供配置、依赖、发现、会话和安装命令。内部名称为 browser-tools，产品名称为 Browser-tools。

验证边界

仓库自检覆盖配置版本、严格类型、路径和端点校验、镜像回退策略、共享配置安装及命令参数契约。它不能替代真实 Chrome/Edge 进程、CDP 端点、浏览器扩展、登录账号、插件效果或多显示器场景的验收；这些需要在目标机器按实际浏览器和授权环境验证。

许可证

本项目使用 MIT 许可证，详见 LICENSE。