インストールして、認証して、操作する。
Capium Browserは独自開発のステルスChromeで、セッション単位でライセンスされ、1つのコマンドでインストールできます。ライセンスキーを設定すれば、使い慣れたPlaywright APIでローカルから操作できます。
Playwrightと同じように操作
ページ遷移、クリック、入力、セレクターやネットワークの待機。標準のPlaywright APIがそのまま使えます。
本物のステルスChrome
ボット検出に対して強化された、常に最新の本物のChromeコア。ヘッドレスのスタブやパッチを当てたラッパーではありません。
スクリーンショットとPDF
ローカルブラウザと同じように、ページ全体のスクリーンショットを撮ったり、任意のページをPDFに出力したりできます。
同時実行セッション
複数のブラウザを同時に実行できます。稼働中のブラウザ1つにつき、プランの上限に対して1セッションとカウントされます。
1. はじめに
お使いの言語向けのツールキットをインストールします。セルフホストもパッチ適用も不要です。ステルスバイナリは初回実行時に取得され、自動で最新の状態に保たれます。
# Python
pip install capiumbrowser
python -m playwright install-deps # Chromium's OS libraries (once)
# JavaScript / TypeScript
npm install capiumbrowserライセンスキーを設定して、最初のページを操作してみましょう。humanize=True を有効にすると、人間らしい入力とタイミングになります。
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. 認証
ライセンスキーはダッシュボードのCapium Browserにあります。そこでキーの表示、コピー、再発行ができます。キーは秘密にし、コードに直接書き込まず環境変数から読み込んでください。
# 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)- キーが漏えいした場合は、ダッシュボードから再発行してください。古いキーはすぐに使えなくなります。
- 有効なライセンスは1アカウントにつき1つです。上位プランほど同時に実行できるセッション数が増えます。
- キーがバイナリを認証するため、別途ログインやCookieは不要です。
3. Playwrightで操作する(Python)
ロケーター、待機、ネットワークの傍受など、Playwrightで使い慣れた機能はすべてそのまま動作します。Capiumは、強化された本物の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. 非同期API
非同期APIは同期APIと同じ構成です。launch_context_async は、await可能なPlaywrightメソッドを備えた同じ(browser、context、page)の3つ組を返します。
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モード
起動時に humanize=True を渡すと、人間らしい入力とタイミングが加わります。自然なマウスの動き、リアルなタイピングのリズム、小さな不規則な間に加え、page.human_type と page.human_scroll のヘルパーも使えます。インタラクティブなフローではオンのままにし、速度が重要な単純な取得と解析ではオフにしてください。
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. セッションと同時実行数
稼働中のブラウザ1つが1セッションです。プランのセッション上限は、同時に実行できる数です。使い終わったブラウザを閉じると、セッションが解放されます。
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. レシピ:スクリーンショットと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. プラットフォームとCI
Linux、Windows、macOS向けのネイティブバイナリが提供され、ノートPC、CIランナー、フリートのいずれでも同じように動作します。CIでは、ライセンスキーをシークレットの環境変数として設定してください:
# GitHub Actions / GitLab CI
env:
CAPIUM_LICENSE_KEY: ${{ secrets.CAPIUM_LICENSE_KEY }}9. トラブルシューティング
キーがダッシュボードの表示と一致していること、ライセンス(またはトライアル)がまだ有効であることを確認してください。必要に応じてキーを再発行してください。
プランで許可されている数のブラウザが稼働中です。終了したブラウザを閉じるか、アップグレードしてセッション上限を引き上げてください。
バイナリは初回実行時に取得されるため、外向きのHTTPS通信を許可してください。制限の厳しいCI環境では、実行間でツールキットをキャッシュしてください。
10. よくある質問
ライセンスキーはどこにありますか?›
ダッシュボードの「Capium Browser」にあります。そこでキーの表示、コピー、再発行ができます。パスワードと同様に、秘密にしてください。
手動で何かをダウンロードする必要はありますか?›
いいえ。ツールキットが初回実行時にOSに合った最新の強化バイナリを取得し、自動で最新の状態に保ちます。
どの言語とドライバーに対応していますか?›
Pythonが標準で、使い慣れた標準のPlaywright APIで操作します。JavaScript/TypeScriptのパッケージは、npmの capiumbrowser としてインストールできます。
セッションとは何ですか?›
稼働中のブラウザインスタンス1つです。プランのセッション上限は同時に実行できる数であり、月間の合計ではありません。
無料トライアルに期限はありますか?›
はい。トライアルでは30日間、1つのブラウザセッションをご利用いただけ、その後終了します。より多くのセッションやサポートが必要な場合は、いつでもアップグレードできます。
始める準備はできましたか?
ライセンスキーを取得して、数分で最初のステルスセッションを動かしましょう。