Playwright को क्लाउड में कैसे चलाएं?
- ब्राउज़र शुरू करें।
POST /v1/agents(या SDK मेंcreate_agent()) Browsa के क्लाउड में एक Phantom ब्राउज़र शुरू करता है और उसकाid, उसकाcdp_httpएड्रेस और एकlive_urlलौटाता है, जिसे खोलकर आप उसे देख सकते हैं। - कनेक्ट करें।
chromium.launch()की जगहchromium.connect_over_cdp(cdp_http, headers={"X-API-Key": API_KEY})लिखें, याpuppeteer.launch()की जगहpuppeteer.connect({ browserURL, headers })। ब्राउज़र में पहले से एक कॉन्टेक्स्ट और एक खुला पेज है: उसी का इस्तेमाल करें। - साफ़ करें। काम पूरा होने पर
destroy_agent()कॉल करें, या TTL ख़त्म होने पर ब्राउज़र को बंद होने दें। वह जितने शुरू हुए 12 मिनट चला, हर एक का 1 क्रेडिट लगता है; बाकी रिज़र्व किया हुआ वापस आ जाता है।
आपको एक Browsa API की चाहिए (यह agt_live_ से शुरू होती है)। 100 मुफ़्त क्रेडिट के लिए साइन अप करें, ईमेल वेरिफ़ाई करते ही मिलते हैं, कोई कार्ड नहीं। आपकी मशीन या Docker इमेज में Chrome इंस्टॉल करने की ज़रूरत नहीं।
अपना क्लाइंट कनेक्ट करें
Python में Playwright
pip install browsa playwrightplaywright install की ज़रूरत नहीं: ब्राउज़र Browsa पर चलता है।
import os
from browsa import Client
from playwright.sync_api import sync_playwright
API_KEY = os.environ["BROWSA_API_KEY"]
client = Client(api_key=API_KEY)
agent = client.create_agent(ttl="10m") # a cloud browser, up to 10 minutes
try:
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())
# the rest is plain Playwright
finally:
client.destroy_agent(agent["id"])TypeScript या Node में Playwright
npm i browsa playwrightimport { Client } from "browsa";
import { chromium } from "playwright";
const apiKey = process.env.BROWSA_API_KEY!;
const client = new Client({ apiKey });
const agent = await client.createAgent({ ttl: "10m" });
try {
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());
} finally {
await client.destroyAgent(agent.id);
}Puppeteer
puppeteer-core इस्तेमाल करें। इसका API puppeteer जैसा ही है, लेकिन यह ब्राउज़र डाउनलोड नहीं करता, जिसकी अब आपको ज़रूरत नहीं।
npm i browsa puppeteer-coreimport { Client } from "browsa";
import puppeteer from "puppeteer-core";
const apiKey = process.env.BROWSA_API_KEY!;
const client = new Client({ apiKey });
const agent = await client.createAgent({ ttl: "5m" });
try {
const browser = await puppeteer.connect({
browserURL: agent.cdp_http,
headers: { "X-API-Key": apiKey },
});
const [page] = await browser.pages();
await page.goto("https://example.com");
console.log(await page.title());
await browser.disconnect();
} finally {
await client.destroyAgent(agent.id);
}सीधा CDP और दूसरे क्लाइंट
क्रिएट रिस्पॉन्स में दो एड्रेस होते हैं। cdp_http ब्राउज़र का HTTP एंडपॉइंट है, जिसकी Playwright और Puppeteer को ज़रूरत होती है। cdp_url एक पेज का WebSocket है, उन क्लाइंट के लिए जो सीधे CDP बोलते हैं। दोनों को X-API-Key हेडर में आपकी की चाहिए। जो भी लाइब्रेरी कस्टम हेडर के साथ CDP पर किसी मौजूदा ब्राउज़र से जुड़ सकती है, वह यही एड्रेस इस्तेमाल कर सकती है; browser-use और Stagehand गाइड इसी तरह काम करती हैं।
SDK के बिना, सादे HTTP से ब्राउज़र शुरू करें:
curl https://browsa.io/v1/agents \
-H "X-API-Key: $BROWSA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ttl": "10m", "initial_url": "https://example.com"}'
# -> { "id": "agt_…", "status": "running", "cdp_http": "https://browsa.io/api/v1/cdp/…",
# "cdp_url": "wss://browsa.io/api/v1/cdp/…/ws/page/…", "live_url": "…", "cost_credits": 5 }cost_credits वह है जो ब्राउज़र चलते समय होल्ड रखता है: 5 मिनट तक के TTL के लिए 1 क्रेडिट, उससे लंबे के लिए 5। ख़त्म होने पर 12 मिनट के जो ब्लॉक इस्तेमाल नहीं हुए, वे आपके बैलेंस में लौट जाते हैं।
लोकल ब्राउज़र से क्या अलग है?
व्यूपोर्ट और यूज़र एजेंट
स्क्रीन साइज़, यूज़र एजेंट, टाइमज़ोन, भाषा, जियोलोकेशन और CPU काउंट ब्राउज़र शुरू होते समय एक साथ सेट होते हैं। CDP इम्यूलेशन कमांड जो इनमें से सिर्फ़ एक को बदलती हैं, सफलता लौटाती हैं पर कुछ नहीं बदलतीं, इसलिए page.set_viewport_size(), page.setViewport() और page.setUserAgent() का कोई असर नहीं होता।
क्या करेंPOST /v1/agents को screen_resolution और os_type दें। इम्यूलेशन ख़ुद चलाने के लिए CDP एड्रेस की क्वेरी में cdp_overrides=allow जोड़ें; तब फ़िंगरप्रिंट को एक जैसा रखना आपकी ज़िम्मेदारी है।
कॉन्टेक्स्ट और पेज
ब्राउज़र एक कॉन्टेक्स्ट और एक खुले पेज के साथ शुरू होता है।
क्या करेंनया कॉन्टेक्स्ट बनाने की जगह browser.contexts[0] और उसका पहला पेज इस्तेमाल करें।
फ़ाइल डाउनलोड
डाउनलोड की गई फ़ाइलें क्लाउड ब्राउज़र में ही रहती हैं, और Playwright का download इवेंट canceled बताता है।
क्या करेंफ़ाइल पेज के अंदर से फ़ेच करें (नीचे देखें), जिसमें ब्राउज़र की कुकीज़ और IP एड्रेस इस्तेमाल होते हैं।
लाइफ़टाइम
ब्राउज़र अपना TTL ख़त्म होने तक चलता है, ज़्यादा से ज़्यादा 1 घंटा, या जब तक आप उसे बंद न करें। खाली बैठे रहने पर वह बंद नहीं होता।
क्या करेंजितना TTL चाहिए, उतना मांगें ("5m" से "1h")। लंबे जॉब के लिए नया ब्राउज़र शुरू करें, या उनके बीच लॉगिन बनाए रखने के लिए सेव की गई आइडेंटिटी इस्तेमाल करें।
नेटवर्क
प्रॉक्सी के बिना, ट्रैफ़िक Browsa के डेटा सेंटर से डेटा-सेंटर IP एड्रेस के साथ निकलता है।
क्या करेंproxy में Browsa का नेटवर्क ({"network": "residential"}) या अपनी HTTP, HTTPS या SOCKS5 प्रॉक्सी दें, या proxy_id में सेव की गई प्रॉक्सी।
ऑटोमेशन सिग्नल
Playwright और Puppeteer जुड़ते समय CDP का Runtime डोमेन चालू करते हैं, और कुछ बॉट चेक इसे देख सकते हैं।
क्या करेंअगर कोई साइट आपके क्लाइंट को फ़्लैग करे, तो Runtime.enable के बिना कोई सीधा CDP क्लाइंट आज़माएं, या Browsa का अपना टास्क एजेंट (POST /v1/tasks)। तारीख वाले नतीजे बेंचमार्क पेज पर देखें।
पैरलल ब्राउज़र
हर वर्कस्पेस में 6 ब्राउज़र स्लॉट। सारे स्लॉट भरे होने पर रिक्वेस्ट 429 और Retry-After: 30 लौटाती है, और कोई चार्ज नहीं लगता।
क्या करेंकाम को अपनी तरफ़ क्यू करें, या ज़्यादा स्लॉट के लिए support@browsa.io पर ईमेल करें।
कनेक्शन टूटने के बाद दोबारा कैसे कनेक्ट करें?
अपना Playwright या Puppeteer कनेक्शन बंद करने से ब्राउज़र नहीं रुकता। वह TTL ख़त्म होने तक चलता रहता है, इसलिए कोई दूसरा प्रोसेस उससे जुड़ सकता है। GET /v1/agents/{id}/cdp से (या Python में get_agent(agent_id), TypeScript में getAgent(agentId) से) उसका एड्रेस फिर से लें और उसी X-API-Key हेडर के साथ कनेक्ट करें। ब्राउज़र के बंद हो जाने पर एंडपॉइंट 409 लौटाता है।
फ़ाइल कैसे डाउनलोड करें?
उसे पेज के अंदर से फ़ेच करें और बाइट्स लौटाएं:
import base64
b64 = page.evaluate("""async (url) => {
const buf = new Uint8Array(await (await fetch(url)).arrayBuffer());
let s = ""; for (const b of buf) s += String.fromCharCode(b);
return btoa(s);
}""", "https://example.com/report.pdf")
open("report.pdf", "wb").write(base64.b64decode(b64))अपनी प्रॉक्सी कैसे इस्तेमाल करें?
ब्राउज़र शुरू करते समय एक proxy ऑब्जेक्ट जोड़ें। तब ब्राउज़र प्रॉक्सी का IP एड्रेस इस्तेमाल करता है, और country सेट हो तो उसका टाइमज़ोन और भाषा उस देश के हिसाब से होते हैं। Browsa पर प्रॉक्सी ट्रैफ़िक का कोई अतिरिक्त चार्ज नहीं।
curl https://browsa.io/v1/agents \
-H "X-API-Key: $BROWSA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"ttl": "10m",
"proxy": {"type": "http", "host": "proxy.example.com", "port": 8080,
"username": "your-proxy-user", "password": "your-proxy-password"},
"country": "de"
}'प्रॉक्सी तक पहुंच न हो तब भी सीधे शुरू किया गया ब्राउज़र चालू हो जाता है, इसलिए पहले प्रॉक्सी चेक करें। सेव की गई प्रॉक्सी का एक चेक एंडपॉइंट होता है और उसे proxy_id के रूप में दिया जा सकता है।
रन के बीच लॉगिन कैसे बनाए रखें?
बर्नर की जगह परसिस्टेंट आइडेंटिटी इस्तेमाल करें। यह सेशन के बीच अपनी कुकीज़, लोकल स्टोरेज और फ़िंगरप्रिंट बनाए रखती है। इसे एक बार "mode": "persistent" से बनाएं, फिर जब भी किसी स्क्रिप्ट को ज़रूरत हो, एक सेशन खोलें: POST /v1/agents/{id}/sessions नए ब्राउज़र जैसा ही रिस्पॉन्स लौटाता है, cdp_http समेत, और आप उससे ठीक ऊपर की तरह कनेक्ट करते हैं। एक आइडेंटिटी हर 30 दिन में 50 क्रेडिट की है और हर सेशन 1 क्रेडिट का। सेशन खोलें देखें।
इसकी लागत क्या है?
| आप क्या चलाते हैं | क्रेडिट |
|---|---|
| ब्राउज़र जो 12 मिनट तक चलता है | 1 |
| ब्राउज़र जो पूरा एक घंटा चलता है | 5 |
| परसिस्टेंट आइडेंटिटी, हर 30 दिन | 50 |
| परसिस्टेंट आइडेंटिटी पर सेशन (1 घंटे तक) | 1 |
| ब्राउज़र जो शुरू नहीं हो पाता | रिफ़ंड |
$20 के Starter पैक पर एक क्रेडिट $0.10 का है और बड़े पैक पर कम। क्रेडिट कभी एक्सपायर नहीं होते। पूरी प्राइसिंग।
ट्रबलशूटिंग
कनेक्ट करते समय 401 Unauthorized
X-API-Key हेडर Browsa तक नहीं पहुंचा, या की गलत है। इसे कनेक्ट कॉल पर ठीक उदाहरणों की तरह भेजें, और देखें कि की agt_ से शुरू होती है।
ब्राउज़र शुरू करते समय 402
INSUFFICIENT_CREDIT का मतलब है कि बैलेंस आपके मांगे गए TTL को कवर नहीं कर सकता; BUDGET_REACHED का मतलब है कि आपकी मंथली ख़र्च सीमा पूरी हो गई है। GET /v1/credits और GET /v1/budget चेक करें।
कुछ मिनट बाद कनेक्शन टूट जाता है
ब्राउज़र अपने TTL के अंत तक पहुंच गया। लंबा TTL मांगें, "1h" तक।
सवाल
set_viewport_size() से ब्राउज़र क्यों नहीं बदलता?
Browsa ब्राउज़र का स्क्रीन साइज़, यूज़र एजेंट, टाइमज़ोन, भाषा और जियोलोकेशन ब्राउज़र बनते समय एक साथ सेट होते हैं, ताकि पेज को एक ही, एक जैसी मशीन दिखे। CDP इम्यूलेशन कमांड जो इनमें से सिर्फ़ एक को बदलतीं, सफलता लौटाती हैं पर कुछ नहीं बदलतीं। ब्राउज़र बनाते समय screen_resolution और os_type सेट करें, या अगर इम्यूलेशन ख़ुद चलाना है तो CDP एड्रेस में cdp_overrides=allow जोड़ें।
क्लाउड ब्राउज़र से फ़ाइल कैसे डाउनलोड करें?
पेज जो फ़ाइलें डाउनलोड करता है, वे क्लाउड ब्राउज़र में ही रहती हैं, और Playwright डाउनलोड को canceled बताता है। फ़ाइल को पेज के अंदर से page.evaluate() से फ़ेच करें, जिसमें ब्राउज़र की कुकीज़ और IP एड्रेस इस्तेमाल होते हैं, और बाइट्स को base64 में लौटाएं।
एक साथ कितने ब्राउज़र चल सकते हैं?
एक वर्कस्पेस में 6 ब्राउज़र स्लॉट हैं। हर चलता ब्राउज़र एक स्लॉट लेता है, और हर सेव की गई आइडेंटिटी भी। सारे स्लॉट भरे हों तो नया ब्राउज़र 429 TOO_MANY_REQUESTS और Retry-After: 30 लौटाता है, और कोई चार्ज नहीं लगता। ज़्यादा चाहिए तो support@browsa.io पर ईमेल करें।
क्या Browsa प्रॉक्सी देता है?
हाँ। डेटा सेंटर प्रॉक्सी 5 क्रेडिट प्रति GB, रेज़िडेंशियल 50 क्रेडिट प्रति GB। या हर ब्राउज़र के लिए अपनी HTTP, HTTPS या SOCKS5 प्रॉक्सी दें, मुफ़्त। प्रॉक्सी के बिना ब्राउज़र Browsa के डेटा सेंटर का IP एड्रेस इस्तेमाल करता है।