Aller au contenu
Comment utiliser Capium Browser

Installez, authentifiez, pilotez.

Capium Browser est notre Chrome furtif propriétaire, sous licence par session et installé en une seule commande. Ajoutez votre clé de licence et pilotez-le en local avec l’API Playwright que vous connaissez déjà.

Pilotez-le comme Playwright

Naviguez, cliquez, saisissez, attendez des sélecteurs et le réseau. L’API Playwright standard fonctionne sans modification.

Un vrai Chrome furtif

Un authentique cœur Chrome toujours à jour, renforcé contre la détection des bots, ni stub headless ni wrapper patché.

Captures d’écran et PDF

Réalisez des captures d’écran pleine page ou générez le PDF de n’importe quelle page, exactement comme avec un navigateur local.

Sessions simultanées

Exécutez plusieurs navigateurs à la fois. Chaque navigateur actif compte pour une session dans la limite de votre forfait.

1. Prise en main

Installez la boîte à outils pour votre langage. Rien à héberger, rien à patcher. Le binaire furtif est récupéré au premier lancement et maintenu à jour automatiquement.

install.sh
# Python
pip install capiumbrowser
python -m playwright install-deps   # Chromium's OS libraries (once)

# JavaScript / TypeScript
npm install capiumbrowser

Ajoutez votre clé de licence et pilotez votre première page. Activez humanize=True pour des saisies et une temporisation humaines.

first_run.py
from capiumbrowser import launch_context

# Your license key is on the dashboard: Dashboard -> Capium Browser.
# Export it once:  export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# launch_context returns (browser, context, page); the always-latest
# stealth binary is downloaded on first run.
browser, ctx, page = launch_context(
    seed=200123,        # one seed = one coherent device
    humanize=True,      # human-like input + timing
    url="https://example.com",
)
print(page.title())
browser.close()

2. Authentification

Votre clé de licence se trouve dans le tableau de bord, sous Capium Browser. Vous pouvez l’y afficher, la copier ou la réémettre. Gardez-la secrète et chargez-la depuis l’environnement plutôt que de la coder en dur.

auth.py
# Keep the key out of source. Export it in your shell or CI:
#   export CAPIUM_LICENSE_KEY="CAPIUM-XXXX-XXXX-XXXX-XXXX"
# The SDK reads it from the environment (or ~/.capium/license)
# automatically — nothing to pass in code.
from capiumbrowser import launch_context

browser, ctx, page = launch_context(seed=200123)
  • Réémettez la clé depuis le tableau de bord si elle est un jour exposée. L’ancienne clé cesse immédiatement de fonctionner.
  • Une licence active par compte. Les paliers supérieurs augmentent le nombre de sessions simultanées.
  • La clé autorise le binaire ; aucune connexion ni aucun cookie séparé n’est nécessaire.

3. Piloter avec Playwright (Python)

Tout ce que vous connaissez de Playwright fonctionne : locators, attentes, interception réseau, et plus encore. Capium se contente de remplacer le cœur par un vrai Chrome renforcé.

playwright.py
from capiumbrowser import launch_context

browser, ctx, page = launch_context(seed=200123, humanize=True)

page.goto("https://example.com/login")
page.fill("#email", "[email protected]")
page.fill("#password", "hunter2")
page.click("button[type=submit]")
page.wait_for_url("**/dashboard")

# The Playwright API you already know: locators, waits, network, etc.
print(page.locator("h1").inner_text())
browser.close()

4. API asynchrone

L’API asynchrone reprend l’API synchrone : launch_context_async renvoie le même trio (browser, context, page) avec des méthodes Playwright awaitables.

async_run.py
import asyncio
from capiumbrowser import launch_context_async

async def main():
    browser, ctx, page = await launch_context_async(
        seed=200123, humanize=True, url="https://example.com",
    )
    print(await page.title())
    await browser.close()

asyncio.run(main())

5. Mode Humanize

Passer humanize=True au lancement ajoute des saisies et une temporisation humaines : mouvements de souris naturels, cadence de frappe réaliste et petites pauses variables, ainsi que les helpers page.human_type et page.human_scroll. Laissez-le activé pour les parcours interactifs ; désactivez-le pour du simple fetch-and-parse où la vitesse compte.

humanize.py
browser, ctx, page = launch_context(seed=200123, humanize=True)

page.human_type("#email", "[email protected]")   # natural typing cadence
page.human_scroll(1200)                          # smooth, variable scrolling

6. Sessions et concurrence

Chaque navigateur actif correspond à une session. La limite de sessions de votre forfait indique combien vous pouvez en exécuter en même temps. Fermez un navigateur une fois terminé pour libérer la session.

concurrent.py
import concurrent.futures
from capiumbrowser import launch_context

def fetch(url, seed):
    browser, ctx, page = launch_context(seed=seed, url=url)
    title = page.title()
    browser.close()
    return title

# Each live browser counts as one session against your plan's cap.
urls = ["https://a.example", "https://b.example", "https://c.example"]
seeds = range(200001, 200001 + len(urls))   # one coherent device per worker
with concurrent.futures.ThreadPoolExecutor(max_workers=3) as pool:
    print(list(pool.map(fetch, urls, seeds)))

7. Recettes : captures d’écran et PDF

capture.py
page.goto("https://example.com")

# Full-page screenshot
page.screenshot(path="shot.png", full_page=True)

# Render the page to a PDF
page.pdf(path="page.pdf", format="A4")

8. Plateformes et CI

Des binaires natifs sont fournis pour Linux, Windows et macOS, avec un comportement identique sur votre ordinateur portable, un runner CI et votre flotte. En CI, définissez la clé de licence comme variable d’environnement secrète :

ci.yml
# GitHub Actions / GitLab CI
env:
  CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}

9. Dépannage

Licence invalide ou expirée

Vérifiez que la clé correspond à celle du tableau de bord et que votre licence (ou votre essai) est toujours active. Réémettez la clé si nécessaire.

Limite de sessions atteinte

Vous avez autant de navigateurs actifs que votre forfait le permet. Fermez les navigateurs terminés, ou passez à un forfait supérieur pour une limite de sessions plus élevée.

Le binaire ne se télécharge pas

Le binaire est récupéré au premier lancement ; autorisez le HTTPS sortant. Dans une CI verrouillée, mettez la boîte à outils en cache entre les exécutions.

10. FAQ

Où se trouve ma clé de licence ?›

Dans le tableau de bord, sous Capium Browser. Vous pouvez l’y afficher, la copier ou la réémettre. Gardez-la secrète : traitez-la comme un mot de passe.

Dois-je télécharger quelque chose manuellement ?›

Non. La boîte à outils récupère le dernier binaire renforcé pour votre OS au premier lancement et le maintient à jour automatiquement.

Quels langages et drivers sont pris en charge ?›

Python est la référence, piloté avec l’API Playwright standard que vous utilisez déjà. Un paquet JavaScript/TypeScript s’installe sous le nom capiumbrowser sur npm.

Qu’est-ce qui compte comme une session ?›

Une instance de navigateur active. La limite de sessions de votre forfait correspond au nombre que vous pouvez exécuter simultanément, pas à un total mensuel.

L’essai gratuit expire-t-il ?›

Oui. L’essai vous donne une session de navigateur pendant 30 jours, puis il prend fin. Passez à un forfait supérieur à tout moment pour plus de sessions et de support.

Prêt à commencer ?

Récupérez votre clé de licence et pilotez votre première session furtive en quelques minutes.

Ouvrir le tableau de bord