Skip to content

Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠

20.3 KB
Raw Blame
<!doctype html>
<html lang="en" data-theme="dark">
<head>
  <meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
  <title>CAPTCHA solvers — WebBrain User Guide</title>
  <meta name="description" content="Set up seven optional CAPTCHA providers, weighted fallback, hCaptcha support and provider-specific solving methods.">
  <link rel="canonical" href="https://webbrain.one/docs/captcha/">
  <link rel="icon" href="/favicon.png"><script>try{document.documentElement.dataset.theme=localStorage.getItem('webbrain-theme')||'dark'}catch(_){}</script><link rel="stylesheet" href="/docs/assets/docs.css?v=20261028">
  <!-- Plausible analytics: start -->
  <!-- Privacy-friendly analytics by Plausible -->
  <script async src="https://157.230.3.9.sslip.io/js/pa-omp0F7DsOXM4sGKR50l7S.js"></script>
  <script>
    window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};
    plausible.init()
  </script>
  <!-- Plausible analytics: end -->
  <!-- Site footer styles: start -->
  <style>
    .wb-footer {
      --wb-footer-text: var(--text, var(--ink, #2c1810));
      --wb-footer-dim: var(--text-dim, var(--muted, #6b5b47));
      --wb-footer-line: var(--border, var(--line, rgba(89, 55, 25, 0.15)));
      margin: 0;
      padding: 0;
      border-top: 1px solid var(--wb-footer-line);
      background: var(--wb-footer-bg, none);
      color: var(--wb-footer-dim);
      font-size: 13px;
      line-height: 1.5;
      text-align: start;
    }
    .wb-footer-inner {
      width: var(--wb-footer-width, min(calc(100% - 48px), 1100px));
      margin: 0 auto;
      padding: 26px 0 30px;
      display: flex;
      flex-direction: column;
      gap: 18px;
    }
    /* Page links start on the brand's left edge; the social icons sit at
       the far end of the same row. */
    .wb-footer-row { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 14px 32px; }
    .wb-footer-brand { display: flex; flex-direction: column; gap: 5px; }
    .wb-footer-tagline { margin: 0; color: var(--wb-footer-text); font-size: 15px; font-weight: 700; line-height: 1.4; }
    .wb-footer-copy { margin: 0; }
    .wb-footer-copy a { color: var(--wb-footer-text); font-weight: 650; text-decoration: none; }
    .wb-footer-links { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; }
    .wb-footer-social { display: flex; align-items: center; gap: 8px; }
    .wb-footer-links a { color: var(--wb-footer-dim); font-weight: 600; text-decoration: none; }
    .wb-footer a:hover { color: var(--wb-footer-text); text-decoration: none; }
    .wb-footer a:focus-visible { outline: 2px solid currentColor; outline-offset: 3px; border-radius: 4px; }
    .wb-footer-icon { display: inline-flex; align-items: center; justify-content: center; width: 22px; height: 22px; margin: -4px 0; border-radius: 6px; }
    .wb-footer-icon:hover { background: color-mix(in srgb, currentColor 12%, transparent); }
    .wb-footer-icon svg { display: block; width: 15px; height: 15px; }
    /* Only shown without JavaScript, when the language picker can't run. */
    .wb-footer-languages { display: none; flex-wrap: wrap; gap: 6px 12px; width: 100%; direction: ltr; }
    .wb-footer-languages span { color: var(--wb-footer-text); font-weight: 700; }
    @media (max-width: 860px) {
      .wb-footer-inner { width: var(--wb-footer-width, calc(100% - 32px)); }
    }
  </style>
  <!-- Site footer styles: end -->
</head>
<body class="doc-page">
  <a class="skip-link" href="#main">Skip to content</a>
  <header class="site-header"><div class="header-inner"><a class="brand" href="/"><img src="/logo-github.png" alt=""><span>WebBrain</span><span class="brand-docs">User guide</span></a><nav class="top-nav" aria-label="Primary"><a href="/">Home</a><a href="/docs/" aria-current="page">Docs</a><a href="/blog/">Blog</a><a href="https://github.com/webbrain-one/webbrain">GitHub</a></nav><div class="header-tools"><button class="icon-button" type="button" data-theme-toggle aria-label="Use light theme">☀</button><button class="sidebar-toggle" type="button" data-sidebar-toggle aria-expanded="false" aria-label="Open documentation menu">☰</button></div></div></header>
  <div class="docs-shell">
    <aside class="docs-sidebar" aria-label="Documentation"><div class="sidebar-group"><div class="sidebar-label">Start here</div><nav><a href="/docs/">Overview</a><a href="/docs/faq/">FAQ</a></nav></div><div class="sidebar-group"><div class="sidebar-label">Use WebBrain</div><nav><a href="/docs/settings/">Settings, explained</a><a href="/docs/captcha/" aria-current="page">CAPTCHA solvers</a><a href="/docs/providers/">Providers & models</a><a href="/companion/">WebBrain Companion</a><a href="/docs/safety/">Modes, safety & privacy</a><a href="/docs/apocalypse-mode/">Apocalypse Mode</a><a href="/docs/formats/">Exports & workflows</a><a href="/docs/mcp/">MCP server</a><a href="/docs/lm-studio/">LM Studio plugin</a><a href="/docs/ollama/">Ollama</a></nav></div><div class="sidebar-group"><div class="sidebar-label">For builders</div><nav><a href="https://github.com/webbrain-one/webbrain/tree/main/docs">Technical docs ↗</a></nav></div><div class="sidebar-group"><div class="sidebar-label">Community</div><nav><a href="https://discord.gg/cgC325ssfw">Discord Support</a></nav></div></aside>
    <main class="doc-main" id="main">
      <div class="breadcrumb"><a href="/docs/">Docs</a> / CAPTCHA solvers</div>
      <section class="doc-hero"><div class="eyebrow">Optional · bring your own account</div><h1>CAPTCHA solvers and fallback</h1><p class="lede">Enable the services you want WebBrain to use, choose their order, and see which challenges each service supports.</p><div class="meta">API coverage checked September 29, 2026 · Chrome and Firefox</div></section>
      <section class="doc-section" id="setup"><h2>Set up a provider</h2><ol><li>Open <strong>Settings → CAPTCHA</strong>.</li><li>Enter a provider API key. Typing checks its enabled box; you can turn the box off while keeping the key.</li><li>Save the setting. Test checks the account balance without enabling or saving the provider.</li><li>Enable additional services if you want fallback. Each has its own checkbox.</li></ol><p>The provider’s collapsed <strong>Advanced</strong> section contains its weight. A higher weight means it is tried earlier. Equal weights retain the default order.</p></section>
      <section class="doc-section" id="providers"><h2>Providers and coverage</h2><p>All seven services have API integrations. Common widgets can use automatic detection; other methods need the challenge-specific inputs shown in their API documentation. A service being listed does not guarantee that a particular website accepts its answer.</p><div class="table-wrap"><p>CAPTCHA tools are available in Act and Dev with Mid or Full tiers. Ask does not expose them. Compact requests manual completion and can report a partial result when verification blocks the task.</p>
<table><thead><tr><th>Provider</th><th>Default weight</th><th>Integrated coverage</th></tr></thead><tbody>
        <tr><td><a href="https://docs.capsolver.com/en/guide/getting-started/">CapSolver</a></td><td>100</td><td>reCAPTCHA v2/v3 and Enterprise/M1, GeeTest, MTCaptcha, AWS WAF, BotDeflector, Turnstile, Cloudflare Challenge, DataDome, image text, recognition and VisionEngine.</td></tr>
        <tr><td><a href="https://2captcha.com/api-docs">2Captcha</a></td><td>99</td><td>reCAPTCHA, Turnstile, GeeTest, FunCaptcha, AWS WAF and the full documented native catalog, including image/audio, coordinates, grids and structured puzzles.</td></tr>
        <tr><td><a href="https://docs.capmonster.cloud/docs/captchas/">CapMonster Cloud</a></td><td>98</td><td>reCAPTCHA and Enterprise, GeeTest, Turnstile, Cloudflare Challenge/Waiting Room, DataDome, Tencent, AWS WAF, Basilisk, Binance, Imperva, Prosopo, Yidun, MTCaptcha, Altcha, FunCaptcha, TSPD, Hunt, Alibaba, Friendly Captcha, image text and ComplexImage recognition.</td></tr>
        <tr><td><a href="https://solvecaptcha.com/captcha-solver-api">SolveCaptcha</a></td><td>97</td><td>reCAPTCHA and Enterprise, Turnstile, AWS WAF, Tencent, CutCaptcha, Lemin, DataDome, MTCaptcha, Altcha, Friendly Captcha, Prosopo, atbCAPTCHA, GeeTest, FunCaptcha, CaptchaFox, VK, text/image/grid/rotation and puzzle recognition.</td></tr>
        <tr><td><a href="https://anti-captcha.com/apidoc">Anti-Captcha</a></td><td>96</td><td>reCAPTCHA and Enterprise, Turnstile, GeeTest, FunCaptcha, AWS WAF, Altcha, Friendly Captcha, Prosopo, image text/coordinates and AntiGate.</td></tr>
        <tr><td><a href="https://nopecha.com/api-reference/">NopeCHA</a></td><td>95</td><td>hCaptcha, reCAPTCHA v2/v3 and Turnstile tokens; AWS, FunCaptcha, GeeTest, hCaptcha, Lemin, reCAPTCHA and text recognition. <a href="https://nopecha.com/pricing">Plans and credits</a>.</td></tr>
        <tr><td><a href="https://nonecap.com/api-reference/">NoneCap</a></td><td>94</td><td>hCaptcha and hCaptcha Enterprise, including challenge metadata, proxy input and returned browser identity information.</td></tr>
      </tbody></table></div><p>The <a href="https://github.com/webbrain-one/webbrain/blob/main/docs/captcha-method-reference.md">complete technical reference</a> lists all 197 method variants and their inputs.</p></section>
      <section class="doc-section" id="hcaptcha"><h2>Which providers handle hCaptcha?</h2><p><strong>NopeCHA and NoneCap</strong> are the integrated hCaptcha providers. The other five services are not advertised as hCaptcha solvers in WebBrain. Old examples, sandbox pages, and unpublished drafts are not treated as evidence of a current production API.</p><p>Enterprise hCaptcha may need fresh <code>rqdata</code>, a matching proxy, or the solver’s browser identity. A returned token still needs to be accepted by the website. No paid live acceptance benchmark was performed for this integration.</p></section>
      <section class="doc-section" id="fallback"><h2>How fallback works</h2><p>WebBrain tries enabled, compatible providers in weight order. An error or timeout moves to the next provider within the same solve request. A disabled provider is skipped even if its key is saved. A provider is submitted at most once in that request.</p><div class="callout warning"><strong class="callout-title">More than one service may charge</strong><p>A timed-out job can still finish at the first service while the next one starts. Fallback can therefore cost more than one solve. WebBrain does not start another provider cycle because the page later rejects an answer.</p></div><p>NopeCHA and NoneCap balances are shown as credits. Provider prices, plans and availability can change; check the provider’s account page.</p></section>
      <section class="doc-section" id="limits"><h2>What happens on the page?</h2><p>Automatic detection handles supported reCAPTCHA, hCaptcha and standalone Turnstile widgets. The agent can inspect the wider native catalog, supply observed inputs, and receive tokens, cookies, text, coordinates or structured answers. It can bind those answers to a selected page field, callback, cookie or image/grid target.</p><p>Some sites need additional integration for sliders, drag paths, rotation controls or proprietary submissions. Recognition clicks use synthetic events, which some sites reject. Missing inputs or unsuccessful page verification require manual completion; an API response alone is not proof that the challenge cleared.</p><p>WebBrain does not silently change your proxy or User-Agent. In particular, NopeCHA Turnstile requires a proxy matching the browser’s submission IP. Cookie-based Cloudflare methods have their own HTML, proxy and browser requirements.</p></section>
      <section class="doc-section" id="privacy"><h2>Account keys and data</h2><p>Keys are stored in extension settings and added to API requests internally. Each attempted provider receives the challenge inputs needed by that method, which may include the page URL, site key, metadata, image/audio bytes and explicitly supplied proxy/cookie data. Testing a balance also contacts that provider.</p><p>Cookie answers are applied only through explicit bindings to the current page and its browser cookie store. The extension requests the cookies permission for this. It does not automatically send your entire cookie jar or execute code returned by a solver.</p><p>Managed WebBrain Cloud sessions retain their separate CapSolver broker. Personal keys, weights and native method calls do not expand that managed service.</p><p>Developers can read the <a href="https://github.com/webbrain-one/webbrain/blob/main/docs/captcha-provider-coverage.md">full implementation and coverage guide</a> for field mappings, fallback rules, validation and test details.</p></section>
      <nav class="next-links" aria-label="Related guides"><a href="/docs/settings/#captcha"><span>Settings</span>CAPTCHA</a><a href="/docs/safety/"><span>Related</span>Modes, safety &amp; privacy</a></nav>
    </main>
    <aside class="on-this-page" aria-label="On this page"><h2>On this page</h2><a href="#setup">Setup</a><a href="#providers">Providers</a><a href="#hcaptcha">hCaptcha</a><a href="#fallback">Fallback and cost</a><a href="#limits">Page application</a><a href="#privacy">Keys and data</a></aside>
  </div>
  <!-- Site footer: start -->
<footer class="wb-footer">
  <div class="wb-footer-inner">
    <div class="wb-footer-brand">
      <p class="wb-footer-tagline">On a mission to make the web smarter.</p>
      <p class="wb-footer-copy">© 2026 WebBrain. Built by <a href="https://emresokullu.com" target="_blank">Emre Sokullu</a> &amp; <a href="https://github.com/webbrain-one/webbrain/graphs/contributors" target="_blank">contributors</a>.</p>
    </div>
    <div class="wb-footer-row">
      <div class="wb-footer-links">
        <a href="/">Browser extension</a>
        <a href="/companion/">Desktop Companion</a>
        <a href="/research/">Research</a>
        <a href="/docs/">Docs</a>
        <a href="/docs/faq/">FAQ</a>
        <a href="/blog/">Blog</a>
        <a href="/privacy">Privacy Policy</a>
        <a href="https://github.com/webbrain-one/webbrain/issues" target="_blank" rel="noopener">Report Bug</a>
        <a href="https://github.com/webbrain-one/webbrain/blob/main/LICENSE" target="_blank" rel="noopener">GPL-3.0 License</a>
        <a href="https://pressreleases.online/org/webbrain.one" target="_blank" rel="noopener">Press</a>
        <a href="https://api.webbrain.one/account" target="_blank" rel="noopener">Compass Subscription</a>
      </div>
      <div class="wb-footer-social">
        <a href="https://mastoturk.org/@webbrain" target="_blank" rel="me noopener" aria-label="WebBrain on Mastodon" title="WebBrain on Mastodon" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M21.327 8.566c0-5.035-3.298-6.511-3.298-6.511C16.366 1.292 13.508.971 12.04.947h-.036c-1.468.024-4.326.345-5.989 1.108 0 0-3.298 1.476-3.298 6.511 0 1.153-.022 2.535.014 4.001.12 4.935.907 9.799 5.478 11.007 2.106.557 3.916.674 5.374.594 2.645-.147 4.128-.943 4.128-.943l-.087-1.918s-1.888.595-4.012.523c-2.104-.072-4.326-.227-4.668-2.809a5.289 5.289 0 0 1-.047-.724s2.066.505 4.686.625c1.603.073 3.107-.094 4.632-.276 2.925-.349 5.474-2.149 5.794-3.793.503-2.591.462-6.287.462-6.287ZM8.545 15.023H6.09V8.996c0-2.534 1.627-3.829 3.424-3.829 1.963 0 2.909 1.268 3.35 2.257.44-.989 1.386-2.257 3.349-2.257 1.797 0 3.424 1.295 3.424 3.829v6.027h-2.454V9.174c0-1.233-.519-1.859-1.557-1.859-1.148 0-1.724.742-1.724 2.207v3.203h-2.454V9.522c0-1.465-.576-2.207-1.724-2.207-1.038 0-1.557.626-1.557 1.859v5.849Z"/></svg></a>
        <a href="https://bsky.app/profile/webbrain-one.bsky.social" target="_blank" rel="me noopener" aria-label="WebBrain on Bluesky" title="WebBrain on Bluesky" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12 10.8c-1.1-2.1-4-6-6.8-8C2.6.9 1.6 1.3.9 1.6.1 1.9 0 3.1 0 3.8c0 .7.4 5.7.6 6.5.8 2.7 3.7 3.7 5.6 3.4-3.5.6-6.5 2-2.5 6.5 4.3 4.5 5.9-1 6.3-2.8.1-.5.2-.8.3-.8.1 0 .2.3.3.8.4 1.8 2 7.3 6.3 2.8 4-4.5 1-5.9-2.5-6.5 1.9.3 4.8-.7 5.6-3.4.2-.8.6-5.8.6-6.5 0-.7-.1-1.9-.9-2.2-.7-.3-1.7-.6-4.3 1.2-2.8 2-5.7 5.9-6.8 8Z"/></svg></a>
        <a href="https://discord.gg/cgC325ssfw" target="_blank" rel="noopener" aria-label="WebBrain on Discord" title="WebBrain on Discord" class="wb-footer-icon"><svg viewBox="0 0 16 16" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M13.545 2.907a13.227 13.227 0 0 0-3.257-1.011c.05.069.098.137.142.207a12.471 12.471 0 0 0-3.616 0c.044-.07.093-.138.143-.207A13.207 13.207 0 0 0 3.7 2.907 13.136 13.136 0 0 0 .931 13.362a13.667 13.667 0 0 0 4.022 2.018c.33-.442.623-.907.87-1.396a8.95 8.95 0 0 1-1.37-.652c.114-.083.225-.171.33-.269a9.6 9.6 0 0 0 8.243 0c.108.09.218.18.33.269a8.923 8.923 0 0 1-1.37.652c.248.489.54.954.87 1.396a13.667 13.667 0 0 0 4.022-2.018 13.136 13.136 0 0 0-2.769-10.455zM5.106 11.275c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608zm5.788 0c-.788 0-1.438-.72-1.438-1.608 0-.889.625-1.608 1.438-1.608.818 0 1.451.726 1.438 1.608 0 .888-.625 1.608-1.438 1.608z"/></svg></a>
        <a href="https://huggingface.co/webbrain-one" target="_blank" rel="me noopener" aria-label="WebBrain on Hugging Face" title="WebBrain on Hugging Face" class="wb-footer-icon"><svg viewBox="0 0 24 24" fill="currentColor" width="15" height="15" aria-hidden="true"><path d="M12.025 1.13c-5.77 0-10.449 4.647-10.449 10.378 0 1.112.178 2.181.503 3.185.064-.222.203-.444.416-.577a.96.96 0 0 1 .524-.15c.293 0 .584.124.84.284.278.173.48.408.71.694.226.282.458.611.684.951v-.014c.017-.324.106-.622.264-.874s.403-.487.762-.543c.3-.047.596.06.787.203s.31.313.4.467c.15.257.212.468.233.542.01.026.653 1.552 1.657 2.54.616.605 1.01 1.223 1.082 1.912.055.537-.096 1.059-.38 1.572.637.121 1.294.187 1.967.187.657 0 1.298-.063 1.921-.178-.287-.517-.44-1.041-.384-1.581.07-.69.465-1.307 1.081-1.913 1.004-.987 1.647-2.513 1.657-2.539.021-.074.083-.285.233-.542.09-.154.208-.323.4-.467a1.08 1.08 0 0 1 .787-.203c.359.056.604.29.762.543s.247.55.265.874v.015c.225-.34.457-.67.683-.952.23-.286.432-.52.71-.694.257-.16.547-.284.84-.285a.97.97 0 0 1 .524.151c.228.143.373.388.43.625l.006.04a10.3 10.3 0 0 0 .534-3.273c0-5.731-4.678-10.378-10.449-10.378M8.327 6.583a1.5 1.5 0 0 1 .713.174 1.487 1.487 0 0 1 .617 2.013c-.183.343-.762-.214-1.102-.094-.38.134-.532.914-.917.71a1.487 1.487 0 0 1 .69-2.803m7.486 0a1.487 1.487 0 0 1 .689 2.803c-.385.204-.536-.576-.916-.71-.34-.12-.92.437-1.103.094a1.487 1.487 0 0 1 .617-2.013 1.5 1.5 0 0 1 .713-.174m-10.68 1.55a.96.96 0 1 1 0 1.921.96.96 0 0 1 0-1.92m13.838 0a.96.96 0 1 1 0 1.92.96.96 0 0 1 0-1.92M8.489 11.458c.588.01 1.965 1.157 3.572 1.164 1.607-.007 2.984-1.155 3.572-1.164.196-.003.305.12.305.454 0 .886-.424 2.328-1.563 3.202-.22-.756-1.396-1.366-1.63-1.32q-.011.001-.02.006l-.044.026-.01.008-.03.024q-.018.017-.035.036l-.032.04a1 1 0 0 0-.058.09l-.014.025q-.049.088-.11.19a1 1 0 0 1-.083.116 1.2 1.2 0 0 1-.173.18q-.035.029-.075.058a1.3 1.3 0 0 1-.251-.243 1 1 0 0 1-.076-.107c-.124-.193-.177-.363-.337-.444-.034-.016-.104-.008-.2.022q-.094.03-.216.087-.06.028-.125.063l-.13.074q-.067.04-.136.086a3 3 0 0 0-.135.096 3 3 0 0 0-.26.219 2 2 0 0 0-.12.121 2 2 0 0 0-.106.128l-.002.002a2 2 0 0 0-.09.132l-.001.001a1.2 1.2 0 0 0-.105.212q-.013.036-.024.073c-1.139-.875-1.563-2.317-1.563-3.203 0-.334.109-.457.305-.454m.836 10.354c.824-1.19.766-2.082-.365-3.194-1.13-1.112-1.789-2.738-1.789-2.738s-.246-.945-.806-.858-.97 1.499.202 2.362c1.173.864-.233 1.45-.685.64-.45-.812-1.683-2.896-2.322-3.295s-1.089-.175-.938.647 2.822 2.813 2.562 3.244-1.176-.506-1.176-.506-2.866-2.567-3.49-1.898.473 1.23 2.037 2.16c1.564.932 1.686 1.178 1.464 1.53s-3.675-2.511-4-1.297c-.323 1.214 3.524 1.567 3.287 2.405-.238.839-2.71-1.587-3.216-.642-.506.946 3.49 2.056 3.522 2.064 1.29.33 4.568 1.028 5.713-.624m5.349 0c-.824-1.19-.766-2.082.365-3.194 1.13-1.112 1.789-2.738 1.789-2.738s.246-.945.806-.858.97 1.499-.202 2.362c-1.173.864.233 1.45.685.64.451-.812 1.683-2.896 2.322-3.295s1.089-.175.938.647-2.822 2.813-2.562 3.244 1.176-.506 1.176-.506 2.866-2.567 3.49-1.898-.473 1.23-2.037 2.16c-1.564.932-1.686 1.178-1.464 1.53s3.675-2.511 4-1.297c.323 1.214-3.524 1.567-3.287 2.405.238.839 2.71-1.587 3.216-.642.506.946-3.49 2.056-3.522 2.064-1.29.33-4.568 1.028-5.713-.624"/></svg></a>
      </div>
    </div>
  </div>
</footer>
<!-- Site footer: end --><script src="/docs/assets/docs.js?v=20260809"></script>
</body></html>