Skip to main content

CAPTCHA guide

Capy Puzzle

Japanese jigsaw slider with predictable behaviour and coordinate-based answers.

Difficulty: Below average
Image puzzle
Exploded concept drawing of how the Capy Puzzle challenge is built

Capy, from capy.me in Japan, is best known for its jigsaw challenge: drag the loose piece into the spot where it completes the picture. A text CAPTCHA is also available. The widget behaves consistently from one load to the next, so it is one of the gentler slider puzzles to automate.

How to identifyLink to How to identify

  • A jigsaw with a draggable piece and a prompt like "Drag the puzzle piece"
  • A public key beginning with PUZZLE_ (for example PUZZLE_sample...)
  • Calls to api.capy.me or a regional host such as jp.api.capy.me
  • Form fields named capy_captchakey, capy_challengekey and capy_answer
  • A server-only private key beginning with KEY_, never exposed to the browser
  • An optional "onetime" mode bound to a username or cookie

How it worksLink to How it works

  1. The page requests a puzzle with its public key and receives a capy_challengekey.
  2. As the piece is dragged, the browser records coordinates into capy_answer (something like 10,20,30,40,).
  3. The site's server posts capy_challengekey, capy_privatekey and capy_answer to https://jp.api.capy.me/puzzle/verify or its regional equivalent.
  4. A correct answer returns true. A wrong one returns an error such as incorrect-answer or invalid-challenge-key.
  5. Some sites use the text endpoint (gimpy/verify) instead, sometimes combined with the one-time mode.

Free bypass methodsLink to Free bypass methods

Method What it does Success Rate Link
OpenCV template matching Locates the gap and the piece before dragging 85-95% opencv/opencv-python
PuzzleSolver Gap detection with OpenCV plus a human-style drag 85-95% vsmutok/Puzzle-Captcha-Solver
ddddocr Backup recogniser for the piece and the gap 75-90% sml2h3/ddddocr
DrissionPage Runs the widget and its callbacks in a real browser 80-90% g1879/DrissionPage
Patchright Stealth Playwright for flows tied to a session 75-90% Kaliiiiiiiiii-Vinyzu/patchright-python

Slider pipelineLink to Slider pipeline

  1. Grab the background image and the piece.
  2. Trim transparent and blank borders, then extract edges.
  3. Slide the piece over the background with TM_CCOEFF_NORMED; the strongest match marks the gap.
  4. Convert that offset to the slider's real pixel width.
  5. Drag with an eased start and stop, 2 to 5 px of jitter and a slight overshoot.
  6. Submit while keeping the same session and cookies.

Practical tipsLink to Practical tips

  • The answer is a list of coordinates. If you rebuild the request yourself, copy the widget's format exactly.
  • capy_challengekey is bound to the page session, so keep that session alive.
  • Many sites inspect the drag path and its timing: avoid straight, constant-speed moves.
  • Verification happens server-side with a private key. Only a correct answer passes, and true cannot be faked.
  • When the one-time mode is on, use the same username or cookie for the whole flow.

Skip the solver: let BrowserSolver handle Capy Puzzle

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.