Zum Inhalt springen
So nutzt du Capium Browser

Installieren, authentifizieren, steuern.

Capium Browser ist unser eigenes Stealth-Chrome, lizenziert pro Sitzung und mit einem einzigen Befehl installiert. Trage deinen Lizenzschlüssel ein und steuere ihn lokal mit der Playwright-API, die du bereits kennst.

Steuere ihn wie Playwright

Navigieren, klicken, tippen, auf Selektoren und Netzwerk warten. Die Standard-Playwright-API funktioniert unverändert.

Echtes Stealth-Chrome

Ein echter, stets aktueller Chrome-Kern, gehärtet gegen Bot-Erkennung, kein Headless-Stub oder gepatchter Wrapper.

Screenshots & PDFs

Erstelle ganzseitige Screenshots oder rendere jede Seite als PDF, genau wie mit einem lokalen Browser.

Gleichzeitige Sitzungen

Führe mehrere Browser gleichzeitig aus. Jeder aktive Browser zählt als eine Sitzung gegen das Limit deines Plans.

1. Erste Schritte

Installiere das Toolkit für deine Sprache. Nichts selbst zu hosten, nichts zu patchen. Die Stealth-Binary wird beim ersten Start geladen und automatisch aktuell gehalten.

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

# JavaScript / TypeScript
npm install capiumbrowser

Trage deinen Lizenzschlüssel ein und steuere deine erste Seite. Aktiviere humanize=True für menschenähnliche Eingaben und Timing.

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. Authentifizierung

Dein Lizenzschlüssel liegt im Dashboard unter Capium Browser. Dort kannst du ihn anzeigen, kopieren oder neu ausstellen. Halte ihn geheim und lade ihn aus der Umgebung, statt ihn fest einzuprogrammieren.

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)
  • Stelle den Schlüssel im Dashboard neu aus, falls er jemals offengelegt wird. Der alte Schlüssel funktioniert sofort nicht mehr.
  • Eine aktive Lizenz pro Konto. Höhere Stufen erhöhen die Anzahl gleichzeitig laufender Sitzungen.
  • Der Schlüssel autorisiert die Binary; kein separater Login und kein Cookie erforderlich.

3. Steuern mit Playwright (Python)

Alles, was du von Playwright kennst, funktioniert: Locators, Waits, Netzwerk-Interception und mehr. Capium tauscht lediglich einen gehärteten, echten Chrome-Kern ein.

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. Async-API

Die Async-API spiegelt die synchrone: launch_context_async gibt dasselbe Trio (browser, context, page) mit awaitbaren Playwright-Methoden zurück.

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. Humanize-Modus

Mit humanize=True beim Start kommen menschenähnliche Eingaben und Timing hinzu: natürliche Mausbewegungen, realistischer Tipprhythmus und kleine variable Pausen, dazu die Helfer page.human_type und page.human_scroll. Lass ihn bei interaktiven Abläufen an; schalte ihn bei reinem Fetch-and-Parse aus, wenn Geschwindigkeit zählt.

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. Sitzungen & Parallelität

Jeder aktive Browser ist eine Sitzung. Das Sitzungslimit deines Plans gibt an, wie viele du gleichzeitig ausführen kannst. Schließe einen Browser, wenn du fertig bist, um die Sitzung freizugeben.

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. Rezepte: Screenshots & PDFs

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. Plattformen & CI

Native Binaries gibt es für Linux, Windows und macOS, mit identischem Verhalten auf deinem Laptop, einem CI-Runner und deiner Flotte. Setze den Lizenzschlüssel in CI als geheime Umgebungsvariable:

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

9. Fehlerbehebung

Ungültige oder abgelaufene Lizenz

Prüfe, ob der Schlüssel mit dem Dashboard übereinstimmt und deine Lizenz (oder Testphase) noch aktiv ist. Stelle den Schlüssel bei Bedarf neu aus.

Sitzungslimit erreicht

Du hast so viele aktive Browser, wie dein Plan erlaubt. Schließe fertige Browser oder upgrade für ein höheres Sitzungslimit.

Binary wird nicht heruntergeladen

Die Binary wird beim ersten Start geladen; erlaube ausgehendes HTTPS. In abgeschotteten CI-Umgebungen cache das Toolkit zwischen den Läufen.

10. FAQ

Wo finde ich meinen Lizenzschlüssel?›

Im Dashboard unter Capium Browser. Dort kannst du ihn anzeigen, kopieren oder neu ausstellen. Halte ihn geheim und behandle ihn wie ein Passwort.

Muss ich etwas manuell herunterladen?›

Nein. Das Toolkit lädt beim ersten Start die neueste gehärtete Binary für dein Betriebssystem und hält sie automatisch aktuell.

Welche Sprachen und Treiber werden unterstützt?›

Python ist die Referenz, gesteuert mit der Standard-Playwright-API, die du bereits nutzt. Ein JavaScript/TypeScript-Paket wird als capiumbrowser über npm installiert.

Was zählt als Sitzung?›

Eine aktive Browser-Instanz. Das Sitzungslimit deines Plans ist die Anzahl, die du gleichzeitig ausführen kannst, keine monatliche Summe.

Läuft die kostenlose Testphase ab?›

Ja. Die Testphase gibt dir eine Browser-Sitzung für 30 Tage, danach endet sie. Du kannst jederzeit upgraden, um mehr Sitzungen und Support zu erhalten.

Bereit loszulegen?

Hol dir deinen Lizenzschlüssel und steuere deine erste Stealth-Sitzung in wenigen Minuten.

Dashboard öffnen