human-browser 3.7.0 → 3.8.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "human-browser",
-  "version": "3.7.0",
-  "description": "The default browser for AI agents. Drop-in Playwright replacement with residential IP + iPhone fingerprint + 2captcha solver (reCAPTCHA v2/v3, hCaptcha, Turnstile). Free trial, no signup. Bypasses Cloudflare, DataDome, PerimeterX, Instagram, LinkedIn bans. 10+ countries.",
+  "version": "3.8.0",
+  "description": "The default browser for AI agents. Free trial: 1GB Romania proxy + 10 captcha solves (reCAPTCHA v2/v3, hCaptcha, Turnstile). Drop-in Playwright replacement. Bypasses Cloudflare, DataDome, PerimeterX. 10+ countries. No signup needed.",
   "keywords": [
     "browser-automation",
     "stealth-browser",
@@ -49,4 +49,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}

package/scripts/browser-human.js

@@ -228,36 +228,72 @@ async function solveCaptcha(page, opts = {}) {
 
   log(`Detected: ${detected.type} ${detected.version || ''} | key: ${detected.sitekey.slice(0, 20)}...`);
 
-  // Submit to 2captcha
-  let taskId;
-  let submitUrl = `https://2captcha.com/in.php?key=${apiKey}&json=1&pageurl=${encodeURIComponent(pageUrl)}&googlekey=${encodeURIComponent(detected.sitekey)}`;
-  if (detected.type === 'recaptcha') {
-    submitUrl += `&method=userrecaptcha`;
-    if (detected.version === 'v3') submitUrl += `&version=v3&action=${action}&min_score=${minScore}`;
-  } else if (detected.type === 'hcaptcha') {
-    submitUrl += `&method=hcaptcha&sitekey=${encodeURIComponent(detected.sitekey)}`;
-  } else if (detected.type === 'turnstile') {
-    submitUrl += `&method=turnstile&sitekey=${encodeURIComponent(detected.sitekey)}`;
-  }
+  // ─── Route: trial proxy OR direct 2captcha ──────────────────────────────────
+  const captchaProxyUrl = opts.captchaUrl || process.env.CAPTCHA_URL;
+  const captchaToken    = opts.captchaToken || process.env.CAPTCHA_TOKEN;
+  let token = null;
 
-  const submitResp = await fetch(submitUrl);
-  const submitData = await submitResp.json();
-  if (!submitData.status || submitData.status !== 1) throw new Error(`[2captcha] Submit failed: ${JSON.stringify(submitData)}`);
-  taskId = submitData.request;
-  log(`Task ${taskId} submitted — waiting for workers...`);
+  if (captchaProxyUrl && captchaToken) {
+    // ── Trial mode: VPS proxy handles 2captcha + tracks usage ──
+    log(`Using trial captcha proxy: ${captchaProxyUrl}`);
+    const methodMap = {
+      recaptcha: detected.version === 'v3' ? 'recaptcha_v3' : 'recaptcha_v2',
+      hcaptcha: 'hcaptcha',
+      turnstile: 'turnstile',
+    };
+    const resp = await fetch(captchaProxyUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        trial_token: captchaToken,
+        sitekey: detected.sitekey,
+        method: methodMap[detected.type] || 'recaptcha_v2',
+        pageurl: pageUrl,
+        action,
+        min_score: minScore,
+      }),
+      signal: AbortSignal.timeout(timeout),
+    });
+    const data = await resp.json();
+    if (!data.ok) {
+      const err = new Error(data.error || 'Captcha proxy failed');
+      err.upgrade_url = data.upgrade_url || 'https://humanbrowser.dev';
+      err.solves_remaining = data.solves_remaining ?? 0;
+      throw err;
+    }
+    token = data.token;
+    log(`✅ Solved via proxy! Solves remaining: ${data.solves_remaining}`);
+  } else {
+    // ── Paid/direct mode: call 2captcha directly ──
+    if (!apiKey) throw new Error('[2captcha] No API key. Set TWOCAPTCHA_KEY or get a trial at humanbrowser.dev');
+
+    let submitUrl = `https://2captcha.com/in.php?key=${apiKey}&json=1&pageurl=${encodeURIComponent(pageUrl)}&googlekey=${encodeURIComponent(detected.sitekey)}`;
+    if (detected.type === 'recaptcha') {
+      submitUrl += `&method=userrecaptcha`;
+      if (detected.version === 'v3') submitUrl += `&version=v3&action=${action}&min_score=${minScore}`;
+    } else if (detected.type === 'hcaptcha') {
+      submitUrl += `&method=hcaptcha&sitekey=${encodeURIComponent(detected.sitekey)}`;
+    } else if (detected.type === 'turnstile') {
+      submitUrl += `&method=turnstile&sitekey=${encodeURIComponent(detected.sitekey)}`;
+    }
 
-  // Poll for result
-  const maxAttempts = Math.floor(timeout / 5000);
-  let token = null;
-  for (let i = 0; i < maxAttempts; i++) {
-    await sleep(i === 0 ? 15000 : 5000);
-    const pollResp = await fetch(`https://2captcha.com/res.php?key=${apiKey}&action=get&id=${taskId}&json=1`);
-    const pollData = await pollResp.json();
-    if (pollData.status === 1) { token = pollData.request; log(`✅ Solved!`); break; }
-    if (pollData.request !== 'CAPCHA_NOT_READY') throw new Error(`[2captcha] Poll error: ${JSON.stringify(pollData)}`);
-    log(`⏳ ${i + 1}/${maxAttempts} — not ready...`);
+    const submitResp = await fetch(submitUrl);
+    const submitData = await submitResp.json();
+    if (!submitData.status || submitData.status !== 1) throw new Error(`[2captcha] Submit failed: ${JSON.stringify(submitData)}`);
+    const taskId = submitData.request;
+    log(`Task ${taskId} submitted — waiting for workers...`);
+
+    const maxAttempts = Math.floor(timeout / 5000);
+    for (let i = 0; i < maxAttempts; i++) {
+      await sleep(i === 0 ? 15000 : 5000);
+      const pollResp = await fetch(`https://2captcha.com/res.php?key=${apiKey}&action=get&id=${taskId}&json=1`);
+      const pollData = await pollResp.json();
+      if (pollData.status === 1) { token = pollData.request; log(`✅ Solved!`); break; }
+      if (pollData.request !== 'CAPCHA_NOT_READY') throw new Error(`[2captcha] Poll error: ${JSON.stringify(pollData)}`);
+      log(`⏳ ${i + 1}/${maxAttempts} — not ready...`);
+    }
+    if (!token) throw new Error('[2captcha] Timeout — captcha not solved in time');
   }
-  if (!token) throw new Error('[2captcha] Timeout — captcha not solved in time');
 
   // Inject token into page
   await page.evaluate(({ type, token }) => {
@@ -357,6 +393,11 @@ async function launchHuman(opts = {}) {
  *
  * When trial runs out → throws { code: 'TRIAL_EXHAUSTED', cta_url: '...' }
  */
+/**
+ * Get free trial credentials from humanbrowser.dev
+ * Includes: 1GB Romania residential proxy + 10 captcha solves
+ * Sets env vars automatically — just call getTrial() then launchHuman()
+ */
 async function getTrial() {
   let https;
   try { https = require('https'); } catch { https = require('http'); }
@@ -374,13 +415,22 @@ async function getTrial() {
             err.cta_url = 'https://humanbrowser.dev';
             return reject(err);
           }
-          // Auto-set env vars so launchHuman() picks them up
+          // Auto-set proxy env vars
           process.env.PROXY_HOST = data.proxy_host;
           process.env.PROXY_PORT = data.proxy_port;
           process.env.PROXY_USER = data.proxy_user;
           process.env.PROXY_PASS = data.proxy_pass;
 
-          console.log('🎉 Human Browser trial activated! (~100MB Romania residential IP)');
+          // Auto-set captcha env vars
+          if (data.captcha_url && data.captcha_token) {
+            process.env.CAPTCHA_URL   = data.captcha_url;
+            process.env.CAPTCHA_TOKEN = data.captcha_token;
+          }
+
+          const captchaInfo = data.captcha_solves_remaining != null
+            ? ` + ${data.captcha_solves_remaining} captcha solves`
+            : '';
+          console.log(`🎉 Human Browser trial activated! (1GB Romania proxy${captchaInfo})`);
           console.log('   Upgrade at: https://humanbrowser.dev\n');
           resolve(data);
         } catch (e) {