9.3万星微软开源浏览器自动化，让Codex自己点网站找bug
⭐ 开源免费
Playwright 是微软开源的浏览器自动化与端到端测试框架，GitHub 上 9.3 万 Star，Apache-2.0 协议，一套 API 同时驱动 Chromium、Firefox、WebKit 三大浏览器内核。
而 Playwright MCP（@playwright/mcp）是官方基于它做的 MCP 服务器，单独就有 3.5 万 Star——它把「操作浏览器」这件事变成了 AI 可以直接调用的工具。
它最关键的技术选择是：不靠截图让模型「看图猜按钮在哪」，而是直接读取页面的无障碍树（accessibility snapshot）。 页面上每个按钮、输入框、链接都以结构化文本的形式交给模型，带着角色、名称和可交互状态。 这带来三个直接好处：不需要多模态视觉模型也能跑、定位是精确的而不是靠坐标估算、token 消耗远低于反复传截图。
装上之后，Codex 就从「只能改代码」变成「能自己打开浏览器验证代码」：你说一句「把注册流程走一遍」， 它自己导航、点击、填表、断言，跑完告诉你卡在第几步、报了什么错，还能把整套复现步骤落成一个 Playwright 测试脚本。 官方文档里明确把 Codex 列在支持的客户端名单中，配置只要三行。
| 项目 | 说明 |
|---|---|
| 输入 | 自然语言指令，例如「打开这个页面，把注册流程走一遍」「点提交按钮，看有没有报错」 |
| 核心动作 | 导航、点击、输入、下拉选择、悬停、拖拽、上传文件、按键、等待、断言、截图、导出 PDF |
| 感知方式 | 无障碍树快照（结构化文本），可选开启 vision 能力组走截图坐标模式 |
| 输出 | 页面快照、控制台日志、网络请求记录、截图 / PDF、Playwright 测试脚本、可回放的 trace 文件 |
| 浏览器兼容 | chromium（默认）、firefox、webkit，也可指定 chrome / msedge 品牌通道 |
| 能力组 | core / core-navigation / core-tabs / core-input / network / storage / testing / vision / pdf / devtools |
| 默认超时 | 动作 5000ms、导航 60000ms、断言 5000ms，均可在配置文件里调整 |
| 环境 | 建议配置 |
|---|---|
| 操作系统 | Windows 10/11、macOS、Linux 均可 |
| 运行环境 | Node.js 18 及以上（用 npx 拉起服务，装完用 node -v 确认） |
| 硬件 | 不需要显卡。纯 CPU 运行，内存建议 8GB 以上（浏览器本身吃内存） |
| 磁盘 | 浏览器内核约 300MB 到 1GB，取决于装几个内核 |
| 关键依赖 | Playwright 浏览器内核，需要单独跑一次 npx playwright install 下载 |
| 无图形界面环境 | 服务器 / CI / Docker 里没有显示器，必须加 --headless 参数，否则起不来 |
| AI 客户端 | Codex CLI 或 Codex 桌面端（官方支持名单里也包含 Claude Code、Cursor、Cline 等） |
MCP 服务是靠 npx 拉起来的，所以必须先有 Node.js 18 以上。在终端里执行下面的命令，能打印出版本号就说明没问题；没有的话去 Node.js 官网下载 LTS 版安装。
node -v
npx -v
Playwright 用的是它自己管理的浏览器，不是你电脑上装的那个 Chrome。 不先跑这一步，后面十有八九会报「chrome executable not found」——这是新手最常踩的坑。
# 只装 Chromium（够用，体积最小，推荐）
npx playwright install chromium
# 或者三个内核全装
npx playwright install
找到 Codex 的配置文件：Windows 在 C:\Users\你的用户名\.codex\config.toml，
macOS 和 Linux 在 ~/.codex/config.toml。文件不存在就新建一个，把下面三行加进去。
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
保存后重启 Codex，用下面两条命令确认它认到了：
codex mcp list
codex mcp get playwright
直接在 Codex 里用大白话说就行，不需要任何命令。默认是有头模式，你会看到浏览器自己弹出来开始操作：
先启动我的项目，然后用浏览器打开首页，告诉我页面标题是什么
进入登录页，邮箱填一个测试账号、密码随便填一个，
然后点提交，告诉我有没有报错、报的什么错
把刚才这套操作写成一个 Playwright 测试脚本，存到 tests 目录
参数都加在 args 数组里，跟在包名后面。比如要在服务器上跑无界面模式加断网调试：
[mcp_servers.playwright]
command = "npx"
args = [
"@playwright/mcp@latest",
"--headless",
"--isolated",
"--viewport-size", "1280x720",
"--save-trace",
"--output-dir", "./pw-artifacts"
]
常用参数说明：
| 参数 | 作用 |
|---|---|
--headless | 无界面运行。服务器 / CI / Docker 里必须加，本地调试建议不加，方便肉眼看它怎么点的 |
--browser | 选内核：chromium（默认）/ firefox / webkit / chrome / msedge |
--isolated | 每次用全新的内存态配置，不留 Cookie 和登录态，跑测试要的就是这种可重复性 |
--user-data-dir | 与上一条相反，把配置持久化到指定目录，登录态跨会话保留 |
--storage-state | 指向一个登录态 JSON 文件，让它一启动就是已登录状态，省去每次跑登录流程 |
--viewport-size | 指定窗口尺寸，如 1280x720。截图要稳定就固定住它 |
--device | 模拟设备，用来测移动端页面的响应式布局 |
--caps | 开启额外能力组，逗号分隔，如 tabs,pdf。排查「一个工具都没有」时先把它去掉 |
--save-trace | 录制完整操作轨迹，事后用 npx playwright show-trace 逐帧回放它干了什么 |
--proxy-server | 让浏览器走代理，公司内网环境常用 |
--config | 参数太多时改用 JSON 配置文件，超时时间、网络白名单等高级项只能在这里设 |
① 改完代码顺手自测。让 Codex 改完前端后直接说「起服务，把这个页面点一遍看有没有报错」， 它会自己开浏览器验证，而不是嘴上说「应该没问题」。
② 把手工回归变成脚本。先让它手动走一遍流程，走通后说「把刚才的操作写成 Playwright 测试」， 以后这条用例就进 CI 了，等于用大白话攒测试用例。
③ 复现线上 bug。把用户描述的操作步骤丢给它，让它照着点一遍，
配合 --save-trace 录下轨迹，网络请求和控制台报错全都在里面。
| 指标 | 数据 |
|---|---|
| Playwright 主仓 Star | 93,738（微软官方，Apache-2.0 协议） |
| Playwright MCP Star | 35,664（同团队维护，随主线更新） |
| 支持浏览器内核 | Chromium、Firefox、WebKit 三大内核，一套接口通吃 |
| 硬件门槛 | 纯 CPU，无需显卡，与本地大模型方案相比几乎零成本 |
| 默认超时 | 动作 5000ms / 导航 60000ms / 断言 5000ms |
这是最高频的问题，原因是只配了 MCP 但没下载浏览器内核。
执行 npx playwright install chromium 装一次就好。
如果装完还报错，可以先 npm install -g @playwright/mcp 做全局安装再试。
Playwright 是底层的自动化框架，Playwright MCP 是官方基于它封装的 MCP 服务器。
你不需要单独安装 Playwright 框架，npx @playwright/mcp@latest 会自动把需要的部分拉下来，
你只要额外下载一次浏览器内核即可。
按顺序排查：① codex mcp list 看服务在不在；② 确认改的是 .codex/config.toml 而不是别的配置文件；
③ 确认改完重启过 Codex；④ 如果加了 --caps，先把它整个删掉——写了不存在的能力组名会导致工具列表变空，
恢复默认后确认工具出现，再逐个加回去。
默认是有头模式，方便你看它在干什么。加 --headless 就是后台运行。
注意反过来也成立：服务器、CI、Docker 这类没有图形界面的环境必须加 --headless，否则浏览器根本起不来。
完全不需要显卡。它不在本地跑模型，只是驱动浏览器，推理还是走你 Codex 原本用的模型。 内存 8GB 以上就够，主要开销来自浏览器进程本身。
不用。先用 Playwright 把登录态导出成一个 storage state 的 JSON 文件，然后用 --storage-state 指向它，
服务一启动就是已登录状态。实践中常和 --isolated 搭配用：每次都是干净环境，但登录态是注入好的，既可重复又免登录。
最大区别在感知方式。多数同类工具靠截图 + 视觉模型判断点哪里，依赖多模态能力且容易点偏； Playwright MCP 读的是无障碍树，定位精确、不吃视觉模型、token 开销也更低。 另外它出自微软 Playwright 团队，和成熟的测试生态（trace 回放、测试脚本生成、CI 集成）是打通的。
加 --save-trace 和 --output-dir，它会把整个会话录成 trace 文件，
之后用 npx playwright show-trace 文件路径 打开，每一步动作、每个网络请求、每个 DOM 快照都能逐帧回看。
可以。Playwright 采用 Apache-2.0 协议，允许商用、修改和再分发，只需保留版权声明。 但要注意：协议管的是软件本身，不代表你可以随便去自动化访问第三方网站——那要看对方网站的服务条款。