Recognize hCaptcha
🔗 Original page — Source for this material
Description
This captcha is currently not recognized.
Added in ZennoPoster 7.5.0.0
Allows you to pass verification on sites protected from bots. This method is only suitable for hCaptcha type captchas.
How to add the action to your project?
Via the context menu Add action → Tabs → Recognize hCaptcha
Or use the ❗→ smart search.
What is this used for?
- Completing registrations
- Parsing websites and search engines
- Performing bulk actions
How to work with the action?
Main settings
- Choose the captcha recognition module. Select the desired captcha recognition service from the dropdown list (you need to specify its ❗→ API key in the settings first).
- ❗→ Captcha service settings.
- Set CapMonster.Cloud as the default service.
- Register an account on CapMonster.Cloud. All ZennoPoster license holders receive $5 free on their captcha solving balance.
hCaptcha interception
Added in ZennoPoster 7.5.1.0
When interception is enabled, you will not be able to solve hCaptcha manually.
The “Start hCaptcha interception” and “Stop hCaptcha interception” options are needed for using autosubmit when solving in a tab. These are not required if you are not using autosubmit, or if you are solving via sitekey. The most correct (and recommended) way to use these blocks is to enable interception immediately before navigating to the page with hCaptcha, and disable it right after completing the target hCaptcha. However, technically, nothing prevents you from enabling hCaptcha interception at the very beginning of your project so it stays active throughout.
Start hCaptcha interception
You should use this action before navigating to the page with hCaptcha, as it takes effect on the following navigation. While interception is active, you can solve hCaptcha in the tab using autosubmit. Please note, this is about changing the URL in the address bar: if, for example, after clicking a button in the browser the page content changes and hCaptcha appears, but the address bar doesn't change, it's still the same page. So, in this case, you need to start interception before navigating to that page (not right before clicking the button in the browser).
Stop hCaptcha interception
This action is used during the next navigation. It disables hCaptcha interception.
hCaptcha solving in a tab
The solving takes place directly in the browser window.
Recognition method
Select the appropriate function (Recognize hCaptcha) and method (In tab).
Use project proxy
The current project proxy will be sent to the solving service along with the captcha.
Use project cookies
Project cookies will be sent to the service along with the captcha.
Tab
Select where you want to solve the captcha:
a) Active — the tab currently in front of you.
b) First — the first window from the left.
c) By name — specify the tab name or variable (case sensitive).
d) By number — set the tab number. Numbering starts from the left, beginning at 0.
Perform autosubmit
Added in ZennoPoster 7.5.1.0
Perform autosubmit for the received token. For this option to work correctly, you need to enable hCaptcha interception before navigating to the page with the captcha (as described above).
Save job ID to variable
The variable for the job identifier.
hCaptcha solving via sitekey
The process takes place without loading the browser.
Recognition method
Select the appropriate function (Recognize hCaptcha) and method (Via SiteKey).
Use project proxy
The current project proxy will be sent to the solving service along with the captcha.
Use project cookies
Project cookies will be sent to the service along with the captcha.
SiteKey
The hCaptcha site key.
The Sitekey parameter is individual for every site.
How to get the SiteKey
- In the page source code ❗→ DOM
- In the ❗→ traffic window while the page is loading
Click on the request and check the full address in the “Headers” tab
URL
The full address of the page where hCaptcha is being solved.
Save job ID to variable
The variable for the job identifier.
Save to variable
The service’s response — the solved hCaptcha token — will be saved to the specified variable.
Token submission examples
Sending the Token in the browser
After receiving the token, you need to insert it into the relevant field. For hCaptcha, there are usually two such fields.
Let’s see how to locate the field in the browser.
Open the ❗→ Element Tree and find the (textarea) fields inside the captcha.
Right-click each text field to open the context menu and select To Action Builder. ** You may need to slightly adjust the element search filter each time, since the ending may be unique for each page load. Remove the ending in the “Value” field and switch the search type to regexp.
You need to insert the obtained token into these fields. You can do this using the ❗→ Set Value action.
Sending the Token to the server via requests
Once the captcha is successfully solved, the response containing the token will be saved to a variable for sending to the server. You need to include it in the request — most often as two arguments with the same value: g-recaptcha-response and h-captcha-response
You can always check an example request in the ❗→ traffic window
Error report
Allows you to get your money back in case of an unsuccessful captcha solving attempt.
Job ID is specified as a static value or via a variable.
Success report
Report to the service that the captcha was successfully solved.
Job ID is specified as a static value or via a variable.
Usage example
When you land on a page with anti-bot, the system asks you to confirm you are not a robot.
- To use autosubmit, start hCaptcha interception before going to the target page.
- Go to the page.
- Add the "solve hCaptcha" action to your project.
- Configure the block.
- Pass the site’s verification.
- Disable hCaptcha interception (optional).
Currently, many resources use hCaptcha for protection. It helps sites block bulk actions or detect bots, but thanks to ZennoPoster’s features, passing such checks is easy.