Skip to main content

​
Browserbase

ShanoneのBrowserbase連携では、ヘッドレスクラウドブラウザに関する63個のツールをエージェントに提供します — セッション/コンテキスト管理、低レベルなページ操作(クリック、遷移、スクリーンショット)、より高レベルなブラウザエージェント、そしてブラウザコンテキスト内で実行できるサーバーレスFunctionをカバーしています。

​
はじめに

1

Browserbase APIキーを取得する

BrowserbaseダッシュボードのSettingsで、APIキー(および任意でProject ID)をコピーします。
2

Shanoneで接続する

エージェントにページの閲覧やブラウザタスクの実行を依頼するか、ShanoneダッシュボードのインテグレーションからAPIキーを事前に登録します。
3

リクエストを再試行する

キーが保存されると、browserbase_*ツールに対するshanone_execute_toolの呼び出しが成功するようになります。

​
利用可能なツール

Shanoneは Browserbase向けに63個のツールを提供しており、以下のカテゴリに分類されています。
browserbase_create_session, browserbase_get_session, browserbase_list_sessions, browserbase_update_session, browserbase_get_session_live_urls, browserbase_get_session_logs, browserbase_get_session_replay, browserbase_create_recording_downloads, browserbase_list_recording_downloads
browserbase_page_navigate, browserbase_page_go_back, browserbase_page_go_forward, browserbase_page_get_elements, browserbase_page_click, browserbase_page_input, browserbase_page_form_fill, browserbase_page_scroll, browserbase_page_screenshot, browserbase_page_get_text, browserbase_page_get_markdown, browserbase_page_evaluate
browserbase_create_agent, browserbase_get_agent, browserbase_update_agent, browserbase_delete_agent, browserbase_list_agents, browserbase_run_agent, browserbase_get_run, browserbase_list_runs, browserbase_stop_run, browserbase_list_run_messages, browserbase_wait_for_run
browserbase_create_function, browserbase_get_function, browserbase_list_functions, browserbase_list_function_versions, browserbase_get_function_version, browserbase_get_function_build, browserbase_get_function_build_logs, browserbase_invoke_function, browserbase_get_invocation, browserbase_list_invocations
browserbase_create_context, browserbase_get_context, browserbase_update_context, browserbase_delete_context, browserbase_upload_extension, browserbase_get_extension, browserbase_delete_extension
browserbase_upload_certificate, browserbase_get_certificate, browserbase_list_certificates, browserbase_delete_certificate
browserbase_list_downloads, browserbase_get_download, browserbase_delete_download, browserbase_delete_session_downloads, browserbase_upload_file_to_session
browserbase_get_project, browserbase_list_projects, browserbase_get_project_usage, browserbase_fetch_page, browserbase_web_search

​
よくある使い方

フォーム入力の自動化

フォームに遷移し、browserbase_page_form_fillで入力して送信する

サイトコンテンツの抽出

ページを取得し、browserbase_page_get_markdownでクリーンなMarkdownとして後続処理に渡す

エンドツーエンドのエージェントタスク

複数ステップのゴール(例:「空き状況を確認して予約する」)に対してブラウザエージェントを実行し、完了までポーリングする

セッションのデバッグ & リプレイ

セッションログとリプレイ録画を取得し、自動化が失敗した原因を診断する

​
トラブルシューティング

まずbrowserbase_page_get_elementsで最新のセレクタを取得してください — 動的なページは操作の間に要素が再描画され、古いセレクタが無効になることがあります。
エージェントの実行は非同期です。完了までブロックしたい場合はbrowserbase_wait_for_runを使い、その間に他の作業をしたい場合はbrowserbase_get_runをポーリングしてください。
そのセッションに対してbrowserbase_list_downloadsでダウンロード参照を取得し、browserbase_get_downloadを使ってください — ダウンロードはセッションのアーティファクトストレージ外には自動的に永続化されません。