Skip to main content Home Creators infometa workbuddyskills browser-cash
browser-cash Cloud browser sessions via Browser.cash API that bypass anti-bot protections (Cloudflare, DataDome). Spin up unblocked browser instances for scraping, form filling, testing. Sessions appear as real browsers. Requires: BROWSER_CASH_API_KEY, curl, jq.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Show prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/infometa/workbuddyskills --skill browser-cashThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository
Related occupations SOC
Based on SOC occupation classification
name browser-cash description Cloud browser sessions via Browser.cash API that bypass anti-bot protections (Cloudflare, DataDome). Spin up unblocked browser instances for scraping, form filling, testing. Sessions appear as real browsers. Requires: BROWSER_CASH_API_KEY, curl, jq. description_zh Browser.cash 云端反封锁浏览器会话（绕过 Cloudflare 等） description_en Browser.cash cloud sessions bypassing anti-bot protections (Cloudflare, etc.) version 1.0.0 homepage https://browser.cash allowed-tools Bash metadata {"clawdbot":{"emoji":"🌐","requires":{"bins":"[Truncated]"}}}
browser-cash
Spin up unblocked browser sessions via Browser.cash for web automation. These sessions bypass common anti-bot protections (Cloudflare, DataDome, etc.), making them ideal for scraping, testing, and automation tasks that would otherwise get blocked.
When to use: Any browser automation task—scraping, form filling, testing, screenshots. Browser.cash sessions appear as real browsers and handle bot detection automatically.
Setup
API Key is stored in clawdbot config at skills.entries.browser-cash.apiKey.
If not configured, prompt the user:
Get your API key from https://dash.browser.cash and run:
clawdbot config set skills.entries.browser-cash.apiKey "your_key_here"
Reading the key:
BROWSER_CASH_KEY=$(clawdbot config get skills.entries.browser-cash.apiKey)
Before first use , check and install Playwright if needed:
if [ ! -d ~/clawd/node_modules/playwright ]; then
cd ~/clawd && npm install playwright puppeteer-core
fi
API Basics
curl -X POST "https://api.browser.cash/v1/..." \
-H "Authorization: Bearer $BROWSER_CASH_KEY " \
-H "Content-Type: application/json"
Create a Browser Session
Basic session:
curl -X POST "https://api.browser.cash/v1/browser/session" \
-H "Authorization: Bearer $BROWSER_CASH_KEY " \
-H "Content-Type: application/json" \
-d '{}'
Response:
{
"sessionId" : "abc123..." ,
"status"
:
"active"
,
"servedBy"
:
"node-id"
,
"createdAt"
:
"2025-01-20T01:51:25.000Z"
,
"stoppedAt"
:
null
,
"cdpUrl"
:
"wss://gcp-usc1-1.browser.cash/v1/consumer/abc123.../devtools/browser/uuid"
}
curl -X POST "https://api.browser.cash/v1/browser/session" \
-H "Authorization: Bearer $BROWSER_CASH_KEY " \
-H "Content-Type: application/json" \
-d '{
"country": "US",
"windowSize": "1920x1080",
"profile": {
"name": "my-profile",
"persist": true
}
}'
Session Options Option Type Description countrystring 2-letter ISO code (e.g., "US", "DE", "GB") windowSizestring Browser dimensions, e.g., "1920x1080" proxyUrlstring SOCKS5 proxy URL (optional) profile.namestring Named browser profile for session persistence profile.persistboolean Save cookies/storage after session ends
Using Browser.cash with Clawdbot Browser.cash returns a WebSocket CDP URL (wss://...). Use one of these approaches:
Option 1: Direct CDP via exec (Recommended) Important: Before running Playwright/Puppeteer scripts, ensure dependencies are installed:
[ -d ~/clawd/node_modules/playwright ] || (cd ~/clawd && npm install playwright puppeteer-core)
Use Playwright or Puppeteer in an exec block to connect directly to the CDP URL:
BROWSER_CASH_KEY=$(clawdbot config get skills.entries.browser-cash.apiKey)
SESSION=$(curl -s -X POST "https://api.browser.cash/v1/browser/session" \
-H "Authorization: Bearer $BROWSER_CASH_KEY " \
-H "Content-Type: application/json" \
-d '{"country": "US", "windowSize": "1920x1080"}' )
SESSION_ID=$(echo $SESSION | jq -r '.sessionId' )
CDP_URL=$(echo $SESSION | jq -r '.cdpUrl' )
node -e "
const { chromium } = require('playwright');
(async () => {
const browser = await chromium.connectOverCDP('$CDP_URL ');
const context = browser.contexts()[0];
const page = context.pages()[0] || await context.newPage();
await page.goto('https://example.com');
console.log('Title:', await page.title());
await browser.close();
})();
"
curl -X DELETE "https://api.browser.cash/v1/browser/session?sessionId=$SESSION_ID " \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
Option 2: Curl-based automation For simple tasks, use curl to interact with pages via CDP commands:
Note on Clawdbot browser tool Clawdbot's native browser tool expects HTTP control server URLs, not raw WebSocket CDP. The gateway config.patch approach works when Clawdbot's browser control server proxies the connection. For direct Browser.cash CDP, use the exec approach above.
Get Session Status curl "https://api.browser.cash/v1/browser/session?sessionId=YOUR_SESSION_ID" \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
Statuses: starting, active, completed, error
Stop a Session curl -X DELETE "https://api.browser.cash/v1/browser/session?sessionId=YOUR_SESSION_ID" \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
List Sessions curl "https://api.browser.cash/v1/browser/sessions?page=1&pageSize=20" \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
Browser Profiles Profiles persist cookies, localStorage, and session data across sessions—useful for staying logged in or maintaining state.
curl "https://api.browser.cash/v1/browser/profiles" \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
curl -X DELETE "https://api.browser.cash/v1/browser/profile?profileName=my-profile" \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
Connecting via CDP The cdpUrl is a WebSocket endpoint for Chrome DevTools Protocol. Use it with any CDP-compatible library.
const { chromium } = require ('playwright' );
const browser = await chromium.connectOverCDP (cdpUrl);
const context = browser.contexts ()[0 ];
const page = context.pages ()[0 ] || await context.newPage ();
await page.goto ('https://example.com' );
const puppeteer = require ('puppeteer-core' );
const browser = await puppeteer.connect ({ browserWSEndpoint : cdpUrl });
const pages = await browser.pages ();
const page = pages[0 ] || await browser.newPage ();
await page.goto ('https://example.com' );
Full Workflow Example
[ -d ~/clawd/node_modules/playwright ] || (cd ~/clawd && npm install playwright puppeteer-core)
BROWSER_CASH_KEY=$(clawdbot config get skills.entries.browser-cash.apiKey)
SESSION=$(curl -s -X POST "https://api.browser.cash/v1/browser/session" \
-H "Authorization: Bearer $BROWSER_CASH_KEY " \
-H "Content-Type: application/json" \
-d '{"country": "US", "windowSize": "1920x1080"}' )
SESSION_ID=$(echo $SESSION | jq -r '.sessionId' )
CDP_URL=$(echo $SESSION | jq -r '.cdpUrl' )
curl -X DELETE "https://api.browser.cash/v1/browser/session?sessionId=$SESSION_ID " \
-H "Authorization: Bearer $BROWSER_CASH_KEY "
Scraping Tips When extracting data from pages with lazy-loading or infinite scroll:
async function scrollToBottom (page ) {
let previousHeight = 0 ;
while (true ) {
const currentHeight = await page.evaluate (() => document .body .scrollHeight );
if (currentHeight === previousHeight) break ;
previousHeight = currentHeight;
await page.evaluate (() => window .scrollTo (0 , document .body .scrollHeight ));
await page.waitForTimeout (1500 );
}
}
await page.waitForSelector ('.product-card' , { timeout : 10000 });
const loadMore = await page.$('button.load-more' );
if (loadMore) {
await loadMore.click ();
await page.waitForTimeout (2000 );
}
Always scroll to trigger lazy-loaded content
Wait for network idle: await page.waitForLoadState('networkidle')
Use page.waitForSelector() before extracting elements
Add delays between actions to avoid rate limiting
Why Browser.cash for Automation
Unblocked : Sessions bypass Cloudflare, DataDome, PerimeterX, and other bot protectionsReal browser fingerprint : Appears as a genuine Chrome browser, not headlessCDP native : Direct WebSocket connection for Playwright, Puppeteer, or raw CDPGeographic targeting : Spin up sessions in specific countriesPersistent profiles : Maintain login state across sessions
Notes
Sessions auto-terminate after extended inactivity
Always stop sessions when done to avoid unnecessary usage
Use profiles when you need to maintain logged-in state
SOCKS5 is the only supported proxy type
Clawdbot runs scripts from ~/clawd/ - install npm dependencies there
For full page scraping, always scroll to trigger lazy-loaded content
