Maison

Skill

DevOps et CI/CD

browserbase-cli

browserbase/skills

Gérez les ressources de la plateforme Browserbase, les fonctions et les flux de travail API à l'aide de l'interface de ligne de commande `browse`.

...Développer tout

Heure mise à jour 30 septembre 2026

# browserbase # templates # web scraping # browse cli # cloud sessions # fetch api # functions # search api

CLI Browserbase

Utilisez l'interface CLI officielle de Browserbase pour les opérations sur la plateforme Browserbase, les workflows Functions et les appels à l'API Fetch.

Vérification de la configuration

Avant d'utiliser la CLI, vérifiez qu'elle est bien installée :

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

Pour les commandes nécessitant une authentification, définissez la clé API :

export BROWSERBASE_API_KEY="votre_clé_API"

Quand utiliser cette compétence

Utilisez cette compétence lorsque l'utilisateur souhaite :

exécuter des commandes Browserbase via browse
créer une structure, développer, publier ou appeler des fonctions Browserbase
inspecter ou gérer des sessions, des projets, des contextes ou des extensions Browserbase
récupérer une page via Browserbase sans ouvrir de session de navigateur
effectuer des recherches sur le Web via Browserbase sans ouvrir de session de navigateur
parcourir ou créer des structures de base à partir de modèles de démarrage avec browse templates

Quand ne pas utiliser cette compétence

Pour la navigation interactive, l’inspection de pages, les captures d’écran, les clics, la saisie de texte ou les processus de connexion, privilégiez la compétence « browser ».
Pour la simple récupération de contenu HTTP, lorsque l’utilisateur ne se soucie pas particulièrement d’utiliser l’interface CLI, la compétence « fetch » dédiée est souvent plus adaptée.
N’utilisez les commandes de niveau supérieur du pilote (browse open, browse get, browse click, …) que lorsque l’utilisateur souhaite explicitement suivre la voie de la CLI ou travaille déjà dans un workflow centré sur la navigation.

Sélection des commandes

Fonctions « browse » pour le développement local, le packaging, la publication et l’invocation
browse cloud sessions, browse cloud projects, browse cloud contexts, browse cloud extensions pour les ressources de la plateforme Browserbase
«browse cloud fetch » « » pour les requêtes de l’API Fetch
« » de recherche dans le cloud pour les requêtes de l’API Search
Parcourir les modèles pour découvrir et générer des modèles de démarrage
Parcourir « open », « get », « click », etc. pour le pilotage direct du navigateur en local ou à distance
«browse skills install » pour installer les compétences de l’agent Browserbase pour Claude Code

Pour travailler avec un navigateur local, utilisez « browse open --local » pour lancer un navigateur isolé et vierge. N’utilisez « browse open --auto-connect » que si vous devez vous connecter à une session Chrome existante pouvant être déboguée.

Workflows courants

Fonctions

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

Utilisez ` browse functions invoke --check-status ` pour interroger une invocation existante au lieu d'en créer une nouvelle.

API de la plateforme

browse cloud projects list
browse cloud sessions create --proxies --verified --region us-east-1
Parcourir les sessions cloud : create --solve-captchas --context-id ctx_abc --persist
Parcourir les sessions cloud : get 
Parcourir les téléchargements des sessions cloud : get  --output session-artifacts.zip
Parcourir les contextes cloud : créer --body '{"region":"us-west-2"}'
Parcourir les extensions cloud : télécharger ./my-extension.zip

API Fetch

parcourir les données du cloud récupérer https://example.com
parcourir les données du cloud récupérer https://example.com --allow-redirects --output page.html

API de recherche

Parcourir le cloud : recherche « automatisation du navigateur »
Parcourir le cloud : recherche « extraction de données Web » --num-results 5
Parcourir le cloud : recherche « agents IA » --output results.json

Modèles

parcourir la liste des modèles
parcourir la liste des modèles --tag Python --source Browserbase
parcourir les modèles clone form-filling --language typescript
parcourir les modèles clone amazon-product-scraping --language python ./my-scraper

Bonnes pratiques

