Update human-browser to v3.0.0 — 6 countries, agent-native payment API

skills/al1enjesus/human-browser/SKILL.md

@@ -1,42 +1,70 @@
 ---
 name: human-browser
-description: "Stealth browser with residential proxy for AI agents — runs on any server, no Mac Mini or desktop required. Use this skill for: web scraping, browser automation, bypassing Cloudflare, bypassing DataDome, bypassing PerimeterX, bypassing anti-bot, residential proxy setup, scraping Instagram, scraping LinkedIn, scraping Amazon, scraping TikTok, 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, web automation without getting blocked. 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."
+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 Browser for AI Agents
+# Human Browser — Cloud Stealth Browser for AI Agents
 
-> **No Mac Mini. No local machine. Runs on any server.**
-> Your AI agent gets a full browser with a real human fingerprint, anywhere.
+> **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
 
-## What this skill does
+---
+
+## 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)
 
-Gives your OpenClaw agent a Playwright browser that:
-- 🌍 Runs **100% in the cloud** — no desktop, no Mac Mini needed
-- 🇷🇴 Routes through **Romanian residential IP** (DIGI / WS Telecom via Bright Data)
-- 📱 Appears as **iPhone 15 Pro** (or Desktop Chrome) to every website
-- 🛡️ Bypasses **Cloudflare, DataDome, PerimeterX** — the 3 most common anti-bot systems
-- 🖱️ Moves mouse in **Bezier curves**, types at **60–220ms/char**, scrolls naturally
-- 🎭 Full anti-detection: `webdriver=false`, correct canvas, real timezone & geolocation
+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
+
+---
 
-## Get Credentials (required for proxy)
+## Country → Service Compatibility
 
-The skill works out of the box, but to use the residential proxy you need credentials:
+Pick the right country for the right service:
 
-**→ Get credentials at: https://openclaw.virixlabs.com**
-Plans start at **$13.99/mo** (includes proxy bandwidth)
+| 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 | — |
 
-Or bring your own Bright Data account — see `references/brightdata-setup.md`.
+**→ Interactive country selector + service matrix:** https://humanbrowser.dev
+
+---
 
 ## Quick Start
 
 ```js
 const { launchHuman } = require('./scripts/browser-human');
 
-// Mobile (iPhone 15 Pro) — default
-const { browser, page, humanType, humanClick, humanScroll } = await launchHuman();
+// Default: iPhone 15 Pro + Romania residential IP
+const { browser, page, humanType, humanClick, humanScroll, sleep } = await launchHuman();
 
-// Desktop Chrome
-const { browser, page } = await launchHuman({ mobile: false });
+// 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');
@@ -45,43 +73,199 @@ await humanClick(page, 760, 400);
 await browser.close();
 ```
 
-## Use cases
+---
+
+## 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
 
-- **Instagram / TikTok scraping** — residential IP bypasses all protections
-- **LinkedIn automation** — human typing + mouse = no detection
-- **E-commerce price monitoring** — Amazon, Wildberries, any Cloudflare site
-- **Form automation** — fills React forms correctly (humanType, not fill)
-- **Account creation flows** — OTP + stealth = clean sessions
-- **Any site that blocks data center IPs** — residential = always clean
+```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:
 
-## Key patterns
+```
+🌐 https://humanbrowser.dev
+```
 
-### React inputs
+---
+
+## 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');
-// Use humanType (delayed keystroke), NOT page.fill() — React detects fill()
 ```
 
-### Click buttons that have animations
+### 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
+### Verify your IP is residential
 ```js
 await page.goto('https://api.ipify.org?format=json');
-console.log(await page.textContent('body')); // Romanian IP
+const { ip } = JSON.parse(await page.textContent('body'));
+console.log('IP:', ip); // Should show a residential IP from your target country
 ```
 
-## Dependencies
+---
+
+## 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
 ```
 
-→ For Bright Data setup & billing: see `references/brightdata-setup.md`
-→ Support & credentials: https://t.me/virixlabs
+---
+
+## 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`

skills/al1enjesus/human-browser/_meta.json

@@ -3,9 +3,9 @@
   "slug": "human-browser",
   "displayName": "Human Browser",
   "latest": {
-    "version": "1.0.5",
-    "publishedAt": 1771442851731,
-    "commit": "https://github.com/openclaw/skills/commit/5b96df386b2803535a8215e4f01de8c43b53322a"
+    "version": "3.0.0",
+    "publishedAt": 1739951400000,
+    "commit": "https://github.com/al1enjesus/human-browser"
   },
   "history": []
 }