Przejdź do treści
Jak korzystać z Capium Browser

Zainstaluj, uwierzytelnij i steruj.

Capium Browser to nasz autorski Chrome stealth, licencjonowany za sesję i instalowany jednym poleceniem. Wstaw klucz licencyjny i steruj nim lokalnie za pomocą znanego Ci API Playwright.

Steruj nią jak Playwright

Nawiguj, klikaj, pisz, czekaj na selektory i sieć. Standardowe API Playwright działa bez zmian.

Prawdziwy Chrome stealth

Prawdziwy, zawsze najnowszy rdzeń Chrome zabezpieczony przed wykrywaniem botów, a nie atrapa headless czy łatana nakładka.

Zrzuty ekranu i PDF

Rób zrzuty całych stron lub renderuj dowolną stronę do PDF, dokładnie tak jak w lokalnej przeglądarce.

Sesje równoległe

Uruchamiaj kilka przeglądarek jednocześnie. Każda aktywna przeglądarka liczy się jako jedna sesja w limicie Twojego planu.

1. Pierwsze kroki

Zainstaluj zestaw narzędzi dla swojego języka. Nie ma nic do hostowania ani łatania. Binarka stealth jest pobierana przy pierwszym uruchomieniu i automatycznie aktualizowana.

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

# JavaScript / TypeScript
npm install capiumbrowser

Wstaw klucz licencyjny i otwórz pierwszą stronę. Włącz humanize=True, aby uzyskać ludzki sposób wprowadzania i tempo.

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

Twój klucz licencyjny znajduje się w panelu w sekcji Capium Browser. Możesz go tam odsłonić, skopiować lub wygenerować ponownie. Zachowaj go w tajemnicy i wczytuj ze zmiennej środowiskowej zamiast wpisywać na sztywno w kodzie.

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)
  • Jeśli klucz kiedykolwiek wycieknie, wygeneruj go ponownie w panelu. Stary klucz natychmiast przestaje działać.
  • Jedna aktywna licencja na konto. Wyższe pakiety zwiększają liczbę sesji działających jednocześnie.
  • Klucz autoryzuje binarkę, nie potrzeba osobnego logowania ani pliku cookie.

3. Sterowanie przez Playwright (Python)

Działa wszystko, co znasz z Playwright: lokatory, oczekiwanie, przechwytywanie sieci i więcej. Capium po prostu podmienia rdzeń na wzmocniony, prawdziwy Chrome.

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

Async API odzwierciedla wersję synchroniczną: launch_context_async zwraca tę samą trójkę (browser, context, page) z asynchronicznymi metodami Playwright.

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. Tryb humanize

Przekazanie humanize=True przy uruchomieniu dodaje ludzki sposób wprowadzania i tempo: naturalny ruch myszy, realistyczny rytm pisania i drobne, zmienne pauzy, a także pomocnicze metody page.human_type i page.human_scroll. Zostaw go włączonego w interaktywnych procesach, wyłącz przy czystym pobieraniu i parsowaniu, gdzie liczy się szybkość.

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. Sesje i współbieżność

Każda aktywna przeglądarka to jedna sesja. Limit sesji w Twoim planie określa, ile możesz uruchomić jednocześnie. Zamknij przeglądarkę po zakończeniu, aby zwolnić sesję.

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. Przepisy: zrzuty ekranu i 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. Platformy i CI

Natywne binarki są dostępne dla Linuksa, Windows i macOS, z identycznym działaniem na laptopie, w runnerze CI i w całej flocie. W CI ustaw klucz licencyjny jako tajną zmienną środowiskową:

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

9. Rozwiązywanie problemów

Nieprawidłowa lub wygasła licencja

Sprawdź, czy klucz zgadza się z tym w panelu i czy Twoja licencja (lub okres próbny) jest nadal aktywna. W razie potrzeby wygeneruj klucz ponownie.

Osiągnięto limit sesji

Masz tyle aktywnych przeglądarek, ile pozwala Twój plan. Zamknij zakończone przeglądarki lub przejdź na wyższy plan z większym limitem sesji.

Binarka się nie pobiera

Binarka jest pobierana przy pierwszym uruchomieniu, zezwól na wychodzący ruch HTTPS. W zablokowanym CI przechowuj zestaw narzędzi w cache między uruchomieniami.

10. FAQ

Gdzie jest mój klucz licencyjny?›

W panelu w sekcji Capium Browser. Możesz go tam odsłonić, skopiować lub wygenerować ponownie. Zachowaj go w tajemnicy i traktuj jak hasło.

Czy muszę coś pobierać ręcznie?›

Nie. Zestaw narzędzi pobiera najnowszą wzmocnioną binarkę dla Twojego systemu przy pierwszym uruchomieniu i automatycznie ją aktualizuje.

Jakie języki i sterowniki są obsługiwane?›

Podstawowy jest Python, sterowany standardowym API Playwright, którego już używasz. Pakiet JavaScript/TypeScript instaluje się jako capiumbrowser z npm.

Co liczy się jako sesja?›

Jedna aktywna instancja przeglądarki. Limit sesji w Twoim planie to liczba sesji, które możesz uruchomić jednocześnie, a nie suma miesięczna.

Czy bezpłatny okres próbny wygasa?›

Tak. Okres próbny daje jedną sesję przeglądarki na 30 dni, potem się kończy. Przejdź na wyższy plan w dowolnym momencie, aby uzyskać więcej sesji i wsparcia.

Gotowy, by zacząć?

Pobierz klucz licencyjny i uruchom pierwszą sesję stealth w kilka minut.

Otwórz panel