Browserbase-CLI

Verwenden Sie die offizielle Browserbase -CLI für Plattformoperationen, Functions-Workflows und Fetch-API-Aufrufe.

Einrichtungsprüfung

Bevor Sie die CLI verwenden, überprüfen Sie, ob sie installiert ist:

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

Für authentifizierte Befehle legen Sie den API-Schlüssel fest:

export BROWSERBASE_API_KEY="Ihr_API-Schlüssel"

Wann sollte diese Funktion verwendet werden?

Verwenden Sie diese Funktion, wenn der Benutzer Folgendes tun möchte:

• Browserbase-Befehle über „browse“ ausführen
• Browserbase-Funktionen erstellen, entwickeln, veröffentlichen oder aufrufen
• Browserbase-Sitzungen, Projekte, Kontexte oder Erweiterungen überprüfen oder verwalten
• eine Seite über Browserbase abrufen, ohne eine Browsersitzung zu öffnen
• über Browserbase im Internet suchen, ohne eine Browsersitzung zu öffnen
• Startervorlagen mit „browse templates“ durchsuchen oder erstellen

Wann Sie diese Funktion nicht verwenden sollten

• Für interaktives Surfen, die Seitenprüfung, Screenshots, Klicks, Eingaben oder Anmeldeabläufe sollten Sie die Browser -Funktion bevorzugen.
• Für das einfache Abrufen von HTTP-Inhalten, bei dem es dem Benutzer nicht wichtig ist, speziell die CLI zu verwenden, ist die spezielle „fetch“-Funktion oft besser geeignet.
• Verwenden Sie die Treiberbefehle der obersten Ebene (browse open, browse get, browse click, …) nur, wenn der Benutzer ausdrücklich den CLI-Pfad wünscht oder bereits in einem auf das Durchsuchen ausgerichteten Arbeitsablauf arbeitet.

Befehlsauswahl

• „browse“-Funktionen für lokale Entwicklung, Paketierung, Veröffentlichung und Aufruf
• „browse cloud sessions“, „browse cloud projects“, „browse cloud contexts“, „browse cloud extensions“ für Ressourcen der Browserbase-Plattform
• „browse cloud fetch“ “ für Fetch-API-Anfragen
• „Browse Cloud Search“ „ “ für Search-API-Anfragen
• Vorlagen durchsuchen, um Starter-Vorlagen zu durchsuchen und zu generieren
• „browse open“, „browse get“, „browse click“ usw. für die direkte lokale/remote Steuerung des Browsers
• „browse skills install“, um Browserbase-Agent-Skills für Claude Code zu installieren

Für die Arbeit mit dem lokalen Browser startet „browse open --local“ einen sauberen, isolierten Browser. Verwenden Sie „browse open --auto-connect“ nur, wenn Sie eine Verbindung zu einer bestehenden, debuggbaren Chrome-Sitzung herstellen müssen.

Gängige Arbeitsabläufe

Funktionen

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

Verwenden Sie „browse functions invoke --check-status “, um einen bestehenden Aufruf abzufragen, anstatt einen neuen zu erstellen.

Plattform-APIs

browse cloud projects list
browse cloud sessions create --proxies --verified --region us-east-1
Cloud-Sitzungen durchsuchen und erstellen --solve-captchas --context-id ctx_abc --persist
Cloud-Sitzungen durchsuchen und abrufen 
Cloud-Sitzungen durchsuchen und Downloads abrufen  --output session-artifacts.zip
Cloud-Kontexte durchsuchen, erstellen --body '{"region":"us-west-2"}'
Cloud-Erweiterungen durchsuchen, hochladen ./my-extension.zip

Fetch-API

Cloud durchsuchen, Fetch-Anfrage https://example.com
Cloud durchsuchen, Fetch-Anfrage https://example.com --allow-redirects --output page.html

Such-API

Cloud durchsuchen: Suche nach „Browser-Automatisierung“
Cloud durchsuchen: Suche nach „Web-Scraping“ --num-results 5
Cloud durchsuchen: Suche nach „KI-Agenten“ --output results.json

Vorlagen

Vorlagenliste durchsuchen
Vorlagenliste durchsuchen --tag Python --source Browserbase
Vorlagen durchsuchen form-filling klonen --language typescript
Vorlagen durchsuchen amazon-product-scraping klonen --language python ./my-scraper

Bewährte Vorgehensweisen

1. Verwenden Sie vorzugsweise „browse --help“ und „subgroup --help“, bevor Sie Flags erraten.
2. Verwenden Sie Flags mit Bindestrich-Groß-/Kleinschreibung genau wie in der CLI-Hilfe angegeben.
3. Verwenden Sie bei „browse cloud fetch“ und „browse cloud search“ die Option „--output “, um die Ergebnisse in einer Datei zu speichern.
4. Verwenden Sie Umgebungsvariablen für die Authentifizierung, es sei denn, der Benutzer wünscht ausdrücklich einmalige Überschreibungen.
5. Übergeben Sie strukturierte Anfragetexte mit JSON-Zeichenfolgen in „--body “ oder „--params“.
6. Beachten Sie, dass sowohl die „browse“-Funktionen … als auch „browse cloud“ … „--base-url“ für die Überschreibung der API-Basis-URL verwenden.

Fehlerbehebung

• Fehlender API-Schlüssel: Setzen Sie BROWSERBASE_API_KEY oder übergeben Sie --api-key
• Unbekanntes Flag: Führen Sie den entsprechenden Befehl erneut mit --help aus und verwenden Sie die exakte Schreibweise mit Bindestrichen und Groß-/Kleinschreibung
• Befehl nicht gefunden: Führen Sie „npm install -g browse“ erneut aus und überprüfen Sie, um welche „browse“-Version es sich handelt

Eine befehlsbezogene Referenz und weitere Beispiele finden Sie in REFERENCE.md.