agent-browser について
agent-browser は、エージェント向けのブラウザー自動化スキルです。ページ移動、スナップショット、要素参照による操作を軸に、コマンドガイドやフォーム、認証、コンテンツ取得のテンプレートも提供します。
主な機能
- 01ページ移動と確認
- 02要素参照による操作
- 03ページ変更後の参照更新
- 04セッションと認証のガイド
- 05再利用可能な自動化テンプレート
活用シーン
- 01フォーム送信の自動化
- 02認証済みブラウザー状態の再利用
- 03スクリーンショット付きコンテンツ取得
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hjewkes/ agent-skills --skill agent-browserインストール後、Claude Code で/agent-browserを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/authentication.mdcommands.mdcommon-patterns.mdjavascript-evaluation.mdproxy-support.mdsemantic-locators.mdsession-management.mdsnapshot-refs.mdvideo-recording.mdtemplates/authenticated-session.shcapture-workflow.shform-automation.sh詳細
agent-browser によるブラウザー自動化
基本的なワークフロー
ブラウザー自動化はすべて、次のパターンに従います。
- 移動:
agent-browser open <url> - スナップショット:
agent-browser snapshot -i(@e1、@e2などの要素参照を取得します) - 操作:参照を使ってクリック、入力、選択を行います
- 再スナップショット:移動または DOM の変更後に、新しい参照を取得します
agent-browser open https://example.com/form
agent-browser snapshot -i
# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "password123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i # Check result
基本的なコマンド
# Navigation
agent-browser open <url> # Navigate
agent-browser close # Close browser
# Snapshot
agent-browser snapshot -i # Interactive elements with refs (recommended)
agent-browser snapshot -i -C # Include cursor-interactive elements
# Interaction (use @refs from snapshot)
agent-browser click @e1 # Click
agent-browser fill @e2 "text" # Clear and type
agent-browser select @e1 "option" # Select dropdown
agent-browser check @e1 # Checkbox
agent-browser press Enter # Key press
# Wait
agent-browser wait @e1 # Wait for element
agent-browser wait --load networkidle # Wait for network idle
# Capture
agent-browser screenshot # Screenshot
agent-browser screenshot --full # Full page
参照のライフサイクル(重要)
参照(@e1、@e2 など)は、ページが変更されると無効になります。ページ移動を伴うリンクやボタンのクリック、フォームの送信、動的コンテンツの読み込み後は、必ずスナップショットを再取得してください。
詳細ドキュメント
| リファレンス | 使用する場面 |
|---|---|
| references/commands.md | すべてのオプションを含むコマンドの完全なリファレンス |
| references/snapshot-refs.md | 参照のライフサイクル、無効化のルール、トラブルシューティング |
| references/session-management.md | 並列セッション、状態の永続化、並行スクレイピング |
| references/authentication.md | ログインフロー、OAuth、2FA の処理、状態の再利用 |
| references/video-recording.md | デバッグとドキュメント作成のためのワークフローの記録 |
| references/proxy-support.md | プロキシの設定、地域テスト、ローテーションプロキシ |
| references/common-patterns.md | フォーム送信、認証、データ抽出、並列セッション、iOS シミュレーター |
| references/semantic-locators.md | 参照の代替手段 |
| references/javascript-evaluation.md | eval のルール、--stdin/-b の説明 |
すぐに使えるテンプレート
| テンプレート | 説明 |
|---|---|
| templates/form-automation.sh | 検証を含むフォーム入力 |
| templates/authenticated-session.sh | 一度ログインして、状態を再利用 |
| templates/capture-workflow.sh | スクリーンショットを使ったコンテンツ抽出 |
コメント
Markdown 対応