130 lines
4.6 KiB
Markdown
130 lines
4.6 KiB
Markdown
# 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
|
||
|
||
---
|
||
|
||
## Quick Start
|
||
|
||
**No setup required** — just call `launchHuman()` and it automatically activates a free trial:
|
||
|
||
```js
|
||
const { launchHuman } = require('./scripts/browser-human');
|
||
|
||
// 🚀 Zero config — auto-fetches trial credentials from humanbrowser.dev
|
||
const { browser, page, humanType, humanClick, humanScroll, sleep } = await launchHuman();
|
||
// Output: 🎉 Human Browser trial activated! (~100MB Romania residential IP)
|
||
|
||
// Specific country
|
||
const { page } = await launchHuman({ country: 'us' }); // US residential IP
|
||
const { page } = await launchHuman({ country: 'gb' }); // UK residential 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();
|
||
```
|
||
|
||
> **Trial exhausted?** Get a paid plan at https://humanbrowser.dev, then set `PROXY_USER` / `PROXY_PASS` in your `.env`.
|
||
|
||
---
|
||
|
||
## Setup
|
||
|
||
```bash
|
||
npm install playwright
|
||
npx playwright install chromium --with-deps
|
||
|
||
# Install via skill manager
|
||
clawhub install al1enjesus/human-browser
|
||
```
|
||
|
||
---
|
||
|
||
## 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 |
|
||
|
||
---
|
||
|
||
## Proxy Providers
|
||
|
||
### 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
|
||
|
||
Plug any residential proxy into Human Browser via env vars.
|
||
**Recommended providers** (tested and verified):
|
||
|
||
| Provider | Quality | Price | Best for |
|
||
|---|---|---|---|
|
||
| **[Decodo](https://decodo.com)** (ex-Smartproxy) | ⭐⭐⭐⭐⭐ | ~$2.5/GB | Cloudflare, DataDome, all-round. No KYC. |
|
||
| **[Bright Data](https://get.brightdata.com/4ihj1kk8jt0v)** | ⭐⭐⭐⭐⭐ | ~$8.4/GB | Enterprise-grade, 72M+ IPs, 195 countries |
|
||
| **[IPRoyal](https://iproyal.com)** | ⭐⭐⭐⭐ | ~$1.75/GB | High volume, budget, ethically sourced |
|
||
| **[NodeMaven](https://nodemaven.com)** | ⭐⭐⭐⭐ | ~$3.5/GB | High success rate, pay-per-GB, no minimums |
|
||
| **[Oxylabs](https://oxylabs.io)** | ⭐⭐⭐⭐⭐ | ~$8/GB | Business-grade, dedicated support |
|
||
|
||
```env
|
||
PROXY_HOST=your-proxy-host
|
||
PROXY_PORT=22225
|
||
PROXY_USER=your-username
|
||
PROXY_PASS=your-password
|
||
```
|
||
|
||
---
|
||
|
||
## 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 |
|
||
|
||
---
|
||
|
||
→ **Product page + pricing:** https://humanbrowser.dev
|
||
→ **Support & questions:** https://t.me/virixlabs
|