📖 Documentation BrowserIP
🌐 Français

Accès au navigateur

Chaque session dispose d'une adresse CDP dédiée (dans la console, cliquez sur « Copier l'adresse CDP ») ; l'identifiant de session est au format UUID :

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

Exemple d'identifiant de session au format UUID : 123e4567-e89b-12d3-a456-426614174000.

En coulisse, WebSocket passe par le chemin DevTools sous wss://browserip.com/s/<id>/<token>. La webSocketDebuggerUrl que les clients récupèrent via l'interface /json est déjà réécrite automatiquement – connectez-vous simplement via l'adresse CDP, sans reconstruire l'adresse WebSocket à la main. Chaque session utilise sa propre instance de navigateur (processus et contexte propres), entièrement isolée des autres.

Attention : cette adresse CDP n'est pas la même que l'adresse visuelle ouverte dans le navigateur – l'adresse de la page visuelle est https://browserip.com/view/<id>/<token> (dans la console, cliquez sur « Ouvrir ») et sert à piloter directement dans la page web ; l'adresse /s/ est destinée aux programmes (browser-use, Playwright, Puppeteer) pour la connexion CDP.

browser-use (Python)

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

# cdp_url s'obtient dans la console via « Copier l'adresse CDP »
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');
⏱️ Gardez la session active pendant l'accès : après 20 minutes sans activité CDP, elle est récupérée automatiquement ; pour les tâches longues, agissez régulièrement sur la page ou relancez une session.