From 8ab3179cbbe1682726aabb121e92d92e4eabb7a6 Mon Sep 17 00:00:00 2001 From: Ilya <72158359+al1enjesus@users.noreply.github.com> Date: Thu, 19 Feb 2026 13:24:36 +0700 Subject: [PATCH 1/2] =?UTF-8?q?Update=20human-browser=20to=20v3.0.0=20?= =?UTF-8?q?=E2=80=94=206=20countries,=20agent-native=20payment,=20humanbro?= =?UTF-8?q?wser.dev?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/al1enjesus/human-browser/SKILL.md | 258 +++++++++++++++++++---- 1 file changed, 221 insertions(+), 37 deletions(-) diff --git a/skills/al1enjesus/human-browser/SKILL.md b/skills/al1enjesus/human-browser/SKILL.md index c67a729fce..d0e42bf32c 100644 --- a/skills/al1enjesus/human-browser/SKILL.md +++ b/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,24 +73,152 @@ 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')] @@ -70,18 +226,46 @@ await page.evaluate((text) => { }, '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` From d8ccc887be8cedbbe5dc952792a88a44be756704 Mon Sep 17 00:00:00 2001 From: Ilya <72158359+al1enjesus@users.noreply.github.com> Date: Thu, 19 Feb 2026 13:24:50 +0700 Subject: [PATCH 2/2] Bump version to 3.0.0 --- skills/al1enjesus/human-browser/_meta.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/skills/al1enjesus/human-browser/_meta.json b/skills/al1enjesus/human-browser/_meta.json index 50e6ed93d5..4e336729bb 100644 --- a/skills/al1enjesus/human-browser/_meta.json +++ b/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": [] }