Software Development & Delivery · Preview

puppeteer

JavaScript API for Chrome and Firefox

Best fitUsers who want source-backed project understanding before installing it.

Check whether this project matches your task before installing it.

What it can doskill, recipe, host_instruction, eval, preflight

Review the portable capability path.

Before continuingVerify in a sandbox

Do not treat a preview pack as a proven local install.

GitHub snapshot94k stars

9.4k forks · 553 contributors

Official first step Read manual preview Source repository

Preview status · 2026-05-16

What is puppeteer?

Puppeteer is a Node.js library that provides a high-level API to control Chrome, Firefox, or other browsers via the DevTools Protocol and WebDriver BiDi. It enables developers to automate ...
Best fit: Users who want source-backed project understanding before installing it.
Capability added to an AI workflow: skill, recipe, host_instruction, eval, preflight
Evidence base: https://github.com/puppeteer/puppeteer, https://github.com/puppeteer/puppeteer, https://github.com/puppeteer/puppeteer#readme
Preview pages are noindex until English quality, canonical, and citation gates pass.
puppeteer still needs sandbox verification before production use.

Quick decision

Use this section to decide whether the project is worth a deeper read.

Best forUsers who want source-backed project understanding before installing it.

Match the project to your task before installing it.

Capabilityskill, recipe, host_instruction, eval, preflight

JavaScript API for Chrome and Firefox

Repositorypuppeteer/puppeteer

94k stars · 9.4k forks

What it can do

Translate the upstream project into concrete capabilities the user can judge before installing.

Getting Started

System Architecture

Related topics: Package Structure, CDP Implementation, WebDriver BiDi Implementation

Sources: [packages/puppeteer-core/src/index.ts](https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/index.ts)

Package Structure

Related topics: System Architecture, Browser Launching

Source: https://github.com/puppeteer/puppeteer / Human Manual

Protocol Implementations

Related topics: CDP Implementation, WebDriver BiDi Implementation

Source: https://github.com/puppeteer/puppeteer / Human Manual

CDP Implementation

Related topics: System Architecture, Page API

Sources: [packages/puppeteer-core/src/cdp/Connection.ts:1-50]()

Sources: https://github.com/puppeteer/puppeteer, Human Manual, Project Pack evidence, and downstream validation signals.

Community Discussion Evidence

Project-level external discussion stays visible on the detail page, not only inside the manual.

Stars94k stars

Forks9.4k forks

Contributors553 contributors

Licenseunknown

Community Discussion Evidence

12 source-linked items

Review these external discussions before using puppeteer with real data or production workflows. They are review inputs, not standalone proof that the project is production-ready.

01
[Bug]: GHSA issued a false malicious package alert for puppeteer
github / github_issue
02
Chrome Canary/Firefox Nightly test results
github / github_issue
03
[Bug]: `setViewport` crashes on Firefox if uncaught
github / github_issue
04
[Bug]: chrome binary is not present when installing latest chrome
github / github_issue
05
[Bug]: @puppeteer/browsers silently corrupts Chrome cache on Node.js 26
github / github_issue
06
[Task]: Flaky `[fixtures.spec] Fixtures should dump browser process stde
github / github_issue
07
[Feature]: Reducing dependencies
github / github_issue
08
[Feature]: Make proxy-agent dependency optional
github / github_issue
09
Puppeteer v25
github / github_issue
10
puppeteer-core: v25.0.2
github / github_release
11
browsers: v3.0.2
github / github_release
12
puppeteer-core: v25.0.1
github / github_release

How to start

Only source-backed commands are shown here. Verify them in an isolated environment first.

Try the prompt first

Test the workflow without installing the upstream project.

preview

Read the Human Manual

Understand inputs, outputs, limits, and failure modes.

manual

Take context to your AI host

Use the compiled assets in your preferred AI environment.

context

Run sandbox verification

Confirm install commands and rollback before using a primary environment.

verify

npm i puppeteer

Official start command · https://github.com/puppeteer/puppeteer#readme · verified: yes

Human Manual

The English page must expose the real manual, not a short placeholder.

8+ sections · Human Manual

puppeteer Manual

Puppeteer is a Node.js library that provides a high-level API to control Chrome, Firefox, or other browsers via the DevTools Protocol and WebDriver BiDi. It enables developers to automate ...

Open the full manual

puppeteer Human Manual
Table of Contents
Getting Started
Related Pages
Overview
Installation
Prerequisites
System Requirements by Browser

Getting Started

System Architecture

Related topics: Package Structure, CDP Implementation, WebDriver BiDi Implementation

Sources: [packages/puppeteer-core/src/index.ts](https://github.com/puppeteer/puppeteer/blob/main/packages/puppeteer-core/src/index.ts)

Package Structure

Related topics: System Architecture, Browser Launching

Source: https://github.com/puppeteer/puppeteer / Human Manual

Protocol Implementations

Related topics: CDP Implementation, WebDriver BiDi Implementation

Source: https://github.com/puppeteer/puppeteer / Human Manual

CDP Implementation

Related topics: System Architecture, Page API

Sources: [packages/puppeteer-core/src/cdp/Connection.ts:1-50]()

AI Context Pack and portable assets

After deciding to continue, take the project context into your own AI host.

Complete pack plus user-owned assets

These files are planning and verification assets for Claude Code, Codex, Gemini, Cursor, ChatGPT, and other AI hosts.

Download complete pack Read Human Manual

BundleComplete Project Pack AssetAI Context Pack AssetBoundary & Risk Card AssetHuman Manual AssetPitfall Log AssetPrompt Preview AssetQuick Start ManifestPROJECT_PACK.json

Preflight checks

Treat this preview as a planning asset, not proof that your local environment is ready.

The manual is generated from source-linked project files and Doramagic validation signals.
Community evidence warnings stay visible instead of being converted into marketing claims.
The preview remains noindex until English quality and reciprocal indexing gates are explicitly opened.
Use the upstream repository as the final authority for installation commands, license, and version-specific behavior.