Browserbase CLI

Browserbase プラットフォーム操作、Functions ワークフロー、および Fetch API 呼び出しに公式の bb CLI を使用してください。

セットアップの確認

CLI を使用する前に、インストールされていることを確認してください:

which bb || npm install -g @browserbasehq/cli
bb --help

認証が必要なコマンドの場合、API キーを設定してください:

export BROWSERBASE_API_KEY="your_api_key"

bb functions dev または bb functions publish を使用する場合は、以下も設定してください:

export BROWSERBASE_PROJECT_ID="your_project_id"

このスキルを使用する場合

ユーザーが以下を望む場合、このスキルを使用してください:

• bb を通じて Browserbase コマンドを実行する
• Browserbase Functions をスキャフォルド、開発、公開、または呼び出す
• Browserbase セッション、プロジェクト、コンテキスト、またはエクステンションを検査または管理する
• ブラウザセッションを開かずに Browserbase を通じてページを取得する
• ブラウザセッションを開かずに Browserbase を通じてウェブを検索する
• bb templates を使用してスターターテンプレートをブラウズまたはスキャフォルドする

このスキルを使用しない場合

• インタラクティブなブラウジング、ページ検査、スクリーンショット、クリック、入力、またはログインフローの場合は、browser スキルを優先してください。
• ユーザーが CLI の使用を特に気にしない単純な HTTP コンテンツ取得の場合は、専用の fetch スキルがより適切です。
• bb browse ... は、ユーザーが明示的に CLI ラッパーを望んでいるか、既に bb 中心のワークフローで作業している場合にのみ使用してください。

コマンドの選択

• bb functions はローカル開発、パッケージング、公開、および呼び出し用
• bb sessions、bb projects、bb contexts、bb extensions は Browserbase プラットフォームリソース用
• bb fetch <url> は Fetch API リクエスト用
• bb search "<query>" は Search API リクエスト用
• bb templates はスターターテンプレートのブラウズとスキャフォルド用
• bb browse ... はスタンドアロンの browse バイナリに転送する用 (@browserbasehq/browse-cli が必要)
• bb skills install は Claude Code 用の Browserbase agent skills をインストール用

bb browse については、スタンドアロンの browse CLI 動作が真実の源です: bb browse env local はデフォルトでクリーンな分離ローカルブラウザを使用し、bb browse env local --auto-connect は既存のローカル Chrome セッションの再利用をオプトインします。

一般的なワークフロー

Functions

bb functions init my-function
cd my-function
bb functions dev index.ts
bb functions publish index.ts
bb functions invoke <function_id> --params '{"url":"https://example.com"}'

新しい呼び出しを作成する代わりに、既存の呼び出しをポーリングするには bb functions invoke --check-status <invocation_id> を使用してください。

プラットフォーム API

bb projects list
bb sessions create --proxies --advanced-stealth --region us-east-1
bb sessions create --solve-captchas --context-id ctx_abc --persist
bb sessions get <session_id>
bb sessions downloads get <session_id> --output session-artifacts.zip
bb contexts create --body '{"region":"us-west-2"}'
bb extensions upload ./my-extension.zip

Fetch API

bb fetch https://example.com
bb fetch https://example.com --allow-redirects --output page.html

Search API

bb search "browser automation"
bb search "web scraping" --num-results 5
bb search "AI agents" --output results.json

テンプレート

bb templates list
bb templates list --language python
bb templates clone form-filling --language typescript
bb templates clone amazon-product-scraping --language python ./my-scraper

ベストプラクティス

1. フラグを推測する前に bb --help およびサブグループ --help を優先してください。
2. CLI ヘルプに示されているとおりにダッシュケースフラグを使用してください。
3. bb fetch と bb search で --output <file> を使用して結果をファイルに保存してください。
4. ユーザーが明示的に一時的なオーバーライドを望まない限り、認証用の環境変数を使用してください。
5. --body または --params で JSON 文字列を使用して構造化されたリクエストボディを渡してください。
6. bb functions ... は --api-url を使用し、プラットフォーム API コマンドは --base-url を使用することを忘れないでください。
7. browse がないために bb browse が失敗する場合は、@browserbasehq/browse-cli をインストールするか、browser スキルに切り替えてください。

トラブルシューティング

• API キーがない: BROWSERBASE_API_KEY を設定するか、--api-key を渡してください
• bb functions dev または bb functions publish でプロジェクト ID がない: BROWSERBASE_PROJECT_ID を設定するか、--project-id を渡してください
• 不明なフラグ: 関連するコマンドを --help で再実行し、正確なダッシュケース形式を使用してください
• bb browse インストールエラー: npm install -g @browserbasehq/browse-cli を実行してください

コマンド別のリファレンスとその他の例については、REFERENCE.md を参照してください。