npm - human-browser - Versions diffs - 3.0.0 → 3.1.1 - Mend

human-browser 3.0.0 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -1,48 +1,26 @@
-# 🌍 Human Browser — Cloud Stealth Browser for AI Agents
-[![npm](https://img.shields.io/npm/v/%40al1enjesus%2Fhuman-browser?color=red&label=npm)](https://www.npmjs.com/package/@al1enjesus/human-browser)
-[![ClawHub](https://img.shields.io/badge/ClawHub-human--browser-orange)](https://clawhub.ai/al1enjesus/human-browser)
-[![skills.sh](https://img.shields.io/badge/skills.sh-listed-blue)](https://skills.sh/al1enjesus/human-browser)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+# Human Browser — Cloud Stealth Browser for AI Agents
 > **No Mac Mini. No local machine. Your agent runs it anywhere.**
 > Residential IPs from 10+ countries. Bypasses Cloudflare, DataDome, PerimeterX.
-🌐 **Product page + pricing:** [humanbrowser.dev](https://humanbrowser.dev)
-💬 **Support:** [@virixlabs](https://t.me/virixlabs)
+>
+> 🌐 **Product page:** https://humanbrowser.dev
+> 💬 **Support:** https://t.me/virixlabs
 ---
 ## Why your agent needs this
-Regular Playwright on a VPS gets blocked **immediately** by:
-- **Cloudflare** — bot score detection via data-center IP fingerprint
-- **DataDome** — fingerprint and behavioral analysis
-- **PerimeterX** — mouse movement and timing analysis
-- **Instagram, LinkedIn, TikTok** — residential IP requirement
-Human Browser solves this with:
+Regular Playwright on a data-center server gets blocked **immediately** by:
+- Cloudflare (bot score detection)
+- DataDome (fingerprint analysis)
+- PerimeterX (behavioral analysis)
+- Instagram, LinkedIn, TikTok (residential IP requirement)
-1. **Residential IP** — real ISP address from target country (not a data center)
-2. **Real device fingerprint** — iPhone 15 Pro or Windows Chrome, canvas + WebGL + fonts
+Human Browser solves this by combining:
+1. **Residential IP** — real ISP address from the target country (not a data center)
+2. **Real device fingerprint** — iPhone 15 Pro or Windows Chrome, complete with canvas, WebGL, fonts
 3. **Human-like behavior** — Bezier mouse curves, 60–220ms typing, natural scroll with jitter
-4. **Full anti-detection** — `webdriver=false`, no automation flags, correct timezone + geolocation
----
-## Install
-```bash
-# OpenClaw agents (recommended)
-clawhub install al1enjesus/human-browser
-# skild.sh (multi-platform)
-skild install al1enjesus/human-browser
-# npm
-npm install @al1enjesus/human-browser
-```
+4. **Full anti-detection** — `webdriver=false`, no automation flags, correct timezone & geolocation
 ---
@@ -57,7 +35,6 @@ const { browser, page, humanType, humanClick, humanScroll, sleep } = await launc
 // Specific country
 const { page } = await launchHuman({ country: 'us' }); // US residential IP
 const { page } = await launchHuman({ country: 'gb' }); // UK residential IP
-const { page } = await launchHuman({ country: 'jp' }); // Japan
 // Desktop Chrome (Windows fingerprint)
 const { page } = await launchHuman({ mobile: false, country: 'us' });
@@ -71,122 +48,59 @@ await browser.close();
 ---
-## Country → Service Compatibility
-| Country | ✅ Works great | ❌ Blocked |
-|---------|--------------|-----------|
-| 🇷🇴 Romania `ro` | Polymarket, Instagram, Binance, Cloudflare | US Banks, Netflix US |
-| 🇺🇸 United States `us` | Netflix, DoorDash, US Banks, Amazon US | Polymarket, Binance |
-| 🇬🇧 United Kingdom `gb` | Polymarket, Binance, BBC iPlayer | US-only apps |
-| 🇩🇪 Germany `de` | EU services, Binance, German e-commerce | US-only |
-| 🇳🇱 Netherlands `nl` | Crypto, privacy, Polymarket, Web3 | US Banks |
-| 🇯🇵 Japan `jp` | Japanese e-commerce, Line, localized prices | — |
-| 🇫🇷 France `fr` | EU services, luxury brands | US-only |
-| 🇨🇦 Canada `ca` | North American services | Some US-only |
-| 🇸🇬 Singapore `sg` | APAC/SEA e-commerce | US-only |
-| 🇦🇺 Australia `au` | Oceania content | — |
-**→ Interactive country selector + service matrix:** [humanbrowser.dev](https://humanbrowser.dev)
+## Setup
----
-## Recipes
-### Scrape Instagram without getting blocked
-```js
-const { page } = await launchHuman({ country: 'ro' });
-await page.goto('https://www.instagram.com/username/');
-```
-### Polymarket / crypto platforms (EU IP required)
-```js
-const { page } = await launchHuman({ country: 'ro' }); // or 'gb', 'nl'
-await page.goto('https://polymarket.com');
-```
-### US-only services (Netflix, DoorDash)
-```js
-const { page } = await launchHuman({ country: 'us', mobile: false });
-await page.goto('https://doordash.com');
-```
-### React input fields
-```js
-// page.fill() fails silently on React inputs — use humanType instead
-await humanType(page, 'input[name="email"]', 'user@example.com');
-```
-### Bypass animated button detection
-```js
-await page.evaluate((text) => {
-  [...document.querySelectorAll('button')]
-    .find(b => b.offsetParent && b.textContent.includes(text))?.click();
-}, 'Continue');
-```
+```bash
+npm install playwright
+npx playwright install chromium --with-deps
-### Verify your IP
-```js
-await page.goto('https://api.ipify.org?format=json');
-const { ip } = JSON.parse(await page.textContent('body'));
-console.log('IP:', ip); // Residential IP from your target country
+# Install via skill manager
+clawhub install al1enjesus/human-browser
 ```
 ---
-## Get Credentials
-Proxy credentials (residential IP) are required. The script itself is free and open source.
-**→ Purchase at: [humanbrowser.dev](https://humanbrowser.dev)**
-| Plan | Price | Countries | Bandwidth |
-|------|-------|-----------|-----------|
-| Starter 🇷🇴 | $13.99/mo | Romania | 2 GB |
-| Pro 🌍 | $49.99/mo | All 10+ countries | 20 GB |
-| Enterprise | $199/mo | All + dedicated zone | Unlimited |
-Payment: **Card** (Stripe + Apple Pay + Google Pay) or **Crypto** (USDT, BTC, ETH, SOL).
-Credentials are delivered automatically after payment.
+## Supported Countries
+| Country | Code | Best for |
+|---------|------|----------|
+| 🇷🇴 Romania | `ro` | Polymarket, Instagram, Binance, Cloudflare |
+| 🇺🇸 United States | `us` | Netflix, DoorDash, US Banks, Amazon |
+| 🇬🇧 United Kingdom | `gb` | Polymarket, Binance, BBC iPlayer |
+| 🇩🇪 Germany | `de` | EU services, German e-commerce |
+| 🇳🇱 Netherlands | `nl` | Crypto, Polymarket, Web3 |
+| 🇯🇵 Japan | `jp` | Japanese e-commerce, Line |
+| 🇫🇷 France | `fr` | EU services, luxury brands |
+| 🇨🇦 Canada | `ca` | North American services |
+| 🇸🇬 Singapore | `sg` | APAC/SEA e-commerce |
+| 🇦🇺 Australia | `au` | Oceania content |
 ---
-## Agent-Native Purchase API
-Your agent can buy credentials without human involvement:
+## Proxy Providers
-```js
-const res = await fetch('https://humanbrowser.dev/api/buy', {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({
-    plan: 'starter',    // 'starter' | 'pro' | 'enterprise'
-    currency: 'USDT',  // 'card' | 'USDT' | 'BTC' | 'ETH' | 'SOL'
-    email: 'agent@example.com'
-  })
-});
-const { payment_url, order_id } = await res.json();
-```
+### Option 1: Human Browser Managed (recommended)
+Buy directly at **humanbrowser.dev** — we handle everything, from $13.99/mo.
+Supports crypto (USDT/ETH/BTC/SOL) and card. AI agents can auto-purchase.
-After confirmation, credentials arrive automatically:
-```
-PROXY_USER=brd-customer-hl_XXXXXX-zone-mcp_unlocker-country-ro
-PROXY_PASS=XXXXXXXXXX
-PROXY_HOST=brd.superproxy.io
-PROXY_PORT=22225
-```
+### Option 2: Bring Your Own Proxy
----
+Plug any residential proxy into Human Browser via env vars.
+**Recommended providers** (tested and verified):
-## Prerequisites
+| Provider | Quality | Price | Best for |
+|---|---|---|---|
+| **[Decodo](https://decodo.com)** (ex-Smartproxy) | ⭐⭐⭐⭐⭐ | ~$2.5/GB | Cloudflare, DataDome, all-round |
+| **[IPRoyal](https://iproyal.com)** | ⭐⭐⭐⭐ | $1.75/GB | High volume, budget |
+| **[Bright Data](https://brightdata.com)** | ⭐⭐⭐⭐⭐ | ~$8.4/GB | Enterprise, most IPs |
-```bash
-npm install playwright
-npx playwright install chromium --with-deps
+```env
+PROXY_HOST=your-proxy-host
+PROXY_PORT=22225
+PROXY_USER=your-username
+PROXY_PASS=your-password
 ```
-Requires residential proxy credentials — see [humanbrowser.dev](https://humanbrowser.dev) for plans.
-For manual Bright Data setup, see [references/brightdata-setup.md](references/brightdata-setup.md).
 ---
 ## How it compares
@@ -199,20 +113,10 @@ For manual Bright Data setup, see [references/brightdata-setup.md](references/br
 | Typing speed | Instant | 60–220ms/char |
 | Fingerprint | Detectable bot | iPhone 15 Pro |
 | Countries | None | 10+ residential |
-| Cloudflare | ❌ | ✅ Bypassed |
-| DataDome | ❌ | ✅ Bypassed |
-| Agent payment | Manual | API-native |
----
-## Links
-- 🌐 Product page: [humanbrowser.dev](https://humanbrowser.dev)
-- 🦀 ClawHub: [clawhub.ai/al1enjesus/human-browser](https://clawhub.ai/al1enjesus/human-browser)
-- 📦 npm: [@al1enjesus/human-browser](https://www.npmjs.com/package/@al1enjesus/human-browser)
-- 🛠 skills.sh: [skills.sh/al1enjesus/human-browser](https://skills.sh/al1enjesus/human-browser)
-- 💬 Support: [@virixlabs](https://t.me/virixlabs)
+| Cloudflare | Blocked | Bypassed |
+| DataDome | Blocked | Bypassed |
 ---
-MIT License © [al1enjesus](https://github.com/al1enjesus)
+→ **Product page + pricing:** https://humanbrowser.dev
+→ **Support & questions:** https://t.me/virixlabs

package/SKILL.md CHANGED Viewed

@@ -235,6 +235,40 @@ console.log('IP:', ip); // Should show a residential IP from your target country
 ---
+## Get Proxy Credentials
+### Option 1: Human Browser Managed (recommended)
+Buy directly at **humanbrowser.dev** — we handle everything, from $13.99/mo.
+Supports crypto (USDT/ETH/BTC/SOL) and card. AI agents can auto-purchase.
+### Option 2: Bring Your Own Proxy
+Use any residential proxy provider and plug in your credentials via env vars.
+**Recommended providers** (quality tested with Human Browser):
+#### 🥇 Decodo (ex-Smartproxy) — best overall quality
+> Residential + ISP proxies. 195+ countries. Very high bypass rate.
+> Used by major scraping teams. Excellent Cloudflare/DataDome resistance.
+> **→ https://decodo.com** | from ~$2.5/GB residential
+#### 🥈 IPRoyal — best price/GB
+> Budget residential proxies. Good for high-volume, less strict targets.
+> **→ https://iproyal.com** | from $1.75/GB residential
+#### 🥉 Bright Data — enterprise grade
+> Most IPs, most countries, best support. Expensive but gold standard.
+> **→ https://brightdata.com** | from ~$8.4/GB residential
+When using your own proxy, set env vars before running:
+```env
+PROXY_HOST=your-proxy-host
+PROXY_PORT=22225
+PROXY_USER=your-username
+PROXY_PASS=your-password
+```
+---
 ## Setup
 ```bash

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "human-browser",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "Stealth browser with residential proxies from 10+ countries for AI agents. Bypasses Cloudflare, DataDome, PerimeterX. iPhone 15 Pro fingerprint.",
   "keywords": [
     "browser-automation",
@@ -37,4 +37,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}

package/scripts/browser-human.js CHANGED Viewed

@@ -36,13 +36,21 @@ const COUNTRY_META = {
 function buildProxy(country = 'ro') {
   const c = country.toLowerCase();
-  const server   = process.env.PROXY_SERVER   || 'http://brd.superproxy.io:22225';
-  const username = process.env.PROXY_USERNAME || '';
-  const password = process.env.PROXY_PASSWORD || '';
+  // Proxy config — use env vars or defaults
+  const PROXY_HOST = process.env.PROXY_HOST || 'brd.superproxy.io';
+  const PROXY_PORT = process.env.PROXY_PORT || '22225';
+  const PROXY_USER = process.env.PROXY_USER || `brd-customer-hl_b1694dd8-zone-mcp_unlocker${c !== 'ro' ? `-country-${c}` : ''}`;
+  const PROXY_PASS = process.env.PROXY_PASS || 'x8iy8mgsush8';
+  // Also support legacy env var names for backward compatibility
+  const server   = process.env.PROXY_SERVER   || `http://${PROXY_HOST}:${PROXY_PORT}`;
+  const username = process.env.PROXY_USERNAME || PROXY_USER;
+  const password = process.env.PROXY_PASSWORD || PROXY_PASS;
   if (!username || !password) {
     console.warn('⚠️  No proxy credentials set. Get them at: https://humanbrowser.dev');
-    console.warn('    Set PROXY_USERNAME and PROXY_PASSWORD in your .env file.');
+    console.warn('    Set PROXY_USER and PROXY_PASS in your .env file.');
     return null;
   }
@@ -51,7 +59,7 @@ function buildProxy(country = 'ro') {
   const hasCountry = username.includes('-country-');
   const finalUser = hasCountry
     ? username.replace(/-country-\w+/, `-country-${c}`)
-    : `${username}-country-${c}`;
+    : username.includes('zone-') ? `${username}-country-${c}` : username;
   return { server, username: finalUser, password };
 }