Skip to main content

CAPTCHA guide

Tencent Captcha

Tencent's slider and click-in-order challenges, closely tied to Chinese IPs.

Difficulty: Medium
Risk engineImage puzzle
Exploded concept drawing of how the Tencent challenge is built

Tencent Captcha, also called 腾讯防水墙 or TCaptcha, protects Tencent's own products and many other Chinese platforms: QQ, the WeChat ecosystem, games and online shops. Visitors usually get a slider puzzle, a "click the characters in order" task, or a single-click behavioural check.

Challenge typesLink to Challenge types

  • Slider puzzle: move the piece into the gap
  • Icon click: tap the requested characters or icons in sequence
  • One-click: a behavioural check with no puzzle
  • Invisible: background scoring for low-risk visitors

How to identifyLink to How to identify

  • The script https://turing.captcha.qcloud.com/TCaptcha.js or https://ssl.captcha.qq.com/TCaptcha.js
  • A global TencentCaptcha constructor, used as new TencentCaptcha(appId, callback)
  • Parameters named aid, appid, sess, ticket and randstr
  • Requests to turing.captcha.qcloud.com or captcha.qq.com
  • Tencent / 腾讯 branding and a Chinese interface
  • Hidden ticket and randstr fields sent with the form

How it worksLink to How it works

  1. The page creates a TencentCaptcha instance with its app ID.
  2. The widget asks Tencent for a challenge (sess, aid).
  3. After the visitor solves it, the client sends the encrypted result and gets back a ticket and a randstr.
  4. The site forwards ticket and randstr, and its backend checks them with Tencent.
  5. A ticket works once and only for a limited time. Recent versions encrypt more of the payload.

Free bypass methodsLink to Free bypass methods

Method What it does Success Rate Link
OpenCV Finds the slider gap by template matching or edge detection 75-90% opencv/opencv-python
PuzzleSolver OpenCV gap detection with a human-style drag 75-90% vsmutok/Puzzle-Captcha-Solver
ddddocr OCR and object recognition for icon-click tasks 70-85% sml2h3/ddddocr
DrissionPage Real Chromium that handles the widget's callbacks 70-85% g1879/DrissionPage
Patchright / Camoufox Stealth browsers for the one-click and invisible modes 65-85% Kaliiiiiiiiii-Vinyzu/patchright-python
YOLOv8 Detects icons for click-in-order tasks 75-90% (with a trained model) ultralytics/ultralytics

Slider pipelineLink to Slider pipeline

  1. Grab the background and the piece, whether drawn on a canvas or loaded as images.
  2. Locate the gap with template matching (TM_CCOEFF_NORMED) or edge detection.
  3. Convert the distance to the real width of the slider.
  4. Drag with an eased start and stop, a slight overshoot and 2 to 5 px of jitter.
  5. Wait for the success callback, then read ticket and randstr.

Icon-click pipelineLink to Icon-click pipeline

  1. Read the instruction, for example "请依次点击:猫、树、车".
  2. Find the candidate icons with YOLO or template matching.
  3. Click them in the order asked, with believable pauses in between.
  4. Confirm, then collect the ticket.

Practical tipsLink to Practical tips

  • Tencent analyses the drag path: a straight move at constant speed gets flagged.
  • It favours Chinese IPs and genuine browsers. Foreign datacenter addresses get harder puzzles or endless loops.
  • Each ticket is single-use, so never submit it twice.
  • Newer widgets encrypt sess, aid and more. Letting a real browser run the official script is sturdier than rebuilding the flow by hand.
  • In one-click or invisible mode, the fingerprint and behaviour are what matter, not puzzle-solving.

Skip the solver: let BrowserSolver handle Tencent

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.