# Python SDK
pip install capiumbrowser
# Or in a JavaScript / TypeScript project
npm install capiumbrowserWindows、macOS、Linuxプランは同時セッション数で決まります
製品サイトとドキュメント: capiumbrowser.com
最初のローカルブラウザまでの3ステップ
まずはPythonから始めましょう。SDKは初回起動時にブラウザのバイナリをダウンロードするため、初回の実行には時間とネットワーク接続が必要です。
SDKをインストールしてキーを設定
pipまたはnpmでcapiumbrowserをインストールします。ブラウザを起動するプロセスの環境に、CAPIUM_LICENSE_KEYを設定してください。
セッションを起動して閉じる
launch_contextはbrowser、context、pageを返します。通常どおりpageを操作し、ブラウザを閉じてセッションを解放します。
# macOS / Linux: use the license key from your dashboard.
export CAPIUM_LICENSE_KEY='YOUR_CAPIUM_LICENSE_KEY'
# Then launch your script in this shell.
python first_browser.pyfrom capiumbrowser import launch_context
# Set CAPIUM_LICENSE_KEY before running this script.
# The browser binary downloads on first launch.
browser, context, page = launch_context(
seed=200123,
humanize=True,
url="https://example.com",
)
try:
print(page.title())
finally:
browser.close()ダッシュボードでCapium Browserを開き、プランを有効にしてライセンスキーをコピーします。このキーはCapzy APIキーとは別のものです。 ライセンスキーを取得
知っておきたい設定
1つのスクリプトからワーカーのフリートへ拡大する際も、IDとプロセスのライフサイクルは明示的に管理してください。
CAPIUM_LICENSE_KEY必須 · 環境変数- Capiumダッシュボードのライセンスキーを設定します。コンテナやワーカープロセスには、シークレットの設定を通じて渡してください。
seed任意 · ID- ワークフローで同じ一貫したデバイスを示す必要がある場合は、シードを再利用します。シードだけでなく、設定も同じに保ってください。
humanize任意 · 操作の挙動- ワークフローに合う場合は、SDKの人間らしい入力の挙動を有効にします。対象サイトがすべてのリクエストを受け入れることを保証するものではありません。
url任意 · 開始ページ- 起動時に最初のURLを指定するか、返されたpageで移動します。タスクが終了したら、finallyブロックでブラウザを閉じてください。
料金
同時に実行するブラウザの数でプランを選びます。同時セッション数は、1か月に送信するリクエストの総数とは異なります。
最新の料金を読み込み中…
知っておきたいこと
CapiumはCapzyのサーバーで動作しますか?
Capium SDKは、インストールしたマシン上でブラウザを実行します。Capzyにブラウザをホストさせ、CDPでリモート接続したい場合はBrowser APIをご利用ください。
初回の起動に時間がかかるのはなぜですか?
SDKは初回使用時にブラウザのバイナリをダウンロードします。マシンからダウンロードサービスに接続できること、プロセスにブラウザのキャッシュへの書き込み権限があることを確認してください。
ライセンスが検出されないのはなぜですか?
SDKを起動するのと同じシェル、コンテナ、サービスでCAPIUM_LICENSE_KEYが設定されていることを確認してください。また、ライセンスが有効であること、同時セッションに空きがあることも確認してください。
まずは1つのローカルセッションから。
ライセンスキーを取得してPythonの例を実行し、ワークロードに合わせて同時実行数を増やしましょう。
