Skip to main content

Util::Turnstile - Cloudflare Turnstile CAPTCHA recognition

Overview of the scraper

This scraper is used only as a plug-in component in other scrapers where it may be necessary to solve Cloudflare Turnstile captchas, such as Ahrefs scrapers, as well as custom JavaScript scrapers.

The principle of operation of this scraper is to send Turnstile data (usually the sitekey and the URL of the page where the Turnstile captcha was received) to a solving service and receive a token consisting of numbers and letters in response. The correctness of the solving depends only on the solving service; typically, services almost always solve Turnstile correctly.

Capabilities

  • It supports working with the following services: AntiCaptcha, RuCaptcha, 2captcha, CapMonster.cloud, CapSolver, captchas.io
  • Ability to configure response timeout and status check delay
  • Ability to solve captcha without using services. To enable this feature, in Provider you must select Auto (using Chrome). Chrome (puppeteer) is used for solving; consider this when configuring the number of threads.

Use Cases

  • Bypassing Cloudflare Turnstile in scrapers where it is optionally or strictly necessary to solve this type of captcha to get results

Queries

The scraper accepts two types of queries:

  • sitekey url
  • sitekey url proxy user-agent

Parameters are separated by a space and mean:

  • sitekey - the Turnstile sitekey
  • url - the page where Turnstile is located
  • proxy - the proxy through which the Cloudflare Turnstile was received. The parameter must be in the format login:pass@ip:port@type for proxies with authorization or ip:port@type for proxies without authorization
    • type can be http, https, socks4, socks5
  • user-agent - the user-agent with which Turnstile was received

Output Results Examples

  • $resp - Cloudflare Turnstile response (token)
  • $error - If an error occurred, its description

Cloudflare Turnstile token output

Result format:

$resp

Example result:

0.uM0rQLy_vdWZNwOml8TMpvPgtXuqMs3H_2A7D5txxc27kHNFcGh2UOS1MQ82GiF3Dd6-VyOEgdBf1Ef3Q6xjwRYZH3V8YJdv4wgxfTtyH5stVsBOP6qWrE0Zu-txfDmJIJ_THkeK8wrYODLwj3p948zdiufJScERCVhsx1aPIurXAidPWhJslVutd4uTbMAvuGcYg7Nj-wwbW6VKGuofBHIx116Xt7_9eXISzWFy5se95e2FYVY4n4oGU3xSkoUnUCw0fcBMBP8Vik8Qde-qd53mc7YAGKeRKj9yV0t2erTc4i9ZeRjR22Fxm1nN_SkbdAHjj-oATJmxyfMAFoT_MEwe2WliuvuoPrkCAZYe8S0.QqD0sL8h2B_8jYaa792YPA.04643a6fbd94c593eee9770924ddefbd6d227e84dcfca973ab840728c122fc5d

Possible settings

The Provider parameter is used to select the service.

ParameterDefault valueDescription
Client keyClient key for online solving services
Provider urlProvider URL, allows overriding the domain. Multiple URLs can be specified with commas; the scraper will use each randomly. Can be empty; the scraper automatically uses the correct one based on the chosen solving service
ProviderAntiCaptchaSolving service
Wait between get status5Delay between status checks
Max wait time300Maximum solving wait time
Threshold % for Capmonster.Cloud0Confidence threshold (used only in capmonster.cloud)