mcpField
P
playwriter

playwriter

github.com/remorses生产力4.0k5.9k 次安装1 天前更新
代码仓库

关于 playwriter

playwriter 是一项通过会话式命令行运行浏览器自动化的技能,要求使用前先读取完整文档,并提供创建页面和访问网址的示例。

主要功能

  1. 01基于会话控制浏览器
  2. 02创建页面并访问网址
  3. 03使用前读取完整文档

适用场景

  1. 01启动浏览器自动化会话
  2. 02为脚本化浏览器任务打开页面

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/remorses/playwriter --skill playwriter

安装后在 Claude Code 中输入/playwriter确认已加载。

详细介绍

阅读完整文档(每个会话一次)

在会话中首次运行 playwriter 命令前,请运行:

playwriter skill # IMPORTANT! do not use | head here. read in full!

这会输出完整文档,包括:

  • 会话管理和超时配置
  • 选择器策略(以及应避免使用的策略)
  • 防止超时和失败的规则
  • 慢速页面和 SPA 的最佳实践
  • 上下文变量、实用函数等

请勿跳过此步骤。 如果不了解完整文档中的超时、选择器规则和注意事项,下面的示例将无法正常运行。每个会话只需执行一次;同一会话中后续的 playwriter 命令无需重新阅读文档。

请阅读完整输出。 请勿使用 head、tail 或任何截断命令进行管道处理。关键规则分散在文档各处,而非只出现在开头。

最简示例(阅读完整文档后)

playwriter session new
playwriter -s 1 -e 'state.page = await context.newPage(); await state.page.goto("https://example.com")'

-e 参数始终使用单引号。单引号可防止 bash 解释 JS 代码中的 $、反引号和反斜杠。JS 中的字符串请使用双引号或反引号模板字面量。

如果找不到 playwriter,请使用 npx playwriter@latest 或 bunx playwriter@latest。

评论

支持 Markdown