项目介绍
Playwriter 通过浏览器扩展与 MCP 服务连接用户浏览器,使代理能够在授权页面执行自动化。适合处理已有登录状态的操作,需要清楚限定可访问标签页与操作范围。
扩展负责把选中的标签页接到代理,MCP 服务负责向代理提供操作工具。人可以先完成登录与页面准备,再交给代理执行检索、填写和结果核对,过程中仍能看到当前页面。
它利用页面结构和 Playwright 接口定位元素,适合重复的网页操作。页面中的文字可能变化,自动化脚本应以当前可见状态为依据;涉及提交、删除或付款的步骤,应在任务中明确授权边界。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 沿用会话 | 在已登录标签页工作,减少重复配置登录环境。 |
| 标签页连接 | 在目标页面启用扩展,确认代理操作的是正确页面。 |
| 结构读取 | 通过页面元素和文本理解界面,减少仅凭坐标操作。 |
| 人机交接 | 需要人工处理的验证完成后,可继续原任务。 |
| 操作检查 | 读取操作后的页面状态,确认填写或点击是否生效。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 项目指南 |
| 分类 | AI 与开发 |
| 项目仓库 | remorses/playwriter |
| 整理日期 | 2026-11-14 |
安装与运行
在使用浏览器的电脑准备 Node.js,安装项目对应的浏览器扩展,并按官方说明启用目标标签页连接。CLI 本身不会自动获得已有浏览器会话。
1. 安装和初始化
npm install -g playwriter
playwriter --help
playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'
2. 第一次使用
先确认扩展已连接,再运行最小示例。打开的 example.com 用于验证连接,随后在该会话中查看页面标题或截图。任务只读检查成功后再做填写操作;会话编号用于复用状态,不代表账号或密码。
仅需本机服务时使用 npx -y playwriter serve --host 127.0.0.1。远程连接必须单独配置鉴权与受控网络,不能直接把浏览器控制端口对公网开放。
常见问题
- 命令不存在:确认依赖已安装,关闭并重新打开终端,再检查实际使用的环境。Python 虚拟环境与系统 Python、Windows 与 WSL 的工具路径各自独立。
- 下载依赖失败:先查看具体失败的仓库和包名,检查该终端的网络;浏览器能访问不代表命令行已使用同一代理。
- 配置后仍报错:从当前项目目录启动,检查配置文件名、变量名和日志。真实账号与 API Key 放在本机私有配置中,不复制到公开教程或截图。
更新与备份
更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。