CLI Browserbase

Utilisez le CLI officiel bb pour les opérations de plateforme Browserbase, les workflows Functions et les appels API Fetch.

Vérification de la configuration

Avant d'utiliser le CLI, vérifiez qu'il est installé :

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

Pour les commandes authentifiées, définissez la clé API :

export BROWSERBASE_API_KEY="your_api_key"

Si vous utilisez bb functions dev ou bb functions publish, définissez aussi :

export BROWSERBASE_PROJECT_ID="your_project_id"

Quand utiliser cette skill

Utilisez cette skill quand l'utilisateur veut :

exécuter des commandes Browserbase via bb
créer, développer, publier ou invoquer des Browserbase Functions
inspecter ou gérer les sessions, projets, contextes ou extensions Browserbase
récupérer une page via Browserbase sans ouvrir une session navigateur
chercher sur le web via Browserbase sans ouvrir une session navigateur
explorer ou créer des modèles de démarrage avec bb templates

Quand ne pas utiliser cette skill

Pour la navigation interactive, l'inspection de page, les captures d'écran, les clics, la saisie ou les flux de connexion, préférez la skill browser.
Pour une simple récupération de contenu HTTP où l'utilisateur ne se soucie pas particulièrement d'utiliser le CLI, la skill fetch dédiée est souvent mieux adaptée.
Utilisez bb browse ... uniquement quand l'utilisateur demande explicitement le wrapper CLI ou travaille déjà dans un workflow centré sur bb.

Sélection de commande

bb functions pour le dev local, l'empaquetage, la publication et l'invocation
bb sessions, bb projects, bb contexts, bb extensions pour les ressources de plateforme Browserbase
bb fetch <url> pour les requêtes Fetch API
bb search "<query>" pour les requêtes Search API
bb templates pour explorer et créer des modèles de démarrage
bb browse ... pour déléguer au binaire browse autonome (nécessite @browserbasehq/browse-cli)
bb skills install pour installer les agent skills Browserbase pour Claude Code

Pour bb browse, le comportement du CLI browse autonome fait autorité : bb browse env local utilise par défaut un navigateur local isolé et propre, et bb browse env local --auto-connect opte pour réutiliser une session Chrome locale existante.

Workflows courants

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"}'

Utilisez bb functions invoke --check-status <invocation_id> pour interroger une invocation existante au lieu d'en créer une nouvelle.

APIs de plateforme

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

Templates

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

Bonnes pratiques

Préférez bb --help et --help du sous-groupe avant de deviner les flags.
Utilisez les flags en dash-case exactement comme indiqué dans l'aide du CLI.
Utilisez --output <file> sur bb fetch et bb search pour enregistrer les résultats dans un fichier.
Utilisez les variables d'environnement pour l'authentification sauf si l'utilisateur demande explicitement des remplacements ponctuels.
Passez les corps de requête structurés avec des chaînes JSON dans --body ou --params.
Rappelez-vous que bb functions ... utilise --api-url, tandis que les commandes d'API de plateforme utilisent --base-url.
Si bb browse échoue parce que browse est manquant, soit installez @browserbasehq/browse-cli, soit passez à la skill browser.

Dépannage

Clé API manquante : définissez BROWSERBASE_API_KEY ou passez --api-key
ID de projet manquant sur bb functions dev ou bb functions publish : définissez BROWSERBASE_PROJECT_ID ou passez --project-id
Flag inconnu : réexécutez la commande pertinente avec --help et utilisez la forme dash-case exacte
Erreur d'installation bb browse : exécutez npm install -g @browserbasehq/browse-cli

Pour la référence commande par commande et plus d'exemples, voir REFERENCE.md.

browserbase-cli