Kurun, kimlik doğrulayın ve yönetin.
Capium Browser, oturum başına lisanslanan ve tek bir komutla kurulan tescilli gizli Chrome'umuzdur. Lisans anahtarınızı ekleyin ve zaten bildiğiniz Playwright API'siyle yerel olarak yönetin.
Playwright gibi yönetin
Gezinin, tıklayın, yazın, seçicileri ve ağı bekleyin. Standart Playwright API'si değişmeden çalışır.
Gerçek gizli Chrome
Bot tespitine karşı güçlendirilmiş, gerçek ve her zaman en güncel bir Chrome çekirdeği; headless bir taklit ya da yamalı bir sarmalayıcı değil.
Ekran görüntüleri ve PDF'ler
Tam sayfa ekran görüntüleri alın veya herhangi bir sayfayı PDF'ye dönüştürün; tıpkı yerel bir tarayıcıda yaptığınız gibi.
Eşzamanlı oturumlar
Aynı anda birden fazla tarayıcı çalıştırın. Her canlı tarayıcı, planınızın limitine karşı bir oturum sayılır.
1. Başlarken
Diliniz için araç setini kurun. Kendi sunucunuzda barındıracak ya da yamalayacak hiçbir şey yok. Gizli binary ilk çalıştırmada indirilir ve otomatik olarak güncel tutulur.
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserLisans anahtarınızı ekleyin ve ilk sayfanızı yönetin. İnsan benzeri girdi ve zamanlama için humanize=True özelliğini açın.
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. Kimlik doğrulama
Lisans anahtarınız panelde Capium Browser altında bulunur. Orada görüntüleyin, kopyalayın veya yeniden oluşturun. Gizli tutun ve koda gömmek yerine ortam değişkeninden yükleyin.
# 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)- Anahtar açığa çıkarsa panelden yeniden oluşturun. Eski anahtar hemen çalışmayı durdurur.
- Hesap başına bir canlı lisans. Üst kademeler aynı anda çalışan oturum sayısını artırır.
- Anahtar binary'yi yetkilendirir; ayrı bir giriş veya çerez gerekmez.
3. Playwright ile yönetim (Python)
Playwright'tan bildiğiniz her şey çalışır: locator'lar, beklemeler, ağ yakalama ve daha fazlası. Capium yalnızca güçlendirilmiş, gerçek bir Chrome çekirdeğini devreye alır.
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, senkron olanın aynısıdır: launch_context_async, await edilebilir Playwright metotlarıyla aynı (browser, context, page) üçlüsünü döndürür.
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. Humanize modu
Başlatırken humanize=True geçmek insan benzeri girdi ve zamanlama ekler: doğal fare hareketi, gerçekçi yazma temposu ve küçük değişken duraklamalar, ayrıca page.human_type ve page.human_scroll yardımcıları. Etkileşimli akışlarda açık bırakın; hızın önemli olduğu salt indir-ve-ayrıştır işlerinde kapatın.
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. Oturumlar ve eşzamanlılık
Her canlı tarayıcı bir oturumdur. Planınızın oturum limiti, aynı anda kaç tane çalıştırabileceğinizdir. Oturumu serbest bırakmak için işiniz bittiğinde tarayıcıyı kapatın.
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. Tarifler: ekran görüntüleri ve PDF'ler
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. Platformlar ve CI
Linux, Windows ve macOS için yerel binary'ler sunulur; dizüstü bilgisayarınızda, bir CI çalıştırıcısında ve filonuzda aynı şekilde davranır. CI'da lisans anahtarını gizli bir ortam değişkeni olarak ayarlayın:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. Sorun giderme
Anahtarın paneldekiyle eşleştiğini ve lisansınızın (veya denemenizin) hâlâ aktif olduğunu doğrulayın. Gerekirse anahtarı yeniden oluşturun.
Planınızın izin verdiği kadar canlı tarayıcınız var. Biten tarayıcıları kapatın veya daha yüksek bir oturum limiti için yükseltin.
Binary ilk çalıştırmada indirilir; giden HTTPS trafiğine izin verin. Kısıtlı CI ortamlarında araç setini çalıştırmalar arasında önbelleğe alın.
10. SSS
Lisans anahtarım nerede?›
Panelde Capium Browser altında. Orada görüntüleyin, kopyalayın veya yeniden oluşturun. Gizli tutun; bir şifre gibi davranın.
Manuel olarak bir şey indirmem gerekiyor mu?›
Hayır. Araç seti ilk çalıştırmada işletim sisteminiz için en güncel güçlendirilmiş binary'yi indirir ve otomatik olarak güncel tutar.
Hangi diller ve sürücüler destekleniyor?›
Python ana dildir ve zaten kullandığınız standart Playwright API'siyle yönetilir. JavaScript/TypeScript paketi npm üzerinde capiumbrowser olarak kurulur.
Oturum olarak ne sayılır?›
Tek bir canlı tarayıcı örneği. Planınızın oturum limiti, aylık toplam değil, aynı anda çalıştırabileceğiniz sayıdır.
Ücretsiz denemenin süresi doluyor mu?›
Evet. Deneme size 30 gün boyunca tek bir tarayıcı oturumu verir, ardından sona erer. Daha fazla oturum ve destek için istediğiniz zaman yükseltin.
Başlamaya hazır mısınız?
Lisans anahtarınızı alın ve ilk gizli oturumunuzu dakikalar içinde yönetin.