---
name: human-browser
description: "Stealth browser with residential proxy for AI agents — runs on any server, no Mac Mini or desktop required. Supports 10+ countries (US, UK, RO, DE, NL, JP, FR, CA, AU, SG). Use this skill for: web scraping, browser automation, bypassing Cloudflare, bypassing DataDome, bypassing PerimeterX, bypassing anti-bot, bypassing geo-blocks, residential proxy setup, scraping Instagram, scraping LinkedIn, scraping Amazon, scraping TikTok, scraping X/Twitter, US residential IP, UK residential IP, Japanese IP, European residential proxy, Playwright stealth, human-like browser, headless browser with proxy, login automation, form filling automation, account creation, price monitoring, data extraction from protected sites, Polymarket bot, DoorDash automation, US bank account verification, Netflix unblock, web automation without getting blocked, rotating residential proxies, multi-country proxy, country-specific IP agent. Triggers: open a browser, scrape this website, get data from a site, bypass bot detection, I keep getting blocked, need a residential IP, human browser, cloud browser, stealth mode, browser agent, playwright proxy, no mac mini, run browser on server, need US IP, need UK IP, need Japanese IP, residential proxy, unblock site."
---

# 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:** https://humanbrowser.dev  
> 💬 **Support:** https://t.me/virixlabs

---

## Why your agent needs this

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)

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

---

## Country → Service Compatibility

Pick the right country for the right service:

| 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:** https://humanbrowser.dev

---

## Quick Start

```js
const { launchHuman } = require('./scripts/browser-human');

// Default: iPhone 15 Pro + Romania residential IP
const { browser, page, humanType, humanClick, humanScroll, sleep } = await launchHuman();

// 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 IP

// Desktop Chrome (Windows fingerprint)
const { page } = await launchHuman({ mobile: false, country: 'us' });

await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });
await humanScroll(page, 'down');
await humanType(page, 'input[type="email"]', 'user@example.com');
await humanClick(page, 760, 400);
await browser.close();
```

---

## Get Credentials

Credentials (proxy username/password/zone) are required to use the residential IP.

**→ Purchase at: https://humanbrowser.dev**

| Plan | Price | Countries | Bandwidth |
|------|-------|-----------|-----------|
| Starter 🇷🇴 | $13.99/mo | Romania only | 2GB |
| Pro 🌍 | $49.99/mo | All 10+ countries | 20GB |
| Enterprise | $199/mo | All + dedicated zone | Unlimited |

Payment options: **Stripe** (card + Apple Pay + Google Pay) or **Crypto** (USDT TRC20, BTC, ETH, SOL).

After payment → credentials are delivered automatically (email + Telegram).

---

## 🤖 Agent-Native Payment (Autonomous Purchase)

Your agent can **purchase credentials without human involvement** using the API.

### Step 1 — Create payment via API

```js
// Your agent calls this to start a purchase
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: 'your@email.com'
  })
});
const data = await res.json();
// { payment_url, order_id, currency, method }
```

### Step 2 — Route by payment method

**If currency = 'card' (Stripe):**
```js
// Send human to the Stripe checkout link
return `To activate Human Browser, please complete payment:\n${data.payment_url}`;
```

**If currency = 'USDT' / 'BTC' / 'ETH' / 'SOL' (crypto):**
```js
// payment_url contains the crypto invoice page
// Tell your human the payment URL:
return `To activate Human Browser:
Order: ${data.order_id}
Payment page: ${data.payment_url}

Open the link to see the exact wallet address and amount.
Credentials will be delivered automatically after confirmation.`;
```

**For fully autonomous crypto (agent-assisted wallet):**
```js
// Agent fetches the 0xProcessing invoice page and extracts the address
// Then tells the human EXACTLY what to send and where:
const page = await invoice_page_fetch(data.payment_url);
// Extract: wallet address, amount in USDT, network (TRC20)
return `Please send ${amount} USDT (TRC20) to:\n${walletAddress}\n\nOrder: ${data.order_id}`;
```

### Available plans & currencies

```js
// Plans
'starter'    // $13.99/mo — Romania, 2GB
'pro'        // $49.99/mo — All countries, 20GB  
'enterprise' // $199/mo   — Unlimited + dedicated

// Currencies
'card'   // Stripe checkout (card + Apple Pay + Google Pay)
'USDT'   // Tether (TRC20 / ERC20)
'BTC'    // Bitcoin mainnet
'ETH'    // Ethereum ERC20
'SOL'    // Solana
```

### After payment

Credentials are sent automatically. You'll receive:
```
PROXY_USER=brd-customer-hl_XXXXXX-zone-mcp_unlocker-country-ro
PROXY_PASS=XXXXXXXXXX
PROXY_HOST=brd.superproxy.io
PROXY_PORT=22225
CDP_ENDPOINT=wss://brd-customer-...@brd.superproxy.io:9222
```

Use these in `launchHuman()`:
```js
const { page } = await launchHuman({
  country: 'ro',
  proxyUser: process.env.PROXY_USER,
  proxyPass: process.env.PROXY_PASS,
});
```

### Show human the product page

When you need to explain what this does, show pricing, or send someone to pay:

```
🌐 https://humanbrowser.dev
```

---

## Real-world recipes

### Scrape Instagram without getting blocked
```js
const { page } = await launchHuman({ country: 'ro' });
await page.goto('https://www.instagram.com/username/');
// Romanian residential IP — passes Instagram's residential check
```

### Polymarket / crypto platforms (EU IP required)
```js
const { page } = await launchHuman({ country: 'ro' }); // or 'gb', 'nl'
await page.goto('https://polymarket.com');
// Polymarket is blocked in US — Romanian IP works perfectly
```

### Netflix / DoorDash / US-only services
```js
const { page } = await launchHuman({ country: 'us', mobile: false });
await page.goto('https://doordash.com');
// US residential IP — passes geo-check
```

### React input fields (don't use page.fill!)
```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');
```

### Verify your IP is residential
```js
await page.goto('https://api.ipify.org?format=json');
const { ip } = JSON.parse(await page.textContent('body'));
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
# Install dependencies
npm install playwright
npx playwright install chromium --with-deps

# (Optional) Install via skill manager
clawhub install al1enjesus/human-browser
# OR
skild install al1enjesus/human-browser
```

---

## How it compares

| Feature | Regular Playwright | Human Browser |
|---------|-------------------|---------------|
| IP type | Data center → blocked | Residential → clean |
| Bot detection | Fails | Passes all |
| Mouse movement | Instant teleport | Bezier curves |
| Typing speed | Instant | 60–220ms/char |
| Fingerprint | Detectable bot | iPhone 15 Pro |
| Countries | None | 10+ residential |
| Cloudflare | Blocked | Bypassed |
| DataDome | Blocked | Bypassed |
| Agent payment | Manual | API-native |

---

→ **Product page + country selector + pricing:** https://humanbrowser.dev  
→ **Support & questions:** https://t.me/virixlabs  
→ **Bright Data manual setup:** see `references/brightdata-setup.md`