pptr.dev

•

API Key

About Puppeteer

Puppeteer is a Google-maintained open-source Node.js library that provides a high-level API for controlling Chromium and Firefox browsers programmatically. It is widely used for automated UI testing, web scraping of JavaScript-rendered pages, screenshot and PDF generation, and network request interception. Starting from version 23, it added support for Firefox via the WebDriver BiDi protocol. Puppeteer is a library, not a managed service, so teams must provision their own infrastructure for scheduled or parallel execution.

AI Agent Use Cases

- Headless and headful Chrome and Firefox browser control

- Web scraping of JavaScript-rendered dynamic pages

- Automated screenshot and PDF generation

- Network request interception and mocking

- Form submission and UI interaction simulation

- WebDriver BiDi protocol support for cross-browser automation (v23+)

Available Actions

These are the specific actions that AI agents can perform with this tool

Add Script Tag

1 input

Add a new script tag to a webpage

Inputs

options

Options for the script including the script's URL or inline content.

Add Script Tag to Page

1 input

Injects a script tag with a specified URL or content into the webpage

Inputs

options

Options for the script to be added, including URL or content.

Close Page

1 input

The endpoint should close a Puppeteer page instance, optionally running the beforeunload handlers.

Inputs

options

An optional parameter that determines if beforeunload handlers should run before closing the page.

Element Click

2 inputs

Click on a specific element on a webpage given its selector

Inputs

selector

CSS selector or Puppeteer-specific selector syntax to identify the element to be clicked on the webpage. If multiple elements match, the first will be clicked.

options

Optional object to specify click options.

Find Element by Selector

1 input

Find the first element on the page that matches a CSS selector

Inputs

selector

The selector of the element you are attempting to find on the page.

Find First Element

1 input

Find the first HTML element on the page that matches a specific CSS selector.

Inputs

selector

The CSS selector to match the element against.

Find Multiple Elements

1 input

Find all elements matching a specific CSS selector on a webpage.

Inputs

selector

A CSS selector string to find elements on the webpage.

Page Close

1 input

Close the browser page with optional unload handling

Inputs

options

A dictionary that may include a 'runBeforeUnload' boolean, which when true, will run the beforeunload handlers.

Page Element Click

2 inputs

Automates the clicking of a webpage element specified by a CSS selector.

Inputs

selector

CSS selector to identify the element on the page to be clicked. Allows complex selectors with text and XPath queries.

options

Optional parameters for the click action, such as delay and button type. It's an object containing click configurations.

Search Elements By Selector

1 input

Find all elements matching a CSS selector on a webpage

Inputs

selector

The CSS selector to match elements against on the page