Browserbase からの移行
Browserbase と Clearcote のホスト型ブラウザは同じ仕組みです。セッションを作成し、CDP アドレスを受け取り、Playwright、Puppeteer、Stagehand を接続します。移行で変わるのは作成呼び出しだけで、接続後の処理はそのまま使えます。
変更点
import os
from browserbase import Browserbase
from playwright.sync_api import sync_playwright
from clearcote import launch
session = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"]).sessions.create()
browser = sync_playwright().start().chromium.connect_over_cdp(session.connect_url)
page = browser.contexts[0].pages[0]
browser = launch(cloud=True, identity="acct-1", country="us") # creates the session and connects
page = browser.contexts[0].new_page()
page.goto("https://example.com")
browser.close()このタブはあなたのマシンで実行します。
キーは「API keys」ページで取得します。1 点だけ動作が異なります。connectUrl は 1 回限りで、作成呼び出しから 45 秒で期限切れになります。すぐに接続し、新しい接続のたびに新しいセッションを作成してください。ブラウザは接続した時点で起動するため、例では Playwright に 2 分のタイムアウトを指定しています。
セッションの設定
| Browserbase | Clearcote の作成ボディ |
|---|---|
proxies: true、プロキシの地域指定 | デフォルトはマネージドの住宅用プールです。country、state、city で出口を選びます |
proxies に指定した自前のプロキシ | proxy: { server, username, password } |
persist: true 付きのコンテキスト ID | profile: { name: "acct-1", persist: true } |
| フィンガープリント設定 | fingerprint(シード)、timezone、locale、またはアカウントごとに同じデバイスと IP を使う identity。ホスト型ブラウザは Windows デバイスとして振る舞います |
keepAlive, timeout | keepAlive, timeoutSec, idleTimeoutSec |
| セッションの録画 | record: true。その後、録画とそのリプレイを利用できます |
| ライブデバッガーの URL | ダッシュボードのライブビュー。操作を引き継いだり共有したりできます |
すべてのオプション:オプション & アイデンティティ。ライブビューと共有:ライブビュー & セッション。録画:録画 & イベント。
Stagehand とその他のエージェントフレームワーク
Browserbase のセッションの代わりに、フレームワークの接続先を connectUrl にします。
javascript
// Stagehand v4
import { localBrowser, Stagehand } from "@browserbasehq/stagehand";
const stagehand = await Stagehand.create({ browser: await localBrowser.connect({ cdpUrl: session.connectUrl }) });python
# Browser Use
from browser_use import Agent, Browser
agent = Agent(task="Find the cheapest flight to Lisbon next Friday", llm=llm, browser=Browser(cdp_url=session["connectUrl"]))
await agent.run()Crawl4AI などについてはフレームワーク & Playgroundを参照してください。フレームワークを使わない場合は、タスクを自然な言葉で書いてエージェントの実行として送ると、JSON が返ってきます。
自分のマシンでも同じコード
cloud を省略し、本番環境では CLEARCOTE_CLOUD=1 を設定します。同じ launch() が、ノート PC ではローカルのブラウザを、本番環境ではホスト型ブラウザを起動します。ローカルとクラウドを参照してください。ホスト型ブラウザはプリペイド残高から GB 単位のトラフィックで課金されます:料金 & トラフィック。