human-browser 3.0.0 → 3.1.0

package/README.md

@@ -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)
-
----
-
-## 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');
-```
+## Setup
 
-### 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
+## Proxy Providers
 
-Your agent can buy credentials without human involvement:
+### 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.
 
-```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 2: Bring Your Own Proxy (affiliate)
+Use our partner proxies — we earn a small commission at no cost to you:
 
-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
-```
+- **Decodo** (ex-Smartproxy) — https://decodo.com/?ref=humanbrowser  
+  Residential, ISP, datacenter. From $2.5/GB. Best for most use cases.
 
----
+- **IPRoyal** — https://iproyal.com/?ref=humanbrowser  
+  Budget residential from $1.75/GB. Good for high volume.
 
-## Prerequisites
+When using your own proxy, set env vars:
 
-```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

@@ -235,6 +235,31 @@ 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 (affiliate)
+Use our partner proxies — we earn a small commission at no cost to you:
+
+- **Decodo** (ex-Smartproxy) — https://decodo.com/?ref=humanbrowser
+  Residential, ISP, datacenter. From $2.5/GB. Best for most use cases.
+  
+- **IPRoyal** — https://iproyal.com/?ref=humanbrowser  
+  Budget residential from $1.75/GB. Good for high volume.
+
+When using your own proxy, set env vars:
+```env
+PROXY_HOST=your-proxy-host
+PROXY_PORT=22225
+PROXY_USER=your-username
+PROXY_PASS=your-password
+```
+
+---
+
 ## Setup
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "human-browser",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Stealth browser with residential proxies from 10+ countries for AI agents. Bypasses Cloudflare, DataDome, PerimeterX. iPhone 15 Pro fingerprint.",
   "keywords": [
     "browser-automation",

package/scripts/browser-human.js

@@ -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 };
 }