Skip to main content

CAPTCHA guide

CutCaptcha

Cut-out puzzle common on download sites, with no public documentation.

Difficulty: Medium
Image puzzle
Exploded concept drawing of how the CutCaptcha challenge is built

CutCaptcha is a puzzle in which the visitor finds the right cut-out fragment and fits it back into the picture. You mostly meet it on file-sharing and download sites such as Filecrypt, and therefore inside download managers like JDownloader. There is no public documentation, so everything known about its parameters comes from studying live deployments.

How to identifyLink to How to identify

  • The challenge runs inside an <iframe>, and the page defines a global CUTCAPTCHA_MISERY_KEY
  • That key is a 40-character hex string, the length of a SHA-1 hash (for example 56a9e9b989aa8cf99e0cea28d4b4678b84fa7a4e)
  • The iframe's document.body carries an 8-character data-apikey, such as SAb83IIB
  • The included JS file is often named after that same API key
  • The result lands in input#cap_token, with a capResponseCallback(token) callback
  • Frequently seen on Filecrypt download-container pages

How it worksLink to How it works

  1. The page embeds the widget in an iframe and exposes CUTCAPTCHA_MISERY_KEY.
  2. The widget shows a picture with a missing fragment to pick and place.
  3. A correct answer gives the client a token.
  4. The token goes into input#cap_token, or is handed to capResponseCallback, and the form is sent.
  5. Validation happens on the site's backend. There is no public siteverify endpoint you could call.

Free bypass methodsLink to Free bypass methods

Method What it does Success Rate Link
DrissionPage Solves in a real browser and injects the token 70-85% g1879/DrissionPage
OpenCV Matches fragments against the gap 70-85% opencv/opencv-python
ddddocr Backup recogniser for the pieces 60-80% sml2h3/ddddocr
Patchright Stealth Playwright for working inside the iframe 65-85% Kaliiiiiiiiii-Vinyzu/patchright-python
JDownloader + solver plugin Existing integrations already cover CutCaptcha varies JDownloader

Practical approachLink to Practical approach

  1. Note the full page URL, including the path that loads the CAPTCHA. The bare domain is not enough.
  2. Read CUTCAPTCHA_MISERY_KEY from the page's JavaScript context.
  3. Find the API key in the iframe body's data-apikey, or in the name of the included JS file.
  4. Work out the right fragment and move it into place along a natural-looking path.
  5. Put the token into input#cap_token and submit, or call capResponseCallback(token) if the page defines it.

Practical tipsLink to Practical tips

  • There is no data-sitekey here, so don't go looking for one.
  • A cross-origin iframe hides its body from you. In that case, take the API key from the JS filename.
  • Everything depends on one host. When v2.cutcaptcha.net is down or its certificate has expired, the CAPTCHA simply doesn't load, as happened in June 2024.
  • cutcaptcha.com is a parked domain and offers no documentation.
  • The token belongs to the challenge session, so keep cookies and session intact until you submit.

Skip the solver: let BrowserSolver handle CutCaptcha

Website AntiBot runs a real browser session with matching TLS, headers, cookies and IP, clears the challenge, and returns the page. You send a URL, you get HTML back.

For education and authorized testing only. Respect the law, privacy, and the terms of the sites you work with. Difficulty labels are editorial estimates. Adapted from the CC0 community field guide on GitHub.