AI 与开发

Playwriter:连接已有浏览器会话

  • 0 次阅读
  • 0 条评论
文章摘要

Playwriter 通过浏览器扩展与 MCP 服务连接用户浏览器,使代理能够在授权页面执行自动化。适合处理已有登录状态的操作,需要清楚限定可访问标签页与操作范围。 扩展负责把选中的标签页接到代理,MCP 服务负责向代理提供操作工具。人可以先完成登录与页面准备,再交给代理执行检索、填写和结果核对,过程中仍能看到当前页面。 它利用页面结构和 Playwright 接口定位元素,适合重复的网页操作。页面中的文字可能变化,自动化脚本应以当前可见状态为依据;涉及提交、删除或付款的步骤,应在任务中明确授权边界。

项目介绍

Playwriter 通过浏览器扩展与 MCP 服务连接用户浏览器,使代理能够在授权页面执行自动化。适合处理已有登录状态的操作,需要清楚限定可访问标签页与操作范围。

扩展负责把选中的标签页接到代理,MCP 服务负责向代理提供操作工具。人可以先完成登录与页面准备,再交给代理执行检索、填写和结果核对,过程中仍能看到当前页面。

它利用页面结构和 Playwright 接口定位元素,适合重复的网页操作。页面中的文字可能变化,自动化脚本应以当前可见状态为依据;涉及提交、删除或付款的步骤,应在任务中明确授权边界。

核心功能

功能 作用与使用方式
沿用会话 在已登录标签页工作,减少重复配置登录环境。
标签页连接 在目标页面启用扩展,确认代理操作的是正确页面。
结构读取 通过页面元素和文本理解界面,减少仅凭坐标操作。
人机交接 需要人工处理的验证完成后,可继续原任务。
操作检查 读取操作后的页面状态,确认填写或点击是否生效。

功能示意

Playwriter 功能示意图

图 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 放在本机私有配置中,不复制到公开教程或截图。

更新与备份

更新前保存项目配置、输入资料和输出结果。源码项目记录当前提交与依赖锁文件,比较新版本说明后再更新;安装包项目保留可回退的版本号。服务账号的授权与模型账单在对应平台管理,删除本地目录不会自动撤销授权。

官方资料