本文へスキップ

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 分のタイムアウトを指定しています。

セッションの設定

BrowserbaseClearcote の作成ボディ
proxies: true、プロキシの地域指定デフォルトはマネージドの住宅用プールです。country、state、city で出口を選びます
proxies に指定した自前のプロキシproxy: { server, username, password }
persist: true 付きのコンテキスト IDprofile: { name: "acct-1", persist: true }
フィンガープリント設定fingerprint(シード)、timezone、locale、またはアカウントごとに同じデバイスと IP を使う identity。ホスト型ブラウザは Windows デバイスとして振る舞います
keepAlive, timeoutkeepAlive, 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 単位のトラフィックで課金されます:料金 & トラフィック。

2026年10月16日 更新 · SDK 0.70.5 · ブラウザー r63

このページは役に立ちましたか?