Instal, autentikasi, dan kendalikan.
Capium Browser adalah Chrome stealth milik kami, dilisensikan per sesi dan diinstal dengan satu perintah. Masukkan license key Anda dan kendalikan secara lokal dengan API Playwright yang sudah Anda kenal.
Kendalikan seperti Playwright
Navigasi, klik, ketik, tunggu selector dan jaringan. API Playwright standar berfungsi tanpa perubahan.
Chrome stealth sungguhan
Inti Chrome asli yang selalu versi terbaru dan diperkuat terhadap deteksi bot, bukan stub headless atau wrapper yang di-patch.
Screenshot & PDF
Ambil screenshot satu halaman penuh atau render halaman apa pun ke PDF, persis seperti dengan browser lokal.
Sesi bersamaan
Jalankan beberapa browser sekaligus. Setiap browser aktif dihitung sebagai satu sesi terhadap batas paket Anda.
1. Memulai
Instal toolkit untuk bahasa Anda. Tidak ada yang perlu di-host sendiri dan tidak ada yang perlu di-patch. Binary stealth diambil saat pertama kali dijalankan dan diperbarui secara otomatis.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserMasukkan license key Anda dan kendalikan halaman pertama Anda. Aktifkan humanize=True untuk input dan timing seperti manusia.
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. Autentikasi
License key Anda ada di dasbor pada bagian Capium Browser. Tampilkan, salin, atau terbitkan ulang di sana. Rahasiakan dan muat dari environment alih-alih menuliskannya langsung di kode.
# 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)- Terbitkan ulang key dari dasbor jika pernah terekspos. Key lama langsung tidak berfungsi.
- Satu lisensi aktif per akun. Tier yang lebih tinggi menambah jumlah sesi yang dapat berjalan bersamaan.
- Key mengotorisasi binary; tidak perlu login atau cookie terpisah.
3. Mengendalikan dengan Playwright (Python)
Semua yang Anda ketahui dari Playwright berfungsi: locator, wait, intersepsi jaringan, dan lainnya. Capium hanya mengganti intinya dengan Chrome sungguhan yang sudah diperkuat.
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 Async
API async mencerminkan API sync: launch_context_async mengembalikan trio yang sama (browser, context, page) dengan metode Playwright yang dapat di-await.
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. Mode Humanize
Meneruskan humanize=True saat launch menambahkan input dan timing seperti manusia: gerakan mouse alami, ritme mengetik yang realistis, dan jeda kecil yang bervariasi, ditambah helper page.human_type dan page.human_scroll. Biarkan aktif untuk alur interaktif; nonaktifkan untuk fetch-and-parse murni ketika kecepatan penting.
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. Sesi & konkurensi
Setiap browser aktif adalah satu sesi. Batas sesi paket Anda adalah jumlah yang dapat Anda jalankan secara bersamaan. Tutup browser setelah selesai untuk membebaskan sesi.
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. Resep: screenshot & 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. Platform & CI
Binary native tersedia untuk Linux, Windows, dan macOS, dengan perilaku identik di laptop Anda, runner CI, dan fleet Anda. Di CI, atur license key sebagai environment variable rahasia:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Pemecahan masalah
Pastikan key sesuai dengan yang ada di dasbor dan lisensi (atau uji coba) Anda masih aktif. Terbitkan ulang key jika perlu.
Jumlah browser aktif Anda sudah mencapai batas paket. Tutup browser yang sudah selesai, atau upgrade untuk batas sesi yang lebih tinggi.
Binary diambil saat pertama kali dijalankan; izinkan HTTPS keluar. Di CI yang dikunci ketat, cache toolkit di antara run.
10. FAQ
Di mana license key saya?›
Di dasbor pada bagian Capium Browser. Tampilkan, salin, atau terbitkan ulang di sana. Rahasiakan; perlakukan seperti kata sandi.
Apakah saya perlu mengunduh sesuatu secara manual?›
Tidak. Toolkit mengambil binary terbaru yang diperkuat untuk OS Anda saat pertama kali dijalankan dan memperbaruinya secara otomatis.
Bahasa dan driver apa saja yang didukung?›
Python adalah yang utama, dikendalikan dengan API Playwright standar yang sudah Anda gunakan. Paket JavaScript/TypeScript diinstal sebagai capiumbrowser di npm.
Apa yang dihitung sebagai sesi?›
Satu instance browser aktif. Batas sesi paket Anda adalah jumlah yang dapat dijalankan bersamaan, bukan total bulanan.
Apakah uji coba gratis bisa kedaluwarsa?›
Ya. Uji coba memberi Anda satu sesi browser selama 30 hari, lalu berakhir. Upgrade kapan saja untuk lebih banyak sesi dan dukungan.
Siap memulai?
Ambil license key Anda dan jalankan sesi stealth pertama Anda dalam hitungan menit.