agent-browser は何をしますか？
Rustベースの高速なヘッドレスブラウザ自動化CLI（Node.jsフォールバック付き）で、AIエージェントが構造化コマンドを介してページのナビゲート、クリック、タイピング、スナップショットを実行できます。
概要
このツールは、AIエージェントがブラウザ操作を自動化するためのコマンドラインインターフェースを提供します。Rustで実装された高速なヘッドレスブラウザ制御に加え、Node.jsが利用できない環境でも動作するフォールバックメカニズムを備えています。
サポートプラットフォーム
- Claude Code
- Cursor
- Codex
- その他のAIエージェントプラットフォーム
インストール
# Rust版のインストール
cargo install agent-browser
# Node.js版のインストール（フォールバック用）
npm install -g agent-browser
使用方法
以下の構造化コマンドを使用してブラウザを自動操作します。
コマンド一覧
| コマンド | 説明 |
|---|---|
navigate <url> | 指定されたURLに移動します |
click <selector> | CSSセレクタで指定された要素をクリックします |
type <selector> <text> | 指定された要素にテキストを入力します |
snapshot [selector] | 現在のページ（または指定要素）のスクリーンショットを取得します |
eval <js> | ページコンテキストでJavaScriptを実行します |
例
# Googleに移動
agent-browser navigate https://www.google.com
# 検索ボックスにテキストを入力
agent-browser type 'input[name="q"]' 'AI agent'
# 検索ボタンをクリック
agent-browser click 'input[type="submit"]'
# 結果のスクリーンショットを取得
agent-browser snapshot
フォールバック動作
デフォルトではRust実装が使用されますが、Rustが利用できない環境では自動的にNode.js実装にフォールバックします。これにより、環境に依存せず一貫した動作が保証されます。
環境変数
| 変数名 | 説明 |
|---|---|
BROWSER_ENGINE | 使用するブラウザエンジン（chromium/firefox/webkit）を指定します |
HEADLESS | ヘッドレスモードを有効/無効にします（true/false） |
TIMEOUT | 各操作のタイムアウト時間（ミリ秒）を設定します |
注意事項
- このツールはヘッドレスモードで動作するため、画面表示なしで操作が可能です。
- 一部のWebサイトでは自動化ツールとして検出される場合があります。
- JavaScriptの実行により、ページの状態を動的に変更できます。
ライセンス
MIT