CDP API

Overview

Scrapeless Scraping Browser extends the standard CDP (Chrome DevTools Protocol) functionality with a series of powerful custom functions to enhance browser automation capabilities. This documentation primarily covers CDP functions related to CAPTCHA handling.

Captcha Solver Features

Feature Overview

Scraping Browser includes advanced CAPTCHA solution capabilities that can automatically handle mainstream CAPTCHA types appearing on web pages.

Supported CAPTCHA Types

reCaptcha

Cloudflare Turnstile

Event Monitoring Mechanism

Core Events

Scraping Browser provides three core events to monitor the CAPTCHA solving process:

Event Name	Description
`Captcha.detected`	CAPTCHA detected
`Captcha.solveFinished`	CAPTCHA solved
`Captcha.solveFailed`	CAPTCHA solve failed

Event Response Data Structure

Field	Type	Description
`type`	string	CAPTCHA type: `recaptcha` `turnstile`
`success`	boolean	Solution result
`message`	string	Status message: `"NOT_DETECTED"` `"SOLVE_FINISHED"` `"SOLVE_FAILED"` `"INVALID"`
`token?`	string	Token returned on success (optional)

Implementation Examples

Node.js (Puppeteer)

Python (Playwright)

Advanced Configuration API

Scraping Browser provides a series of advanced APIs for fine-grained control over the CAPTCHA solver's behavior. Here are the supported APIs:

API Name	Description
`Captcha.setAutoSolve`	Control automatic CAPTCHA solving behavior
`Captcha.setToken`	Set authentication token for CAPTCHA service
`Captcha.setConfig`	Configure all CAPTCHA solver parameters
`Captcha.solve`	Manually trigger CAPTCHA solving process

Detailed API Description

1. `Captcha.setAutoSolve`

Configuration interface to control automatic CAPTCHA solving behavior.

Node.js (Puppeteer)

Python (Playwright)

2. `Captcha.setToken`

Set authentication token for CAPTCHA solving service.

Node.js (Puppeteer)

Python (Playwright)

3. `Captcha.setConfig`

Configure all parameters for the CAPTCHA solver.

Node.js (Puppeteer)

Python (Playwright)

4. `Captcha.solve`

Manually trigger CAPTCHA solving process.

Node.js (Puppeteer)

Python (Playwright)

5. `Agent.click`

Simulates a mouse click.

Node.js (Puppeteer)

Python (Playwright)

Overview#

Captcha Solver Features#

Feature Overview#

Supported CAPTCHA Types#

Event Monitoring Mechanism#

Core Events#

Implementation Examples#

Advanced Configuration API#

Detailed API Description#

1. Captcha.setAutoSolve#

2. Captcha.setToken#

3. Captcha.setConfig#

4. Captcha.solve#

5. Agent.click#

Overview

Captcha Solver Features

Feature Overview

Supported CAPTCHA Types

Event Monitoring Mechanism

Core Events

Implementation Examples

Advanced Configuration API

Detailed API Description

1. `Captcha.setAutoSolve`

2. `Captcha.setToken`

3. `Captcha.setConfig`

4. `Captcha.solve`

5. `Agent.click`