📖 BrowserIP Dokumentation
🌐 Deutsch

Browserzugang

Jede Sitzung erhält eine eigene CDP-Adresse (in der Konsole auf „CDP-Adresse kopieren" klicken); die Sitzungs-ID hat das UUID-Format:

https://browserip.com/s/<id>/<token>

Beispiel für eine Sitzungs-ID im UUID-Format: 123e4567-e89b-12d3-a456-426614174000.

Im Hintergrund läuft WebSocket über den DevTools-Pfad unter wss://browserip.com/s/<id>/<token>. Die webSocketDebuggerUrl, die Clients über die /json-Schnittstelle erhalten, ist bereits automatisch umgeschrieben – verbinden Sie sich einfach über die CDP-Adresse, ohne die WebSocket-Adresse manuell zusammenzusetzen. Jede Sitzung nutzt eine eigene Browserinstanz (eigener Prozess und Kontext), vollständig voneinander isoliert.

Hinweis: Diese CDP-Adresse ist nicht dieselbe wie die visuelle Adresse, die Sie im Browser öffnen – die visuelle Seitenadresse lautet https://browserip.com/view/<id>/<token> (in der Konsole auf „Öffnen" klicken) und dient der direkten Bedienung durch Menschen im Web. Die /s/-Adresse ist für Programme (browser-use, Playwright, Puppeteer) zur CDP-Verbindung gedacht.

browser-use (Python)

from browser_use.browser import BrowserSession
from browser_use.agent.service import Agent

# cdp_url wird in der Konsole über „CDP-Adresse kopieren" bezogen
browser_session = BrowserSession(cdp_url="https://browserip.com/s/<id>/<token>")
agent = Agent(task="...", llm=..., browser_session=browser_session)
await agent.run()

Playwright

Python:

from playwright.async_api import async_playwright

async with async_playwright() as p:
    browser = await p.chromium.connect_over_cdp(
        "https://browserip.com/s/<id>/<token>")
    page = browser.contexts[0].pages[0]
    await page.goto("https://example.com")

JavaScript:

const { chromium } = require('playwright');

const browser = await chromium.connectOverCDP(
  'https://browserip.com/s/<id>/<token>');
const page = browser.contexts()[0].pages()[0];
await page.goto('https://example.com');

Puppeteer (JavaScript)

const puppeteer = require('puppeteer');

const browser = await puppeteer.connect({
  browserURL: 'https://browserip.com/s/<id>/<token>',
});
const page = (await browser.pages())[0];
await page.goto('https://example.com');
⏱️ Halten Sie die Sitzung während der Anbindung aktiv: Nach 20 Minuten ohne CDP-Aktivität wird sie zurückgefordert. Führen Sie bei langen Aufgaben regelmäßig Aktionen auf der Seite aus oder starten Sie neu.