Installeren, authenticeren en besturen.
Capium Browser is onze eigen stealth-Chrome, gelicentieerd per sessie en geïnstalleerd met één commando. Voeg je licentiesleutel toe en bestuur hem lokaal met de Playwright-API die je al kent.
Bestuur hem zoals Playwright
Navigeer, klik, typ, wacht op selectors en netwerk. De standaard Playwright-API werkt ongewijzigd.
Echte stealth-Chrome
Een echte, altijd up-to-date Chrome-kern, gehard tegen botdetectie, geen headless stub of gepatchte wrapper.
Screenshots en pdf's
Maak screenshots van volledige pagina's of render elke pagina naar pdf, precies zoals met een lokale browser.
Gelijktijdige sessies
Draai meerdere browsers tegelijk. Elke live browser telt als één sessie binnen het maximum van je abonnement.
1. Aan de slag
Installeer de toolkit voor je taal. Niets zelf te hosten en niets te patchen. De stealthbinary wordt bij de eerste run opgehaald en automatisch up-to-date gehouden.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserVoeg je licentiesleutel toe en bestuur je eerste pagina. Zet humanize=True aan voor menselijke invoer en timing.
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. Authenticatie
Je licentiesleutel staat in het dashboard onder Capium Browser. Daar kun je hem tonen, kopiëren of opnieuw uitgeven. Houd hem geheim en laad hem uit de omgeving in plaats van hem hard te coderen.
# 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)- Geef de sleutel opnieuw uit via het dashboard als hij ooit uitlekt. De oude sleutel werkt dan direct niet meer.
- Eén actieve licentie per account. Hogere niveaus verhogen het aantal sessies dat tegelijk draait.
- De sleutel autoriseert de binary; er is geen aparte login of cookie nodig.
3. Besturen met Playwright (Python)
Alles wat je van Playwright kent werkt: locators, waits, netwerkinterceptie en meer. Capium wisselt alleen een geharde, echte Chrome-kern in.
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. Async-API
De async-API spiegelt de sync-API: launch_context_async geeft hetzelfde trio (browser, context, page) terug met awaitable Playwright-methoden.
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. Humanize-modus
Met humanize=True bij het starten voeg je menselijke invoer en timing toe: natuurlijke muisbewegingen, een realistisch typritme en kleine variabele pauzes, plus de helpers page.human_type en page.human_scroll. Laat het aan voor interactieve flows; zet het uit voor puur ophalen en parsen waar snelheid telt.
browser, ctx, page = launch_context(seed=200123, humanize=True)
page.human_type("#email", "[email protected]") # natural typing cadence
page.human_scroll(1200) # smooth, variable scrolling6. Sessies en gelijktijdigheid
Elke live browser is één sessie. Het sessiemaximum van je abonnement bepaalt hoeveel je er tegelijk kunt draaien. Sluit een browser als je klaar bent om de sessie vrij te geven.
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. Recepten: screenshots en pdf's
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. Platforms en CI
Er zijn native binaries voor Linux, Windows en macOS, met identiek gedrag op je laptop, een CI-runner en je vloot. Stel in CI de licentiesleutel in als geheime omgevingsvariabele:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Probleemoplossing
Controleer of de sleutel overeenkomt met het dashboard en of je licentie (of proefperiode) nog actief is. Geef de sleutel zo nodig opnieuw uit.
Je hebt zoveel live browsers als je abonnement toestaat. Sluit afgeronde browsers, of upgrade voor een hoger sessiemaximum.
De binary wordt bij de eerste run opgehaald; sta uitgaand HTTPS toe. Cache de toolkit tussen runs in een afgeschermde CI.
10. Veelgestelde vragen
Waar vind ik mijn licentiesleutel?›
In het dashboard onder Capium Browser. Daar kun je hem tonen, kopiëren of opnieuw uitgeven. Houd hem geheim; behandel hem als een wachtwoord.
Moet ik iets handmatig downloaden?›
Nee. De toolkit haalt bij de eerste run de nieuwste geharde binary voor je besturingssysteem op en houdt die automatisch up-to-date.
Welke talen en drivers worden ondersteund?›
Python is de standaard, bestuurd met de standaard Playwright-API die je al gebruikt. Een JavaScript/TypeScript-pakket installeer je als capiumbrowser via npm.
Wat telt als een sessie?›
Eén live browserinstantie. Het sessiemaximum van je abonnement is het aantal dat je tegelijk kunt draaien, geen maandtotaal.
Verloopt de gratis proefperiode?›
Ja. De proefperiode geeft je 30 dagen lang één browsersessie, daarna stopt hij. Upgrade wanneer je wilt voor meer sessies en support.
Klaar om te beginnen?
Haal je licentiesleutel op en bestuur binnen enkele minuten je eerste stealthsessie.