दो मोड, एक एंडपॉइंट
- बर्नर: अस्थायी, 5 मिनट से 1 घंटे तक का TTL, ख़ुद ख़त्म हो जाता है, जितने मिनट चला उतना बिल। स्क्रेप जॉब, एक बार के ऑटोमेशन और CI रन के लिए सबसे सही।
- परसिस्टेंट: टिकाऊ, वॉल्ट में सिंक होने वाली प्रोफ़ाइल (कुकीज़, localStorage, फ़िंगरप्रिंट), महीने का बिल, ज़रूरत पड़ने पर सेशन खुलते हैं। लंबे चलने वाले उन एजेंट्स के लिए सबसे सही जो हर रन में लॉग-इन स्टेट बनाए रखते हैं।
हर एंडपॉइंट https://browsa.io के नीचे है। X-API-Key: agt_live_… से ऑथेंटिकेट करें। की मुफ़्त साइन अप से पाएं (ईमेल वेरिफ़ाई करते ही 100 क्रेडिट, कोई कार्ड नहीं), फिर डैशबोर्ड में नई की बनाएं।
क्विकस्टार्ट
शुरू करने के दो तरीके। ज़्यादातर लोग पहला चाहते हैं।
1. कोई पेज स्क्रेप करें (कोई एजेंट नहीं, कोई LLM नहीं)
एक POST पेज को साफ़ Markdown और लिंक के रूप में लौटाता है, असली ब्राउज़र में रेंडर करके। 1 क्रेडिट, कोई LLM की नहीं, और HTTP रिस्पॉन्स ही डेटा है।
# Scrape any URL → clean Markdown + links in one call.
curl -X POST https://browsa.io/v1/quick/scrape \
-H "X-API-Key: agt_live_…" \
-H "Content-Type: application/json" \
-d '{"url":"https://news.ycombinator.com","formats":["markdown","links"]}'
# → { "markdown": "...", "links": [...], "http_status": 200 }2. ब्राउज़र ख़ुद चलाएं: CDP पर Playwright
तीन लाइन में एक क्लाउड ब्राउज़र, जिसे आपका कोड कंट्रोल करता है। एक बर्नर बनाएं, फिर लौटाए गए cdp_http URL से Playwright/Puppeteer जोड़ें, अपनी की X-API-Key हेडर में देकर। कोई इंफ्रास्ट्रक्चर नहीं, कोई फ़िंगरप्रिंट ट्यूनिंग नहीं।
# Provision a burner agent - returns CDP URL you can attach to.
curl https://browsa.io/v1/agents \
-H "X-API-Key: agt_live_…" \
-H "Content-Type: application/json" \
-d '{"ttl":"10m","initial_url":"https://example.com"}'# pip install browsa
from browsa import Client
from playwright.sync_api import sync_playwright
API_KEY = "agt_live_…"
client = Client(api_key=API_KEY)
agent = client.create_agent(ttl="10m")
with sync_playwright() as p:
browser = p.chromium.connect_over_cdp(agent["cdp_http"], headers={"X-API-Key": API_KEY})
context = browser.contexts[0]
page = context.pages[0] if context.pages else context.new_page()
page.goto("https://example.com")
print(page.title())// npm i browsa playwright
import { Client } from "browsa";
import { chromium } from "playwright";
const apiKey = "agt_live_…";
const client = new Client({ apiKey });
const agent = await client.createAgent({ ttl: "10m" });
const browser = await chromium.connectOverCDP(agent.cdp_http, { headers: { "X-API-Key": apiKey } });
const context = browser.contexts()[0];
const page = context.pages()[0] ?? await context.newPage();
await page.goto("https://example.com");
console.log(await page.title());बस इतना ही। TTL शून्य होने पर (या जब आप उसे DELETE करें) एजेंट ख़त्म हो जाता है। आप उतने समय का पेमेंट करते हैं जितना वह चला: हर शुरू हुए 12 मिनट पर 1 क्रेडिट, पूरे एक घंटे के 5 क्रेडिट। शुरू करते समय आपके मांगे गए TTL की कीमत होल्ड होती है (5 मिनट तक 1 क्रेडिट, उससे ऊपर 5 क्रेडिट); जो ब्लॉक इस्तेमाल नहीं होते, वे ख़त्म होने पर लौट आते हैं।
ऑथेंटिकेशन
हर रिक्वेस्ट में X-API-Key हेडर में API की चाहिए। की डैशबोर्ड में बनती हैं और agt_live_ के बाद 24 हेक्स कैरेक्टर जैसी दिखती हैं।
X-API-Key: agt_live_aabbccddeeff001122334455जो क्लाइंट हमेशा Authorization हेडर भेजते हैं, उनके लिए Bearer auth भी चलता है (की वही)।
की सीक्रेट रखें। रॉ सीक्रेट बनाते समय सिर्फ़ एक बार दिखता है। हम सिर्फ़ sha256(secret) सेव करते हैं। अगर की लीक हो जाए, तो डैशबोर्ड से उसे रिवोक करें और नई बनाएं।
आइडेम्पोटेंसी
हर POST /v1/quick/* एंडपॉइंट, POST /v1/tasks, POST /v1/auto और POST /v1/sessions/{id}/messages एक Idempotency-Key हेडर लेते हैं (Stripe जैसा)। POST /v1/agents नहीं लेता: हर कॉल एक नया ब्राउज़र शुरू करती है, और उसका बिल बनता है। हर लॉजिकल रिक्वेस्ट के लिए एक UUID भेजें, प्लेटफ़ॉर्म पूरा रिस्पॉन्स 24 घंटे के लिए कैश कर लेता है। उसी की के साथ रीट्राई करने पर कैश किया गया बॉडी बाइट-दर-बाइट Idempotent-Replay: true के साथ लौटता है: न दूसरा बर्नर बनता है, न दूसरा चार्ज लगता है।
curl -X POST https://browsa.io/v1/quick/scrape \
-H "X-API-Key: agt_live_…" \
-H "Idempotency-Key: 7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'इसे हर उस रीट्राई पाथ के लिए इस्तेमाल करें जो आपकी क्लाइंट लाइब्रेरी अपने आप करती है (जैसे बैकऑफ़ के साथ requests.Session)। इसके बिना, नेटवर्क की एक छोटी सी गड़बड़ी स्क्रेप को दोबारा चला सकती है और दो बार चार्ज लग सकता है।
रिक्वेस्ट ID
हर रिस्पॉन्स (सफल हो या एरर) में X-Request-Id हेडर होता है। एरर एनवेलप के JSON बॉडी में request_id भी होता है। किसी भी दिक्कत में इसे support@browsa.io पर बताएं, ताकि हम अपने लॉग में आपकी रिक्वेस्ट ढूंढ सकें।
SDK
REST API के ऊपर बिना डिपेंडेंसी वाले रैपर: टाइप्ड रिस्पॉन्स, लॉन्ग-पोल waitForJob, HMAC वेबहुक सिग्नेचर वेरिफ़िकेशन, और पूरा {code, error, request_id} एनवेलप टाइप्ड एरर में मैप किया हुआ। Python और TypeScript में एक जैसा इंटरफ़ेस।
Python
pip install browsafrom browsa import Client
c = Client(api_key="agt_live_...")
job = c.run_task(
task="Go to news.ycombinator.com and return the top story title.",
llm="claude-opus-5-5",
llm_api_key="sk-ant-...",
)
print(job.final_result)
print("watch live:", job.live_url)पैकेज: PyPI पर browsa (Python 3.9+, कोई डिपेंडेंसी नहीं, MIT)।
TypeScript / Node
npm i browsaimport { Client } from "browsa";
const c = new Client({ apiKey: "agt_live_..." });
const job = await c.runTask({
task: "Go to news.ycombinator.com and return the top story title.",
llm: "claude-opus-5-5",
llmApiKey: "sk-ant-...",
});
console.log(job.finalResult);
console.log("watch live:", job.liveUrl);पैकेज: npm पर browsa (Node 18+, कोई डिपेंडेंसी नहीं, ESM + CJS, पूरा .d.ts, MIT)।
MCP सर्वर: Claude Desktop, Cursor, Cline
किसी भी MCP-कम्पैटिबल क्लाइंट से एक कॉन्फ़िग ब्लॉक के साथ प्लेटफ़ॉर्म चलाएं। एजेंट को 13 टूल मिलते हैं: run_task, get_job, cancel_job, respond_to_job, list_job_files, create_schedule, list_schedules, list_llm_keys, credits, list_webhooks, create_webhook, delete_webhook, list_identities।
कॉन्फ़िग में किसी LLM सीक्रेट की ज़रूरत नहीं। अपने वर्कस्पेस में एक LLM की सेव करें, और सर्वर पहले आपकी डिफ़ॉल्ट सेव की गई की आज़माता है। BROWSA_LLM_API_KEY देना ज़रूरी नहीं। अगर कोई सेव की गई की नहीं है और llm सेट नहीं है, तो टास्क Browsa के डिफ़ॉल्ट होस्टेड टियर ("llm": "browsa") पर चलते हैं, जो उस टियर के प्रति टास्क क्रेडिट जोड़ता है, और सर्वर यह बता देता है। बिना की के साफ़ तौर पर दिया गया llm LLM_KEY_REQUIRED लौटाता है। कोई ख़ास सेव की गई की चुनने के लिए BROWSA_LLM_KEY_ID सेट करें।
{
"mcpServers": {
"browsa": {
"command": "npx",
"args": ["-y", "@browsa/mcp"],
"env": {
"BROWSA_API_KEY": "agt_live_..."
}
}
}
}इसे ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) या %APPDATA%\Claude\claude_desktop_config.json (Windows) में डालें, फिर Claude Desktop रीस्टार्ट करें। पूछें: "news.ycombinator.com पर जाओ और टॉप स्टोरी का टाइटल बताओ।"
पैकेज: npm पर @browsa/mcp (Claude Desktop, Cursor, Cline, Continue, Zed में चलता है, MIT)। Claude Code, Cursor और VS Code के लिए सेटअप: MCP सर्वर गाइड।
उदाहरण
पैकेज पेजों पर एक क्विकस्टार्ट और एक वेबहुक रिसीवर है: PyPI पर Python, npm पर TypeScript। पूरी स्क्रिप्ट के लिए कुकबुक और फ़्रेमवर्क गाइड देखें।
OpenAPI स्पेक
Postman, Insomnia, Swagger UI या किसी भी OpenAPI 3.1 क्लाइंट में इम्पोर्ट करें। पूरा API https://browsa.io/openapi.yaml पर पब्लिश है।
# Generate a typed client in any language with openapi-generator-cli
npx @openapitools/openapi-generator-cli generate \
-i https://browsa.io/openapi.yaml \
-g typescript-axios -o ./browsa-client