Préférez la commande « browse --help » et « subgroup --help » avant d'essayer de deviner les options.
Utilisez les options en majuscules et minuscules exactement comme indiqué dans l’aide de l’interface en ligne de commande.
Utilisez --output avec « browse cloud fetch » et « browse cloud search » pour enregistrer les résultats dans un fichier.
Utilisez des variables d’environnement pour l’authentification, sauf si l’utilisateur souhaite explicitement des remplacements ponctuels.
Transmettez des corps de requête structurés avec des chaînes JSON via les options --body ou --params.
N'oubliez pas que les deux fonctions `browse ...` et `browse cloud ...` utilisent `--base-url` pour remplacer l'URL de base de l'API.

Dépannage

Clé API manquante : définissez BROWSERBASE_API_KEY ou passez l'option --api-key
Indicateur inconnu : relancez la commande concernée avec l'option --help et utilisez la forme exacte (avec les tirets et la casse)
Commande introuvable : relancez « npm install -g browse » et vérifiez de quelle version de « browse » il s'agit

Pour une référence commande par commande et davantage d’exemples, consultez REFERENCE.md.

Voir sur GitHub

---
name: browserbase-cli
description: Manage Browserbase platform resources, Functions, and API workflows through the `browse` CLI.
license: MIT
---

# Browserbase CLI

Use the official `browse` CLI for Browserbase platform operations, Functions workflows, and Fetch API calls.

## Setup check

Before using the CLI, verify it is installed:

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

For authenticated commands, set the API key:

```bash
export BROWSERBASE_API_KEY="your_api_key"
```

## When to use this skill

Use this skill when the user wants to:

- run Browserbase commands through `browse`
- scaffold, develop, publish, or invoke Browserbase Functions
- inspect or manage Browserbase sessions, projects, contexts, or extensions
- fetch a page through Browserbase without opening a browser session
- search the web through Browserbase without opening a browser session
- browse or scaffold starter templates with `browse templates`

## When not to use this skill

- For interactive browsing, page inspection, screenshots, clicking, typing, or login flows, prefer the `browser` skill.
- For simple HTTP content retrieval where the user does not care about using the CLI specifically, the dedicated `fetch` skill is often a better fit.
- Use the top-level driver commands (`browse open`, `browse get`, `browse click`, …) only when the user explicitly wants the CLI path or is already working in a `browse`-centric workflow.

## Command selection

- `browse functions` for local dev, packaging, publishing, and invocation
- `browse cloud sessions`, `browse cloud projects`, `browse cloud contexts`, `browse cloud extensions` for Browserbase platform resources
- `browse cloud fetch <url>` for Fetch API requests
- `browse cloud search "<query>"` for Search API requests
- `browse templates` to browse and scaffold starter templates
- `browse open`, `browse get`, `browse click`, etc. for direct local/remote browser driving
- `browse skills install` to install Browserbase agent skills for Claude Code

For local browser work, `browse open <url> --local` starts a clean isolated browser. Use `browse open <url> --auto-connect` only when you need to attach to an existing debuggable Chrome session.

## Common workflows

### Functions

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

Use `browse functions invoke --check-status <invocation_id>` to poll an existing invocation instead of creating a new one.

### Platform APIs

```bash
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

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

### Search API

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

### Templates

```bash
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
```

## Best practices

1. Prefer `browse --help` and subgroup `--help` before guessing flags.
2. Use dash-case flags exactly as shown in CLI help.
3. Use `--output <file>` on `browse cloud fetch` and `browse cloud search` to save results to a file.
4. Use environment variables for auth unless the user explicitly wants one-off overrides.
5. Pass structured request bodies with JSON strings in `--body` or `--params`.
6. Remember that both `browse functions ...` and `browse cloud ...` use `--base-url` for API base URL overrides.

## Troubleshooting

- Missing API key: set `BROWSERBASE_API_KEY` or pass `--api-key`
- Unknown flag: rerun the relevant command with `--help` and use the exact dash-case form
- Command not found: re-run `npm install -g browse` and verify with `which browse`

For command-by-command reference and more examples, see [REFERENCE.md](REFERENCE.md).