puppeteer

用 JavaScript 轻松操控无头浏览器，搞定自动化测试与网页抓取。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署自动化工作流 🍴 复刻 9595 🐛 待处理 192 👀 关注 1186

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 95821

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，完全免费，无付费版本。

项目预览

项目数据

分类自动化工作流

开发团队puppeteer

官网地址https://pptr.dev

GitHubhttps://github.com/puppeteer/puppeteer

定价模式🏷️完全免费

价格说明开源项目，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型automation,chrome,chromium,developer-tools,firefox,headless-chrome,node-module,testing,web

GitHub 星标★ 95821

上线时间2017-05-09 00:00:00

代码更新2026-11-11

仓库体积1.54 GB

本站数据更新2026-11-11

维护状态活跃

收录时间2026-08-10

浏览次数21

项目介绍

Puppeteer 是一个由 Google 维护的 Node.js 库，提供高级 JavaScript API 来控制无头 Chrome 或 Firefox 浏览器。它解决了开发者需要以编程方式操作浏览器的痛点，无需手动打开界面即可完成自动化任务。其核心能力包括：页面 DOM 操作、表单提交、键盘输入、网络请求拦截与模拟、生成页面截图和 PDF、爬取单页应用（SPA）内容、模拟移动设备等。Puppeteer 通过 DevTools 协议与浏览器通信，支持有头/无头模式切换，广泛用于端到端测试、网页抓取、性能监控和自动化运维。它内置了浏览器下载管理，简化环境配置，并提供丰富的 API 文档和示例。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-10 · 当前星标 ★ 95821

技术标签

automation chrome chromium developer-tools firefox

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

环境要求

Node.js 运行环境（Puppeteer 是 Node.js 库/Node 模块）
支持 npm、pnpm、Yarn、Bun 或 Deno 等包管理器
使用 puppeteer-core 时需自备 Chrome 或 Firefox 浏览器
所在系统能够运行 Chrome 或 Firefox 浏览器

安装与启动步骤

1安装 Puppeteer

在 Node.js 项目中执行该命令，安装过程中会自动下载与之兼容的 Chrome 浏览器。
```
npm i puppeteer
```
2安装核心库

改用 puppeteer-core 只安装库本身、不下载 Chrome，适合已有浏览器或自行指定浏览器可执行文件。
```
npm i puppeteer-core
```
3手动装浏览器

现代包管理器默认阻止依赖安装脚本，此时安装不会下载浏览器，需手动执行此命令补装所需浏览器。
```
npx puppeteer browsers install
```
4放行安装脚本

另一种做法是配置包管理器允许安装脚本运行，例如在 package.json 中把 "puppeteer" 加入 "allowScripts"。
5可选装 MCP

README 提到可安装基于 Puppeteer 的 chrome-devtools-mcp 用于浏览器自动化与调试，安装方式见其仓库说明。