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 examplePUZZLE_sample...) - Calls to
api.capy.meor a regional host such asjp.api.capy.me - Form fields named
capy_captchakey,capy_challengekeyandcapy_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
- The page requests a puzzle with its public key and receives a
capy_challengekey. - As the piece is dragged, the browser records coordinates into
capy_answer(something like10,20,30,40,). - The site's server posts
capy_challengekey,capy_privatekeyandcapy_answertohttps://jp.api.capy.me/puzzle/verifyor its regional equivalent. - A correct answer returns
true. A wrong one returns an error such asincorrect-answerorinvalid-challenge-key. - 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
- Grab the background image and the piece.
- Trim transparent and blank borders, then extract edges.
- Slide the piece over the background with
TM_CCOEFF_NORMED; the strongest match marks the gap. - Convert that offset to the slider's real pixel width.
- Drag with an eased start and stop, 2 to 5 px of jitter and a slight overshoot.
- 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_challengekeyis 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
truecannot be faked. - When the one-time mode is on, use the same username or cookie for the whole flow.