コンテンツへスキップ
Capium Browserの使い方

インストールして、認証して、操作する。

Capium Browserは独自開発のステルスChromeで、セッション単位でライセンスされ、1つのコマンドでインストールできます。ライセンスキーを設定すれば、使い慣れたPlaywright APIでローカルから操作できます。

Playwrightと同じように操作

ページ遷移、クリック、入力、セレクターやネットワークの待機。標準のPlaywright APIがそのまま使えます。

本物のステルスChrome

ボット検出に対して強化された、常に最新の本物のChromeコア。ヘッドレスのスタブやパッチを当てたラッパーではありません。

スクリーンショットとPDF

ローカルブラウザと同じように、ページ全体のスクリーンショットを撮ったり、任意のページをPDFに出力したりできます。

同時実行セッション

複数のブラウザを同時に実行できます。稼働中のブラウザ1つにつき、プランの上限に対して1セッションとカウントされます。

1. はじめに

お使いの言語向けのツールキットをインストールします。セルフホストもパッチ適用も不要です。ステルスバイナリは初回実行時に取得され、自動で最新の状態に保たれます。

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

# JavaScript / TypeScript
npm install capiumbrowser

ライセンスキーを設定して、最初のページを操作してみましょう。humanize=True を有効にすると、人間らしい入力とタイミングになります。

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. 認証

ライセンスキーはダッシュボードのCapium Browserにあります。そこでキーの表示、コピー、再発行ができます。キーは秘密にし、コードに直接書き込まず環境変数から読み込んでください。

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)
  • キーが漏えいした場合は、ダッシュボードから再発行してください。古いキーはすぐに使えなくなります。
  • 有効なライセンスは1アカウントにつき1つです。上位プランほど同時に実行できるセッション数が増えます。
  • キーがバイナリを認証するため、別途ログインやCookieは不要です。

3. Playwrightで操作する(Python)

ロケーター、待機、ネットワークの傍受など、Playwrightで使い慣れた機能はすべてそのまま動作します。Capiumは、強化された本物の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. 非同期API

非同期APIは同期APIと同じ構成です。launch_context_async は、await可能なPlaywrightメソッドを備えた同じ(browser、context、page)の3つ組を返します。

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. Humanizeモード

起動時に humanize=True を渡すと、人間らしい入力とタイミングが加わります。自然なマウスの動き、リアルなタイピングのリズム、小さな不規則な間に加え、page.human_type と page.human_scroll のヘルパーも使えます。インタラクティブなフローではオンのままにし、速度が重要な単純な取得と解析ではオフにしてください。

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. セッションと同時実行数

稼働中のブラウザ1つが1セッションです。プランのセッション上限は、同時に実行できる数です。使い終わったブラウザを閉じると、セッションが解放されます。

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. レシピ:スクリーンショットと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. プラットフォームとCI

Linux、Windows、macOS向けのネイティブバイナリが提供され、ノートPC、CIランナー、フリートのいずれでも同じように動作します。CIでは、ライセンスキーをシークレットの環境変数として設定してください:

ci.yml
# 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つのブラウザセッションをご利用いただけ、その後終了します。より多くのセッションやサポートが必要な場合は、いつでもアップグレードできます。

始める準備はできましたか?

ライセンスキーを取得して、数分で最初のステルスセッションを動かしましょう。

ダッシュボードを開く