Skip to main content

CAPTCHA guide

Yandex SmartCaptcha

Yandex's checkbox with image fallbacks and a short-lived, IP-bound token.

Difficulty: Medium
Risk engine
Exploded concept drawing of how the Yandex SmartCaptcha challenge is built

Yandex SmartCaptcha protects Yandex Cloud customers and a large share of Russian-language sites. It shows a checkbox driven by a risk engine and escalates to an image task when a session looks suspicious. The widget itself is tiny, but its token expires fast and is tied to the site key, so the server has to verify it promptly.

How to identifyLink to How to identify

  • A <div class="smart-captcha" data-sitekey="..."> container
  • The script https://smartcaptcha.yandexcloud.net/captcha.js (or captcha.yandexcloud.net)
  • A checkbox labelled "I'm not a robot" or «Я не робот»
  • A hidden smart-token input
  • Image tasks with distorted text or objects to select
  • data-callback and data-hl (language) attributes

How it worksLink to How it works

  1. The widget fetches a challenge for the site key and draws the checkbox.
  2. When the visitor interacts, Yandex weighs browser and network signals and may add an image task.
  3. The resulting token is written to the hidden smart-token input.
  4. The site's backend validates it by POSTing to https://smartcaptcha.cloud.yandex.ru/validate:
secret=YOUR_SERVER_KEY
token=SMART_TOKEN
ip=USER_IP
host=example.com # optional
  1. A pass comes back as status: "ok". A failure returns status: "failed" and a message.
  2. Tokens work once and last about 5 minutes. Reusing one, or validating it from another IP or host, gets it rejected.

Free & open-source bypass methodsLink to Free & open-source bypass methods

Tool What it does Success Rate Link
Real browser (Playwright/DrissionPage) Ticks the checkbox and reads smart-token; the widget handles the rest 80–95% g1879/DrissionPage
Patchright / Camoufox Stealth browsers for sessions that keep getting image tasks 60–85% Kaliiiiiiiiii-Vinyzu/patchright-python · daijro/camoufox
ddddocr / EasyOCR Reads the text-image fallback 60–85% sml2h3/ddddocr · JaidedAI/EasyOCR
YOLOv8 Finds the objects in selection tasks 80–95% (trained) ultralytics/ultralytics

Practical approachLink to Practical approach

  1. For a Russian audience, give the browser a Russian language setting and timezone.
  2. Open the page and wait until the .smart-captcha container is drawn.
  3. Move the mouse naturally before ticking the box. Instant scripted clicks look wrong.
  4. If an image task shows up, solve it with OCR or object detection and confirm.
  5. Read smart-token just before submitting, and make sure validation happens from the same IP.
  6. Leave the widget alone once the token exists: refreshing it throws the token away.

Practical tipsLink to Practical tips

  • The ip passed to server validation has to match the visitor's IP. A mismatch is one of the most common reasons for failed.
  • host must be the domain registered for the site key.
  • Sites can run the widget invisibly. In that case, simply wait for smart-token to appear.
  • Each failure makes the next task harder, so after a few, restart with a new profile and a new IP.
  • SmartCaptcha is uncommon outside Russian-speaking sites, and consistent locale signals count for more here than with global providers.

Skip the solver: let BrowserSolver handle Yandex SmartCaptcha

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.