playread (An Entrypoint)

播放阅读（或“播放并阅读”，根据上下文可能有所不同）

通过Playwright MCP实现Google搜索自动化。可以作为CLI工具或MCP服务器使用。

安装

npm install -g playread

或者直接使用 npx：

npx -y playread@latest google-search

使用方法

作为MCP服务器

作为MCP服务器启动PlayReady，以将所有流作为工具暴露出来：

playread mcp

或者在您的MCP客户端设置中进行配置（例如，Claude桌面版）：

{
  "mcpServers": {
    "playread": {
      "command": "npx",
      "args": ["-y", "playread@latest", "mcp"]
    }
  }
}

可用的MCP工具：

• fetch - 从网页URL获取并提取主要内容
• google-search - 进行谷歌搜索并提取结果

作为命令行界面工具

谷歌搜索

playread google-search

输出格式：

{
  "query": "Playwright automation testing",
  "totalResults": 18,
  "results": [
    {
      "title": "Playwright: Fast and reliable end-to-end testing for modern ...",
      "url": "https://playwright.dev/",
      "description": "Playwright enables reliable end-to-end testing for modern web apps..."
    }
  ]
}

获取URL内容

从任意URL中提取重要文本内容：

playread fetch https://example.com

输出格式：

{
  "url": "https://example.com/",
  "title": "Example Domain",
  "contentLength": 129,
  "content": "# Example Domain\nThis domain is for use in documentation examples..."
}

非常适合：

• 从网站提取文档
• 获取文章内容
• 解析博客文章
• 从GitHub获取README内容
• 任何文本量大的网页

创建自定义流程

Flows 是 JavaScript 模块，它们导出一个单一的异步函数。该函数接收一个已连接的（或“连接好的”） PlaywrightMCPClient 例子

在（系统/软件中）创建一个新的流程 flows/ 目录：

module.exports = async function(client) {
  await client.navigate('https://example.com');

  const snapshot = await client.snapshot();
  console.log('Page loaded');

  await client.close();
};

可用的客户端方法

连接

• connect() - 连接到 Playwright MCP 服务器
• disconnect() - 断开连接并清理

工具发现

• listTools() - 列出所有可用工具
• callTool(name, args) - 直接调用任何工具

浏览器控件

• navigate(url) - 导航到URL
• navigateBack() - 返回
• close() - 关闭浏览器
• resize(width, height) - 调整窗口大小
• install() - 安装浏览器

页面交互

• snapshot() - 获取无障碍性快照
• click(element, ref) - 点击元素
• type(element, ref, text, submit, slowly) - 输入文本
• pressKey(key) - 按下键盘键
• hover(element, ref) - 将鼠标悬停在元素上
• drag(startElement, startRef, endElement, endRef) - 拖放

表单

• fillForm(fields) - 填写多个表单字段
• selectOption(element, ref, values) - 选择下拉菜单选项
• fileUpload(paths) - 上传文件

页面状态

• evaluate(func) - 执行JavaScript
• screenshot(filename, type, fullPage, element, ref) - 截图
• consoleMessages(onlyErrors) - 获取控制台日志
• networkRequests() - 获取网络活动

对话框

• handleDialog(accept, promptText) - 处理警报/确认

标签页

• tabs(action, index) - 管理浏览器标签页

等一下

• waitFor(text, textGone, time) - 等待条件满足

流量详情

谷歌搜索

• 导航至谷歌
• 搜索“Playwright自动化测试”
• 等待30秒以加载结果
• 提取所有结果的标题、网址和描述
• 返回包含完整结果元数据的综合JSON输出

获取

• 接受一个URL作为参数
• 导航至该URL
• 使用启发式方法智能提取主要内容：

- 优先考虑；置于首要位置 `， `以及语义内容领域 - 提取结构化文本，包括标题、段落、列表和代码块 - 去除重复内容和导航元素 - 输出格式为简洁的Markdown

• 返回包含URL、标题、内容长度和提取内容的JSON
• 为简洁起见，限制输出为50,000个字符
• 在文档网站、博客、文章等多种平台上均能广泛适用

要求

• Node.js 14及以上版本
• Playwright MCP 服务器（通过 npx 自动安装）

注释

• 在流程完成前请务必关闭浏览器
• 支持 file:// 本地测试的URL
• 使用 browser_evaluate 用于调试窗口全局变量
• 没有硬编码值 - 所有流程均使用快照中的真实数据
• 截图会自动保存到 /tmp/playwright-mcp-output//