Hogar

Skill

DevOps y CI/CD

browserbase-cli

browserbase/skills

Gestiona los recursos de la plataforma Browserbase, las funciones y los flujos de trabajo de la API a través de la CLI `browse`.

...Expandir todo

Tiempo actualizado 30 de septiembre de 2026

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

CLI de Browserbase

Utiliza la CLI oficial de Browserbase para las operaciones de la plataforma Browserbase, los flujos de trabajo de Functions y las llamadas a la API Fetch.

Comprobación de la configuración

Antes de utilizar la CLI, comprueba que esté instalada:

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

Para los comandos que requieren autenticación, configura la clave de API:

export BROWSERBASE_API_KEY="tu_clave_API"

Cuándo utilizar esta habilidad

Utiliza esta habilidad cuando el usuario quiera:

ejecutar comandos de Browserbase a través de browse
crear esqueletos, desarrollar, publicar o invocar funciones de Browserbase
inspeccionar o gestionar sesiones, proyectos, contextos o extensiones de Browserbase
recoger una página a través de Browserbase sin abrir una sesión de navegador
buscar en la web a través de Browserbase sin abrir una sesión de navegador
navegar o crear plantillas de inicio con «browse templates»

Cuándo no utilizar esta habilidad

Para la navegación interactiva, la inspección de páginas, las capturas de pantalla, los clics, la introducción de texto o los flujos de inicio de sesión, es preferible utilizar la habilidad «browser ».
Para la simple recuperación de contenido HTTP, en la que al usuario no le importa utilizar la CLI específicamente, la habilidad «fetch» específica suele ser más adecuada.
Utiliza los comandos de controlador de nivel superior (browse open, browse get, browse click, …) solo cuando el usuario desee explícitamente la ruta de la CLI o ya esté trabajando en un flujo de trabajo centrado en la navegación.

Selección de comandos

Funciones de navegación para desarrollo local, empaquetado, publicación e invocación
«browse cloud sessions», «browse cloud projects», «browse cloud contexts» y «browse cloud extensions» para los recursos de la plataforma Browserbase
«browse cloud fetch » para solicitudes de la API de Fetch
«browse cloud search "" » para las solicitudes de la API de búsqueda
explorar plantillas para explorar y generar plantillas de inicio
explorar «open», «get», «click», etc., para el control directo del navegador local o remoto
«browse skills install» para instalar las habilidades del agente de Browserbase para Claude Code

Para trabajar con el navegador local, utiliza «navegar abrir --local» para iniciar un navegador limpio y aislado. Utiliza «navegar abrir --auto-connect» solo cuando necesites conectarte a una sesión de Chrome existente que se pueda depurar.

Flujos de trabajo habituales

Funciones

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

Utiliza «explorar funciones invocar --check-status » para consultar una invocación existente en lugar de crear una nueva.

API de la plataforma

explorar proyectos en la nube list
explorar sesiones en la nube create --proxies --verified --region us-east-1
explorar sesiones en la nube: crear --solve-captchas --context-id ctx_abc --persist
explorar sesiones en la nube: obtener 
explorar descargas de sesiones en la nube: obtener  --output session-artifacts.zip
explorar contextos en la nube crear --body '{"region":"us-west-2"}'
explorar extensiones en la nube subir ./my-extension.zip

API Fetch

explorar la nube: recuperar https://example.com
explorar la nube: recuperar https://example.com --allow-redirects --output page.html

API de búsqueda

explorar la nube buscar «automatización del navegador»
explorar la nube buscar «web scraping» --num-results 5
explorar la nube buscar «agentes de IA» --output results.json

Plantillas

explorar lista de plantillas
explorar lista de plantillas --tag Python --source Browserbase
explorar plantillas clonar form-filling --language typescript
explorar plantillas clonar amazon-product-scraping --language python ./my-scraper

Prácticas recomendadas

Es mejor consultar «browse --help» y «subgroup --help» antes de adivinar los parámetros.
Utiliza los indicadores con mayúsculas y minúsculas tal y como se muestran en la ayuda de la CLI.
Utiliza --output en «explorar» la obtención de datos en la nube y en «explorar» la búsqueda en la nube para guardar los resultados en un archivo.
Utiliza variables de entorno para la autenticación, a menos que el usuario desee explícitamente realizaciones puntuales.
Pasa cuerpos de solicitud estructurados con cadenas JSON en --body o --params.
Recuerda que tanto las funciones «browse...» como «browse cloud...» utilizan --base-url para anular la URL base de la API.

Solución de problemas

Falta la clave de API: configura BROWSERBASE_API_KEY o pasa --api-key
Opción desconocida: vuelve a ejecutar el comando correspondiente con --help y utiliza la forma exacta con guiones y mayúsculas
Comando no encontrado: vuelve a ejecutar ` npm install -g browse ` y comprueba con qué versión de «browse»

Para consultar la referencia comando por comando y ver más ejemplos, consulta REFERENCE.md.

Ver en 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).