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.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserInserisci la tua chiave di licenza e pilota la tua prima pagina. Attiva humanize=True per input e tempi simili a quelli umani.
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.
# 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.
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.
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à.
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. 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.
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
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:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Risoluzione dei problemi
Verifica che la chiave corrisponda a quella nella dashboard e che la tua licenza (o prova) sia ancora attiva. Se necessario, riemetti la chiave.
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 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.