第34章 配置 Playwright 以支持 career-ops 浏览器自动化
指南:配置 Playwright——安装并设置 Playwright,实现浏览器自动化。
更新于 2026 年 10 月 11 日
本指南介绍三个配置步骤,让 career-ops 具备浏览器自动化能力:
- 安装 Playwright 的 Node 包
- 下载 Playwright 控制的 Chromium 浏览器
- 配置 Playwright MCP,让 Claude 在投递申请环节操作浏览器
开始之前
请先完成快速入门指南。需要安装 Node.js 22.13 或更高版本(Node 23 则需 23.4 及以上),并且要进入 career-ops 根目录。
安装 Playwright 包
在 career-ops 根目录运行 npm install:
终端
npm install
这会安装 Playwright 以及 package.json 中声明的所有其他项目依赖。如果初始配置时已经执行过,可跳过这一步。
下载 Chromium
Playwright 需要一份自己的 Chromium 来执行自动化。安装程序通常会在装完依赖后自动下载;如果 npm run doctor 报告缺失,可运行以下命令下载:
终端
npx playwright install chromium
这是一次性操作,npm 更新后无需重复执行。
配置 Playwright MCP
Playwright MCP 让 Claude 能在 /career-ops apply 环节直接控制浏览器——打开职位申请表单、读取字段标签、给出答案建议。
注册 MCP 服务器
在 career-ops 根目录运行以下命令,向 Claude Code 注册 Playwright MCP:
终端
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
这是 Playwright MCP 官方文档中的一步注册方法,额外加了 --scope project 参数,这样 Claude Code 会把服务器配置写入 career-ops 根目录的 .mcp.json 文件——这是 npm run doctor 会检查的文件之一。下次在该目录启动 Claude Code 时,在提示时批准该服务器即可。
如果想在所有项目中使用,可改用 --scope user 运行命令。但 npm run doctor 不会读取用户级服务器配置,届时它可能会警告检测不到 MCP,尽管 Claude Code 实际已加载。
手动配置(备选方案)
如果更倾向手动配置,可在 career-ops 根目录的 .mcp.json 中加入以下内容(文件不存在则新建):
.mcp.json
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
}
}
}
保存文件后重启 Claude Code,并在提示时批准该服务器。之后 career-ops 在申请环节就能使用 browser_navigate 和 browser_snapshot 功能。
验证配置
运行 doctor 脚本,确认三个组件都就绪:
终端
npm run doctor
查看输出,确认 Playwright、Chromium 和 MCP 服务器都已就绪。检查通过即表示配置完成。
观看浏览器填写表单
Playwright MCP 默认会打开一个可见的浏览器窗口(上述配置没有传入 --headless 参数),因此你能看到它读取的每个页面和填写的每个字段。
如果想让它在窗口中打开申请页面并填写整份表单,可在 apply 命令中附加一条指令:
/career-ops apply {company_name} open up with playwright the browser and fill out the entire form
运行带 {company_name} 参数的 /career-ops apply 命令,然后用 Playwright MCP 打开浏览器窗口,实时填写整份表单。
对于 Ashby 平台,Playwright 可以检查表单并帮助起草答案,但请在你常用的系统浏览器中完成并提交申请。在标记为"已投递"之前,请先确认出现了成功页面或收到了确认邮件。
即使不加这条指令,career-ops 仍会使用 Playwright 和 MCP 在同样的可见窗口中读取表单并起草答案。
各组件的作用
组件 | 用途
Playwright 包 | 驱动浏览器自动化的核心库
Chromium | 渲染页面、通过 /career-ops pdf 生成印刷级 PDF、检查职位是否仍开放,并支持完整的 ATS 扫描
Playwright MCP | 让 career-ops 在 /career-ops apply 环节导航表单并给出字段答案建议
批量评估 Offer | 用并行 AI 工作节点在单次会话中处理 10 个以上的职位 Offer,并生成定制化 PDF。
从简历准备你的 STAR 故事 | 被"讲一个你曾经……的经历"问住了?career-ops 会在你评估职位时根据你的简历起草 STAR 故事,并让你在面试轮次前进行演练。