コンテンツへスキップ

Capzy Browser API. 接続して、自動化する。

Chrome DevTools Protocolを通じて、Capzyのインフラ上でブラウザの自動化を実行します。PlaywrightやPuppeteerのワークフローはそのままで、リモートセッション、オプションのプロキシ、永続プロファイルを利用できます。

お客様のスクリプト → CapzyのブラウザCDP / WebSocket
お客様のアプリケーションchromium.connect_over_cdp(CDP_URL)
リモートブラウザセッションpage.goto("https://example.com")
ページの読み取り、操作、結果の収集page.title() → "Example Domain"

接続URLから最初のページまで

クライアントをインストールし、CDPのURLをコピーして接続します。認証には、URLに含まれるBrowser APIのユーザー名とパスワードを使用します。

  1. Browser APIのプランを有効にする

    ワークロードに必要な同時セッション数、永続プロファイル数、帯域幅を含むプランを選択してください。

    Browser APIを開く
  2. 接続URLをコピー

    「概要」で、Browser APIのユーザー名とパスワードを含むCDPのURLをコピーし、CAPZY_CDP_URLとして保存します。これはソルバーのAPIキーとは別のものです。

  3. 接続して作業し、閉じる

    connect_over_cdp または puppeteer.connect を使用します。提供されたコンテキストでページを作成し、セッションを解放するため、finallyブロックでブラウザを閉じてください。

remote_browser.py
# Install: pip install playwright
import os
from playwright.sync_api import sync_playwright

# Copy your full authenticated URL from Dashboard > Browser API.
# Shape: wss://USERNAME:[email protected]/cdp
with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp(os.environ["CAPZY_CDP_URL"])
    try:
        page = browser.contexts[0].new_page()
        page.goto("https://example.com", wait_until="domcontentloaded")
        print(page.title())
    finally:
        browser.close()

ワークフローごとに必要な接続を

認証済みのCDP URLにクエリパラメーターを追加します。次回の接続でも同じIDを使いたい場合は、固定のプロファイル名を使用してください。

username:password必須 · URLの認証情報
ダッシュボードからコピーした完全なURLを使用してください。自分でURLを作成する場合は、ユーザー名とパスワードに含まれる予約文字をパーセントエンコードしてください。
profile=my-identity任意 · 永続化
プロファイル名を再利用すると、対応するブラウザの状態がセッション間で保持されます。プロファイルはプランのプロファイル上限にカウントされます。
proxy=capzy-US任意 · 米国のプロキシ
組み込みのプロキシオプションで、対応している国を選択します。場所を自動で選ぶには proxy=capzy を、プロキシが不要な場合は proxy=none を使用してください。
認証済みのCDP接続
wss://USERNAME:[email protected]/cdp?profile=my-identity&proxy=capzy-US
完全な接続URLは、ダッシュボード → Browser API → 概要で取得できます。外部に公開しないでください。

料金

プランでは、同時に実行できるブラウザセッション、保存されるプロファイル、含まれる帯域幅を個別に設定します。カスタムビルダーは現在の公開料金を使用します。

最新の料金を読み込み中…

最新の料金を読み込み中…

知っておきたいこと

Browser APIとCapium Browser、どちらを使うべきですか?

Browser APIはCapzyのインフラ上でブラウザをホストし、CDPを公開します。Capium Browserは、ご自身のマシンでブラウザを起動するSDKです。リモートの処理能力が必要な場合はBrowser APIを選択してください。

CDP接続が失敗するのはなぜですか?

プランが有効であること、ユーザー名とパスワードがダッシュボードと一致していること、アプリケーションが安全なWebSocketに接続できることを確認してください。同時セッション数の上限に達している場合も、新しい接続ができないことがあります。

Seleniumは必要ですか?

ここでの例はPlaywrightとPuppeteerを使用しています。Seleniumには適切なCDP接続の設定が必要です。WebSocketのURLをwebdriver.Remoteに渡すのではなく、Browser APIの接続ガイドに従ってください。

次のブラウザは、ここで動かせます。

処理能力を選び、接続URLをコピーして、上のサンプルから始めましょう。

ダッシュボードを開く