Vai al contenuto
Come usare Capium Browser

Installalo, autenticati e pilotalo.

Capium Browser è il nostro Chrome stealth proprietario, con licenza per sessione e installabile con un solo comando. Inserisci la tua chiave di licenza e pilotalo in locale con l'API di Playwright che già conosci.

Pilotalo come Playwright

Naviga, clicca, digita, attendi selettori e rete. L'API standard di Playwright funziona senza modifiche.

Vero Chrome stealth

Un core Chrome autentico e sempre aggiornato, protetto contro il rilevamento dei bot, non uno stub headless o un wrapper modificato.

Screenshot e PDF

Cattura screenshot dell'intera pagina o esporta qualsiasi pagina in PDF, esattamente come faresti con un browser locale.

Sessioni simultanee

Esegui più browser contemporaneamente. Ogni browser attivo conta come una sessione rispetto al limite del tuo piano.

1. Primi passi

Installa il toolkit per il tuo linguaggio. Niente da ospitare in proprio e niente da modificare. Il binario stealth viene scaricato al primo avvio e mantenuto aggiornato automaticamente.

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

# JavaScript / TypeScript
npm install capiumbrowser

Inserisci la tua chiave di licenza e pilota la tua prima pagina. Attiva humanize=True per input e tempi simili a quelli umani.

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

La tua chiave di licenza si trova nella dashboard, sotto Capium Browser. Lì puoi visualizzarla, copiarla o riemetterla. Tienila segreta e caricala dall'ambiente invece di scriverla nel codice.

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)
  • Riemetti la chiave dalla dashboard se viene esposta. La vecchia chiave smette di funzionare immediatamente.
  • Una licenza attiva per account. I livelli superiori aumentano il numero di sessioni eseguibili contemporaneamente.
  • La chiave autorizza il binario; non servono login o cookie separati.

3. Pilotarlo con Playwright (Python)

Tutto ciò che conosci di Playwright funziona: locator, attese, intercettazione di rete e altro. Capium sostituisce soltanto il core con un vero Chrome protetto.

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 asincrona

L'API asincrona rispecchia quella sincrona: launch_context_async restituisce la stessa terna (browser, context, page) con metodi Playwright awaitable.

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. Modalità humanize

Passando humanize=True all'avvio si aggiungono input e tempi simili a quelli umani: movimenti del mouse naturali, cadenza di digitazione realistica e brevi pause variabili, oltre agli helper page.human_type e page.human_scroll. Lasciala attiva per i flussi interattivi; disattivala per il puro fetch-and-parse quando conta la velocità.

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. Sessioni e concorrenza

Ogni browser attivo è una sessione. Il limite di sessioni del tuo piano indica quante puoi eseguirne contemporaneamente. Chiudi un browser quando hai finito per liberare la sessione.

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. Ricette: screenshot e 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. Piattaforme e CI

I binari nativi sono disponibili per Linux, Windows e macOS, con un comportamento identico sul tuo laptop, su un runner CI e sulla tua flotta. In CI, imposta la chiave di licenza come variabile d'ambiente segreta:

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

9. Risoluzione dei problemi

Licenza non valida o scaduta

Verifica che la chiave corrisponda a quella nella dashboard e che la tua licenza (o prova) sia ancora attiva. Se necessario, riemetti la chiave.

Limite di sessioni raggiunto

Hai tanti browser attivi quanti ne consente il tuo piano. Chiudi i browser che hai finito di usare o passa a un piano con un limite di sessioni più alto.

Il binario non viene scaricato

Il binario viene scaricato al primo avvio; consenti l'HTTPS in uscita. In ambienti CI con restrizioni, metti in cache il toolkit tra un'esecuzione e l'altra.

10. FAQ

Dov'è la mia chiave di licenza?›

Nella dashboard, sotto Capium Browser. Lì puoi visualizzarla, copiarla o riemetterla. Tienila segreta; trattala come una password.

Devo scaricare qualcosa manualmente?›

No. Il toolkit scarica al primo avvio l'ultimo binario protetto per il tuo OS e lo mantiene aggiornato automaticamente.

Quali linguaggi e driver sono supportati?›

Python è il linguaggio di riferimento, pilotato con l'API standard di Playwright che usi già. Un pacchetto JavaScript/TypeScript si installa come capiumbrowser su npm.

Cosa conta come sessione?›

Un'istanza di browser attiva. Il limite di sessioni del tuo piano è il numero che puoi eseguire contemporaneamente, non un totale mensile.

La prova gratuita scade?›

Sì. La prova ti offre una sessione browser per 30 giorni, poi termina. Puoi passare a un piano superiore in qualsiasi momento per avere più sessioni e supporto.

Pronto per iniziare?

Prendi la tua chiave di licenza e avvia la tua prima sessione stealth in pochi minuti.

Apri la dashboard