Browserbase CLI

Используйте официальную командную строку Browserbase для управления платформой Browserbase, рабочими процессами Functions и вызовами Fetch API.

Проверка настройки

Перед использованием CLI убедитесь, что он установлен:

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

Для команд, требующих аутентификации, установите ключ API:

export BROWSERBASE_API_KEY="your_api_key"

Когда использовать этот навык

Используйте этот навык, если пользователь хочет:

• запускать команды Browserbase через browse
• создавать каркасы, разрабатывать, публиковать или вызывать функции Browserbase
• просматривать или управлять сессиями, проектами, контекстами или расширениями Browserbase
• загрузить страницу через Browserbase без открытия сеанса браузера
• выполнять поиск в Интернете через Browserbase без открытия сеанса браузера
• просматривать или создавать каркасы шаблонов-стартеров с помощью команды browse templates

Когда не следует использовать этот навык

• Для интерактивного просмотра, проверки страниц, создания скриншотов, нажатия кнопок, ввода текста или процедур входа в систему лучше использовать навык browser.
• Для простого извлечения HTTP-контента, когда пользователю не важно конкретно использовать CLI, часто лучше подходит специальный навык fetch.
• Используйте команды драйвера верхнего уровня (browse open, browse get, browse click и т. д.) только в тех случаях, когда пользователь явно хочет использовать CLI или уже работает в рабочем процессе, ориентированном на просмотр страниц.

Выбор команд

• Функции «browse» для локальной разработки, упаковки, публикации и вызова
• «browse cloud sessions», «browse cloud projects», «browse cloud contexts», «browse cloud extensions» для ресурсов платформы Browserbase
• `browse cloud fetch ` для запросов Fetch API
• « » для запросов Search API
• просмотр шаблонов для просмотра и создания стартовых шаблонов
• просмотр open, get, click и т. д. для прямого управления локальным/удаленным браузером
• просмотр «skills install» для установки навыков агента Browserbase для Claude Code

Для работы с локальным браузером команда «browse open --local» запускает чистый изолированный браузер. Используйте команду «browse open --auto-connect» только в том случае, если вам нужно подключиться к существующему сеансу Chrome, доступному для отладки.

Типичные рабочие процессы

Функции

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

Используйте команду ` browse functions invoke --check-status `, чтобы опросить существующий вызов вместо создания нового.

API платформы

просмотр списка облачных проектов
просмотр сеансов в облаке create --proxies --verified --region us-east-1
просмотр облачных сессий: create --solve-captchas --context-id ctx_abc --persist
просмотр облачных сессий: get 
просмотр облачных сессий: downloads get  --output session-artifacts.zip
просмотр облачных контекстов create --body '{"region":"us-west-2"}'
просмотр облачных расширений upload ./my-extension.zip

Fetch API

просмотр облачного запроса https://example.com
просмотр облачного запроса https://example.com --allow-redirects --output page.html

API поиска

просмотр облака поиск "автоматизация браузера"
просмотр облака поиск "веб-парсинг" --num-results 5
просмотр облака поиск "AI-агенты" --output results.json

Шаблоны

просмотреть список шаблонов
просмотреть список шаблонов --tag Python --source Browserbase
просмотреть шаблоны клонировать form-filling --language typescript
просмотреть шаблоны клонировать amazon-product-scraping --language python ./my-scraper

Рекомендации

1. Прежде чем угадывать флаги, лучше воспользоваться командами browse --help и subgroup --help.
2. Используйте флаги с типографским различием между заглавными и строчными буквами точно так, как показано в справке CLI.
3. Используйте `--output ` при выполнении команд ` browse cloud fetch ` и `browse cloud search `, чтобы сохранить результаты в файл.
4. Используйте переменные среды для аутентификации, если только пользователь явно не хочет одноразовых переопределений.
5. Передавайте структурированные тела запросов с помощью строк JSON в параметрах --body или --params.
6. Помните, что обе команды `browse functions ...` и `browse cloud ... ` используют параметр `--base-url` для переопределения базового URL-адреса API.

Устранение неполадок

• Отсутствующий ключ API: установите BROWSERBASE_API_KEY или передайте --api-key
• Неизвестный флаг: запустите соответствующую команду с парамет ром --help и используйте форму с точным соблюдением регистра
• Команда не найдена: запустите npm install -g browse заново и проверьте, какой именно browse

Подробное руководство по каждой команде и дополнительные примеры см. в файле REFERENCE.md.