Skip to main content

Util::ReCaptcha2 - reCAPTCHA recognition

Scraper overview

This scraper is used only as a plug-in component in other scrapers where it may be necessary to solve Google ReCaptcha v2, for example: SE::GoogleSE::Google, SE::Google::ImagesSE::Google::Images, SE::Google::ByImageSE::Google::ByImage, as well as custom JavaScript scrapers.

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

The process of connecting and configuring this scraper is described in detail in the article Recaptcha Settings

Scraper use cases

Example of setting up solving via Xevil

In Xevil, it is recommended to select the API type Antigate (Anti-Captcha). In the settings Util::ReCaptcha2Util::ReCaptcha2 in Provider url you need to specify ip:port Xevil:

Provider url in Xevil for the Util::ReCaptcha2 scraper

In Provider select Xevil (AntiGate):

Configuring the Provider url for the Util::ReCaptcha2 scraper

Capabilities

  • Support for the following services: AntiCaptcha, RuCaptcha, 2captcha, XEvil, CapMonster, CapMonster.cloud, CapSolver, captchas.io, NextCaptcha
  • Ability to configure response wait time and status check delay

Use cases

  • Recognition of recaptchas in built-in scrapers where solving captchas is optionally or mandatory required to obtain results
  • Recognition of recaptchas in custom JS scrapers

Queries

The scraper accepts two types of queries:

  • sitekey url
  • sitekey url proxy user-agent

Parameters are separated by a space and mean:

  • sitekey - this is the recaptcha sitekey
  • url - the page where the recaptcha is located
  • proxy - proxy through which the recaptcha 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 - user agent with which the recaptcha was received

Output results examples

  • $resp - recaptcha response
  • $error - if an error occurred, its description

Recaptcha token output

Result format:

$resp

Result example:

03AGdBq24qfVWiRMofkMHuxaaW024vkt2Oc4Nnt4WXs3PdV0fJlpDystp444u_rG8HvuJUgN3n-upnHJXeQODxHjn_X9JdRlKEzhDnatYyehxN00WDWN_37LKwdHOgER2TrdB7XBKqrz5rko_CGWea6R1Lfe3eKmkoOeHkTyn8H3ZI90wcSvZR8gSztvq5EZWpGdNgLq15w84F92-PR8S051gUH2Ls82An0N4iiAIcTFrOTQZizqfIjgVzCzqHhSaigIPGy6j8-3nt1sac7q6Xn26fKLsQzd4hZDmrlem5rNoK-IQHEb_AUJ6r4UxQZQ-z4hk9wPpzdeiCi81sxWEX5YI-cn4cWYFsoWutv_DYvZy87Iog7u1VELGWvjT3XwkY3MyDZzpUfauyCGSd5oouLDhV5YnRPfMm-gWQUSRpt28z5xbVbwGSAfmMLEpFboCgKZdUhb-IdAiKHGA4oSXB3RhOA9TQZR-ETVqyUG8A4wJEXdCvEHU7Uhw

Possible settings

The Provider parameter is used to select the service.

For online services (AntiCaptcha, RuCaptcha, 2captcha, CapMonster.cloud, CapSolver, captchas.io), you must set the parameter Client key.

ParameterDefault valueDescription
Client keyClient key for online solving services
Provider urlProvider URL, allows overriding the domain. You can specify several separated by commas, the scraper will use each of them in random order. Can be empty, the scraper automatically uses the required one depending on the selected solving service
ProviderAntiCaptchaSolving service
Wait between get status5Delay between status checks
Max wait time300Maximum solving wait time