英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

木偶操纵者

Puppeteer 是一个 JavaScript 库，提供了一个高级 API 用于控制
Chrome 或 Firefox 胜过
DevTools 协议 或 WebDriver BiDi。
Puppeteer 默认在无头模式（没有可见界面）下运行

入门 | API | 常见问题 | 贡献 | 故障排除

安装

npm i puppeteer # Downloads compatible Chrome during installation.
npm i puppeteer-core # Alternatively, install as a library, without downloading Chrome.

:::注意

现代包管理器（包括 npm（参见 RFC）、pnpm、Yarn、Bun 和 Deno）默认会阻止依赖安装脚本。如果安装脚本被阻止，Puppeteer 在安装过程中将不会下载浏览器，从而导致运行时错误。

安装后，您可以通过运行以下命令手动下载所需的浏览器：

npx puppeteer browsers install

或者，您可以配置您的包管理器以允许安装脚本运行（例如，对于 npm，可以在您的 package.json 中将 "puppeteer" 添加到 "allowScripts"）。

:::

MCP

安装 chrome-devtools-mcp，这是一个基于 Puppeteer 的 MCP 服务器，用于浏览器自动化和调试。

Puppeteer 还支持实验性的 WebMCP API。

示例

import puppeteer from 'puppeteer';
// Or import puppeteer from 'puppeteer-core';

// Launch the browser and open a new blank page.
const browser = await puppeteer.launch();
const page = await browser.newPage();

// Navigate the page to a URL.
await page.goto('https://developer.chrome.com/');

// Set the screen size.
await page.setViewport({width: 1080, height: 1024});

// Open the search menu using the keyboard.
await page.keyboard.press('/');

// Type into search box using accessible input name.
await page.locator('::-p-aria(Search)').fill('automate beyond recorder');

// Wait and click on first result.
await page.locator('.devsite-result-item-link').click();

// Locate the full title with a unique string.
const textSelector = await page
  .locator('::-p-text(Customize and automate)')
  .waitHandle();
const fullTitle = await textSelector?.evaluate(el => el.textContent);

// Print the full title.
console.log('The title of this blog post is "%s".', fullTitle);

await browser.close();