Aller au contenu

Migrer depuis Browserless

Browserless vous fournit une adresse WebSocket à laquelle connecter Puppeteer ou Playwright, dans son cloud ou dans son image Docker. Clearcote propose aussi les deux : seule change l’adresse à laquelle votre code se connecte. Le code de la page reste le même.

Depuis le cloud Browserless

Une adresse Browserless est fixe. Une session Clearcote est d’abord créée, et sa connectUrl ne sert qu’une fois : la seule étape nouvelle est donc un appel de création avant chaque connexion. Le SDK fait les deux en un seul appel.

import puppeteer from "puppeteer-core";

async function connectUrl(options = {}) {
  const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
    method: "POST",
    headers: { authorization: "Bearer " + process.env.CLEARCOTE_API_KEY, "content-type": "application/json" },
    body: JSON.stringify(options),
  });
  const { connectUrl, error } = await res.json();
  if (error) throw new Error(error);
  return connectUrl;                      // single-use: create one per connection
}

const browser = await puppeteer.connect({
  browserWSEndpoint: "wss://production-sfo.browserless.io?token=" + process.env.BROWSERLESS_TOKEN,
  browserWSEndpoint: await connectUrl({ identity: "acct-1", country: "us" }),
  defaultViewport: null,
});
const page = await browser.newPage();
await page.goto("https://example.com");
await browser.close();                    // ends the session

Récupérez la clé sur la page « API keys » ; le SDK la lit dans CLEARCOTE_API_KEY. Le navigateur démarre au moment de la connexion, généralement en quelques secondes ; avec un country, cela peut prendre jusqu’à une demi-minute environ. Donnez donc à connectOverCDP de Playwright un timeout de deux minutes. Gardez defaultViewport: null pour que Puppeteer conserve la taille de fenêtre que la persona a donnée au navigateur.

Où vont les options de l’URL

Les réglages que vous mettez dans l’URL Browserless vont dans le corps JSON de l’appel de création. Les flags de lancement de Chromium n’ont pas d’équivalent en hébergé : la persona et ses switches sont définis pour vous.

Vous voulezCorps de création
une sortie résidentielle dans un pays"country": "de" (aussi state, city) ; le pool géré est la valeur par défaut
votre propre proxy"proxy": { "server": "http://host:8080", "username": "…", "password": "…" }
la même IP et le même appareil pour un compte"identity": "acct-1"
des cookies conservés d’une session à l’autre"profile": { "name": "acct-1", "persist": true }
une durée maximale de session"timeoutSec", "idleTimeoutSec"
un enregistrement"record": true
vous reconnecter plus tard"keepAlive": true

Toutes les options sont dans Options et identités. Le stealth n’est pas une route à part : chaque navigateur hébergé exécute la persona au niveau du moteur, et les cases à cocher, les sliders et les vérifications par appui prolongé sont gérés par défaut (Défis). Il n’y a pas d’endpoints /content, /screenshot ou /pdf : écrivez-les en quelques lignes de Playwright, ou décrivez la tâche et lancez une exécution d’agent, qui renvoie du JSON.

Depuis l’image Docker de Browserless

clearcote serve est l’équivalent le plus proche de l’image open source : un endpoint permanent, un navigateur distinct par identité, les réglages dans l’URL de connexion.

docker run -p 3000:3000 -e TOKEN=... ghcr.io/browserless/chromium
pip install -U clearcote          # or: npm install -g clearcote
clearcote serve --port 9222 --idle-timeout 300 --max-browsers 16
python
p.chromium.connect_over_cdp("http://127.0.0.1:9222")                                     # one shared browser
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-1&platform=windows")  # a browser of its own
p.chromium.connect_over_cdp("http://127.0.0.1:9222?fingerprint=acct-2&proxy=http://user:pass@host:8080&geoip=true")

Pour une identité par conteneur, l’image teamflatearth/clearcote sert CDP sur le port 9222 ; voir Déploiement et Docker. Dans tous les cas, n’exposez le port que sur des réseaux de confiance : un port CDP donne le contrôle total du navigateur. Plusieurs navigateurs à la fois, ainsi que les proxys avec mot de passe, nécessitent une clé de licence : gratuite avec une connexion GitHub pour un navigateur à la fois, et Pro pour jusqu’à 250.

Ce que cela coûte

Les navigateurs hébergés se paient au GB de trafic depuis un solde prépayé, sans formule à choisir. Voir Tarifs et trafic, et Limites et erreurs pour la concurrence.

Mis à jour le 16 oct. 2026 · SDK 0.70.5 · navigateur r63

Cette page vous a-t-elle été utile ?