简介
Playwriter 是一款独特的浏览器自动化工具，它允许AI智能体直接控制一个已登录的现有Chrome会话，从而绕过常见的机器人检测，并且无需使用无头浏览器实例。
什么是 Playwriter？
Playwriter 是一个 Chrome 扩展程序和命令行界面工具，它使 AI 智能体或自动化脚本能够与用户实际打开的 Chrome 浏览器进行交互。它解决了浏览器自动化的一个关键问题：缺乏真实的用户上下文。像标准 Playwright 这样的传统自动化工具会启动一个全新的、“干净”的浏览器实例。这个新浏览器没有登录会话、没有安装扩展程序、也没有 cookie，这通常会触发机器人检测系统，并阻止需要登录状态的任务的自动化。Playwriter 适用于需要自动化网站复杂工作流程的开发人员、QA 工程师和高级用户，这些网站的身份验证、个人设置或特定的浏览器扩展至关重要。它的重要性在于，通过利用用户真实的浏览器环境，为浏览器自动化和AI智能体交互提供了一种更真实、高效且隐蔽的方法。
Playwriter 的主要特性
控制您的实际浏览器
Playwriter 的核心功能是能让智能体控制您现有的 Chrome 窗口。这意味着您所有活跃的登录状态、cookie 和浏览器扩展程序都能立即用于自动化，从而消除了设置时间，并绕过了许多机器人检测机制。
完整的 Playwright API 访问权限
Playwriter 不是将智能体限制在一组固定的预定义工具中，而是提供了一个单一的 execute 命令，授予对整个 Playwright API 的访问权限。这使得诸如设置断点、拦截网络请求和实时编辑页面脚本等复杂交互成为可能。
实时协作与监督
由于智能体在您可见的浏览器中操作，您可以实时观察其操作并在必要时进行干预。您可以解决 CAPTCHA、点击同意对话框或手动纠正其进程，从而创建一种协作式的人机工作流程。
高效的辅助功能快照
为了理解页面，智能体使用轻量级的基于文本的辅助功能快照，而不是大型截图。这些快照列出了每个交互式元素及其对应的 Playwright 定位器，从而大幅减少了数据大小和成本，同时提高了可解析性。
Vimium 风格的视觉标签
对于需要空间理解的任务，Playwriter 可以生成屏幕截图，在每个交互式元素上叠加颜色编码的标签（类似于 Vimium 扩展）。智能体随后可以参考这些标签来执行精确的点击和交互。
隔离的多智能体会话
Playwriter 支持在同一浏览器中运行多个并发的自动化会话。每个会话都在一个独立的沙箱中运行，拥有其自己持久的状态对象，从而防止智能体在共享相同浏览器标签页时相互干扰。
高级调试与实时编辑
它深度集成了 Chrome 开发者工具协议，允许智能体设置 JavaScript 断点、单步执行代码、检查运行时变量，甚至无需重新加载页面即可实时编辑页面 CSS 和脚本。
网络流量拦截
智能体可以监控和拦截网络请求和响应。这对于逆向工程 API、抓取通过 JavaScript 传送的数据或直接从 CLI 调试 Web 应用程序调用来说非常宝贵。
Playwriter 的用例
使用真实用户数据进行自动化测试
QA 工程师可以创建和运行需要特定用户账户、复杂的多步骤登录过程或个性化设置的自动化测试，所有这些都在真实的浏览器会话中进行。
登录后网络数据抓取
数据专业人员可以自动化收集需要身份验证的网站数据，例如私有仪表板、社交媒体平台或基于订阅的服务，而无需处理无头浏览器检测。
AI 智能体任务自动化
构建 AI 智能体的开发人员可以使用 Playwriter，让他们的智能体能够在网络上执行复杂的多步骤任务，例如预约、管理社交媒体或研究主题，利用智能体现有的浏览器上下文。
调试与开发
前端开发人员可以使用 Playwriter 的 CLI 以编程方式与其 Web 应用程序交互、设置断点、即时编辑代码以及从终端检查网络流量，从而加速调试过程。
重复性工作流程自动化
高级用户可以自动化繁琐、重复的浏览器任务，例如每日报告生成、表单填写或监控网站更改，同时保持其自定义的浏览器环境。
如何使用 Playwriter
开始使用 Playwriter 涉及一个简单的设置过程，以将您的浏览器连接到自动化 CLI。
- 安装 Chrome 扩展程序： 从 Chrome 网上应用店将 "Playwriter MCP" 扩展程序添加到您的浏览器。
- 在标签页上激活： 在您希望控制的任何浏览器标签页上点击 Playwriter 扩展程序图标。图标将变为绿色，表示它已连接并准备就绪。
- 安装 CLI 工具： 打开终端并使用 npm 全局安装 Playwriter CLI：
npm i -g playwriter。 - 添加智能体技能： 安装配套技能，该技能教会 AI 智能体如何有效使用 Playwriter：
npx -y skills add remorses/playwriter。 - 执行命令： 通过 CLI 发送 Playwright 命令开始控制您的浏览器。例如，要导航到某个站点，您可以运行：
playwriter -e "page.goto('https://example.com')"。
Playwriter 的目标受众
- 开发人员和工程师：构建需要真实浏览器交互的 AI 智能体或自动化脚本。
- QA 自动化工程师：需要在身份验证状态下或使用特定浏览器扩展测试 Web 应用程序。
- 数据科学家和分析师：从需要登录凭据的网站抓取数据。
- DevOps 和 SRE 专业人员：在 Web 控制台中自动化监控、诊断或管理任务。
- 高级用户和生产力爱好者：希望在个人浏览器中自动化基于 Web 的重复性任务。
Playwriter 是免费的吗？
根据现有的参考信息，Playwriter 似乎是一个免费的开源工具。该项目托管在 GitHub 上，安装说明使用的是免费包管理器（npm），没有提及许可费或订阅计划。用户应查看官方 GitHub 存储库以获取最新的许可信息。
| 方案 | 价格 | 功能 |
|---|---|---|
| 可用版本 | 免费 | Chrome 扩展程序、CLI、完整的 Playwright API 访问权限、本地 WebSocket 中继。 |
Playwriter 的优缺点
| 方面 | 优点 | 缺点 |
|---|---|---|
| 浏览器上下文 | 使用带有登录状态和扩展的真实 Chrome；绕过机器人检测。 | 需要 Chrome 且用户已登录；不是独立的服务。 |
| 能力 | 授予完整的 Playwright API 和 CDP 访问权限以实现最大控制。 | 对初学者可能复杂；强大的工具需要知识才能安全使用。 |
| 效率 | 无需因启动新浏览器而占用额外内存；轻量级快照。 | 自动化绑定到用户计算机和活跃的浏览器会话。 |
| 协作 | 支持实时人工监督和干预。 | 不适用于服务器上完全无人值守的自动化。 |
| 设置 | 安装过程相对简单；可与现有浏览器配合使用。 | 需要同时安装扩展程序和 CLI 工具。 |
Playwriter 常见问题解答
Playwriter 与标准 Playwright 库有何不同？
标准的 Playwright 库会启动一个新的、隔离的浏览器实例。相比之下，Playwriter 则连接并控制您已经打开的 Chrome 浏览器。这一关键区别意味着 Playwriter 会话可以访问您现有的 cookie、登录状态和扩展程序，而标准 Playwright 则不能。
使用 Playwriter 时我的浏览数据安全吗？
是的。根据提供的信息，所有通信都通过运行在您本地机器上的 WebSocket 中继进行。没有浏览数据、凭据或自动化命令发送到远程服务器；所有内容都保留在您的计算机上。
我可以在 Chrome 以外的浏览器上使用 Playwriter 吗？
目前的描述特别提到了 Chrome 扩展程序和控制您的 Chrome 会话。因此，它是专门为 Chrome/Chromium 生态系统设计的，很可能不支持 Firefox 或 Safari。
如果智能体在 CAPTCHA 或同意弹出窗口上卡住了怎么办？
这是 Playwriter 协作模式的主要优势之一。由于您共享浏览器，您可以实时看到弹出窗口出现。您可以手动解决 CAPTCHA 或点击同意按钮，然后智能体可以从它中断的地方继续其自动化任务。
多个 AI 智能体可以同时使用 Playwriter 吗？
是的。Playwriter 的本地中继支持会话多路复用。这允许多个 CLI 实例或 AI 智能体创建隔离的沙箱会话，并同时控制同一浏览器，而不会相互干扰对方的状态。
我需要懂编程才能使用 Playwriter 吗？
通过预配置的 AI 智能体进行基本使用可能只需要最少的编码知识。但是，要充分利用其功能，通过为 execute 命令编写自定义的 Playwright 脚本，则需要具备 JavaScript 和 Playwright API 的工作知识。
Playwriter 标签
Playwriter, Chrome 自动化, 浏览器自动化, Playwright API, 无头浏览器, 机器人检测绕过, AI 智能体工具, MCP, 网络抓取, 自动化测试, Chrome 扩展程序, CLI 工具, 网络拦截, 实时调试, 开源自动化
