browser-use

Browser Use

Browser Use は、API を通じてクラウドブラウザーと自律型ブラウザー自動化を提供します。

ドキュメント：

• オープンソースライブラリ：https://docs.browser-use.com
• クラウド API：https://docs.cloud.browser-use.com

セットアップ

API キーは、clawdbot の設定 skills.entries.browser-use.apiKey から読み込まれます。

設定されていない場合は、ユーザーに次のように伝えてください：

Browser Use を使うには、API キーが必要です。https://cloud.browser-use.com で取得してください（新規登録すると、10 ドル分の無料クレジットを利用できます）。その後、次のように設定してください：

clawdbot config set skills.entries.browser-use.apiKey "bu_your_key_here"

ベース URL：https://api.browser-use.com/api/v2

すべてのリクエストに、次のヘッダーが必要です：X-Browser-Use-API-Key: <apiKey>

---

1. ブラウザーセッション（メイン）

Clawdbot が直接操作できるクラウドブラウザーを起動します。プロファイルを使うと、ログイン状態や Cookie を保持できます。

ブラウザーセッションを作成する

# With profile (recommended - keeps you logged in)
curl -X POST "https://api.browser-use.com/api/v2/browsers" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profileId": "<profile-uuid>", "timeout": 60}'

# Without profile (fresh browser)
curl -X POST "https://api.browser-use.com/api/v2/browsers" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout": 60}'

レスポンス：

{
  "id": "session-uuid",
  "cdpUrl": "https://<id>.cdp2.browser-use.com",
  "liveUrl": "https://...",
  "status": "active"
}

Clawdbot をブラウザーに接続する

gateway config.patch '{"browser":{"profiles":{"browseruse":{"cdpUrl":"<cdpUrl-from-response>"}}}}'

profile=browseruse を指定して browser ツールを使い、ブラウザーを操作します。

ブラウザーセッションを一覧表示／停止する

# List active sessions
curl "https://api.browser-use.com/api/v2/browsers" -H "X-Browser-Use-API-Key: $API_KEY"

# Get session status
curl "https://api.browser-use.com/api/v2/browsers/<session-id>" -H "X-Browser-Use-API-Key: $API_KEY"

# Stop session (unused time is refunded)
curl -X PATCH "https://api.browser-use.com/api/v2/browsers/<session-id>" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "stopped"}'

料金： 従量課金制では 1 時間あたり 0.06 ドル、Business では 1 時間あたり 0.03 ドルです。1 セッションの最長時間は 4 時間です。分単位で課金され、未使用分は返金されます。

---

2. プロファイル

プロファイルを使うと、ブラウザーセッション間で Cookie とログイン状態を保持できます。プロファイルを作成し、ブラウザーでアカウントにログインしてから再利用します。

# List profiles
curl "https://api.browser-use.com/api/v2/profiles" -H "X-Browser-Use-API-Key: $API_KEY"

# Create profile
curl -X POST "https://api.browser-use.com/api/v2/profiles" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Profile"}'

# Delete profile
curl -X DELETE "https://api.browser-use.com/api/v2/profiles/<profile-id>" \
  -H "X-Browser-Use-API-Key: $API_KEY"

ヒント： Browser Use Chrome 拡張機能を使って、ローカルの Chrome から Cookie を同期することもできます。

---

3. タスク（サブエージェント）

ブラウザー操作を代行するサブエージェントのように、自律型ブラウザータスクを実行します。プロンプトを渡すと、タスクを完了します。

常に browser-use-llm を使用してください。ブラウザータスクに最適化されており、他のモデルより 3～5 倍高速です。

curl -X POST "https://api.browser-use.com/api/v2/tasks" \
  -H "X-Browser-Use-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Go to amazon.com and find the price of the MacBook Air M3",
    "llm": "browser-use-llm"
  }'

完了を確認する

curl "https://api.browser-use.com/api/v2/tasks/<task-id>" -H "X-Browser-Use-API-Key: $API_KEY"

レスポンス：

{
  "status": "finished",
  "output": "The MacBook Air M3 is priced at $1,099",
  "isSuccess": true,
  "cost": "0.02"
}

ステータスの値：pending、running、finished、failed、stopped

タスクのオプション

オプション	説明
task	プロンプト（必須）
llm	常に browser-use-llm を使用
startUrl	開始ページ
maxSteps	アクションの最大数（デフォルトは 100）
sessionId	既存のセッションを再利用
profileId	認証に使うプロファイル
flashMode	さらに高速な実行
vision	視覚的な理解

---

API リファレンス全文

Sessions、Files、Skills、Skills Marketplace を含むすべてのエンドポイントについては、references/api.md を参照してください。