browserbase-cli

Browserbase CLI

Browserbase プラットフォームの操作、Functions ワークフロー、Fetch API の呼び出しには、公式の browse CLI を使用します。

セットアップの確認

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

which browse || npm install -g browse
browse --help

認証が必要なコマンドでは、API キーを設定してください。

export BROWSERBASE_API_KEY="your_api_key"

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

次のような操作をユーザーが希望する場合に、このスキルを使用してください。

• browse を通じて Browserbase コマンドを実行する
• Browserbase Functions のひな形を作成、開発、公開、または呼び出す
• Browserbase のセッション、プロジェクト、コンテキスト、または拡張機能を確認または管理する
• ブラウザーセッションを開かずに、Browserbase を通じてページを取得する
• ブラウザーセッションを開かずに、Browserbase を通じてウェブを検索する
• browse templates でスターターテンプレートを確認、またはひな形を作成する

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

• インタラクティブなブラウジング、ページの確認、スクリーンショット、クリック、入力、ログイン操作には、browser スキルを優先してください。
• CLI の使用にこだわらない単純な HTTP コンテンツ取得には、専用の fetch スキルのほうが適している場合がよくあります。
• トップレベルのドライバーコマンド（browse open、browse get、browse click など）は、ユーザーが CLI の使用を明示的に希望している場合、またはすでに browse 中心のワークフローを利用している場合に限って使用してください。

コマンドの選択

• ローカルでの開発、パッケージ化、公開、呼び出しには browse functions
• Browserbase プラットフォームのリソースには browse cloud sessions、browse cloud projects、browse cloud contexts、browse cloud extensions
• Fetch API リクエストには browse cloud fetch <url>
• Search API リクエストには browse cloud search "<query>"
• スターターテンプレートの確認とひな形作成には browse templates
• ローカル／リモートブラウザーの直接操作には browse open、browse get、browse click など
• Claude Code 用の Browserbase エージェントスキルのインストールには browse skills install

ローカルでブラウザーを操作する場合、browse open <url> --local はクリーンな隔離ブラウザーを起動します。既存のデバッグ可能な Chrome セッションに接続する必要がある場合に限り、browse open <url> --auto-connect を使用してください。

よくあるワークフロー

Functions

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

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

プラットフォーム API

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

Fetch API

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

Search API

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

テンプレート

browse templates list
browse templates list --tag Python --source Browserbase
browse templates clone form-filling --language typescript
browse templates clone amazon-product-scraping --language python ./my-scraper

ベストプラクティス

1. フラグを推測する前に、browse --help とサブグループの --help を確認してください。
2. CLI のヘルプに表示されたとおりに、ダッシュケースのフラグを使用してください。
3. 結果をファイルに保存するには、browse cloud fetch と browse cloud search で --output <file> を使用してください。
4. ユーザーが一度限りの上書きを明示的に希望している場合を除き、認証には環境変数を使用してください。
5. 構造化されたリクエストボディは、JSON 文字列として --body または --params に渡してください。
6. browse functions ... と browse cloud ... のどちらでも、API ベース URL の上書きに --base-url を使用することに注意してください。

トラブルシューティング

• API キーが見つからない場合：BROWSERBASE_API_KEY を設定するか、--api-key を渡してください
• 不明なフラグがある場合：該当するコマンドで --help を再実行し、正確なダッシュケース形式を使用してください
• コマンドが見つからない場合：npm install -g browse を再実行し、which browse で確認してください

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