Puppeteer Scraper avatar
Puppeteer Scraper

Pricing

Pay per usage

Go to Store
Puppeteer Scraper

Puppeteer Scraper

apify/puppeteer-scraper

Developed by

Apify

Maintained by Apify

Crawls websites with the headless Chrome and Puppeteer library using a provided server-side Node.js code. This crawler is an alternative to apify/web-scraper that gives you finer control over the process. Supports both recursive crawling and list of URLs. Supports login to website.

5.0 (5)

Pricing

Pay per usage

116

Monthly users

601

Runs succeeded

>99%

Response time

30 days

Last modified

10 months ago

You can access the Puppeteer Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

1# Start Server-Sent Events (SSE) session and keep it running
2curl "https://actors-mcp-server.apify.actor/sse?token=<YOUR_API_TOKEN>&actors=apify/puppeteer-scraper"
3
4# Session id example output:
5# event: endpoint
6# data: /message?sessionId=9d820491-38d4-4c7d-bb6a-3b7dc542f1fa

Using Puppeteer Scraper for headless Chrome via Model Context Protocol (MCP) server

MCP server lets you use Puppeteer Scraper for headless Chrome within your AI workflows. Send API requests to trigger actions and receive real-time results. Take the received sessionId and use it to communicate with the MCP server. The message starts the Puppeteer Scraper for headless Chrome Actor with the provided input.

1curl -X POST "https://actors-mcp-server.apify.actor/message?token=<YOUR_API_TOKEN>&session_id=<SESSION_ID>" -H "Content-Type: application/json" -d '{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "method": "tools/call",
5  "params": {
6    "arguments": {
7      "startUrls": [
8            {
9                  "url": "https://crawlee.dev"
10            }
11      ],
12      "globs": [
13            {
14                  "glob": "https://crawlee.dev/*/*"
15            }
16      ],
17      "pseudoUrls": [],
18      "excludes": [
19            {
20                  "glob": "/**/*.{png,jpg,jpeg,pdf}"
21            }
22      ],
23      "linkSelector": "a",
24      "pageFunction": "async function pageFunction(context) {\\n    const { page, request, log } = context;\\n    const title = await page.title();\\n    log.info(`URL: ${request.url} TITLE: ${title}`);\\n    return {\\n        url: request.url,\\n        title\\n    };\\n}",
25      "proxyConfiguration": {
26            "useApifyProxy": true
27      },
28      "initialCookies": [],
29      "waitUntil": [
30            "networkidle2"
31      ],
32      "preNavigationHooks": "// We need to return array of (possibly async) functions here.\\n// The functions accept two arguments: the \\"crawlingContext\\" object\\n// and \\"gotoOptions\\".\\n[\\n    async (crawlingContext, gotoOptions) => {\\n        const { page } = crawlingContext;\\n        // ...\\n    },\\n]",
33      "postNavigationHooks": "// We need to return array of (possibly async) functions here.\\n// The functions accept a single argument: the \\"crawlingContext\\" object.\\n[\\n    async (crawlingContext) => {\\n        const { page } = crawlingContext;\\n        // ...\\n    },\\n]",
34      "customData": {}
35},
36    "name": "apify/puppeteer-scraper"
37  }
38}'

The response should be: Accepted. You should received response via SSE (JSON) as:

1event: message
2data: {
3  "result": {
4    "content": [
5      {
6        "type": "text",
7        "text": "ACTOR_RESPONSE"
8      }
9    ]
10  }
11}

Configure local MCP Server via standard input/output for Puppeteer Scraper for headless Chrome

You can connect to the MCP Server using clients like ClaudeDesktop and LibreChat or build your own. The server can run both locally and remotely, giving you full flexibility. Set up the server in the client configuration as follows:

1{
2  "mcpServers": {
3    "actors-mcp-server": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "@apify/actors-mcp-server",
8        "--actors",
9        "apify/puppeteer-scraper"
10      ],
11      "env": {
12        "APIFY_TOKEN": "<YOUR_API_TOKEN>"
13      }
14    }
15  }
16}

You can further access the MCP client through the Tester MCP Client, a chat user interface to interact with the server.

To get started, check out the documentation and example clients. If you are interested in learning more about our MCP server, check out our blog post.

Pricing

Pricing model

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage.