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.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserWstaw klucz licencyjny i otwórz pierwszą stronę. Włącz humanize=True, aby uzyskać ludzki sposób wprowadzania i tempo.
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.
# 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.
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.
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ść.
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. 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ę.
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
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ą:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Rozwiązywanie problemów
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.
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 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.