Skip to main content 首页 创作者 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.
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/infometa/workbuddyskills --skill browser-cash命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... 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 protections
Real browser fingerprint : Appears as a genuine Chrome browser, not headless
CDP native : Direct WebSocket connection for Playwright, Puppeteer, or raw CDP
Geographic targeting : Spin up sessions in specific countries
Persistent 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