agent-browser

セレクタ

Refs（推奨）

Refs はスナップショットから確定的な要素選択を提供します。AIエージェントに最適です。

# 1. Ref を使ってスナップショットを取得
agent-browser snapshot
# 出力:
# - ヘディング "Example Domain" [ref=e1] [level=1]
# - ボタン "Submit" [ref=e2]
# - テキストボックス "Email" [ref=e3]
# - リンク "Learn more" [ref=e4]

# 2. Ref を使って操作を行う
agent-browser click @e2                   # ボタンをクリック
agent-browser fill @e3 "[email protected]" # テキストボックスに入力
agent-browser get text @e1                # ヘディングのテキストを取得
agent-browser hover @e4                   # リンクのホバー

Ref が推奨される理由

  • 確定的 - スナップショットからの正確な要素への参照
  • 高速 - 再度 DOM クエリが必要ない
  • AI 向け - LLM が確実に解析・使用できる

CSS セレクタ

agent-browser click "#id"
agent-browser click ".class"
agent-browser click "div > button"
agent-browser click "[data-testid='submit']"

テキスト & XPath

agent-browser click "text=Submit"
agent-browser click "xpath=//button[@type='submit']"

意味論的ロケータ

役割、ラベル、その他の意味論的プロパティに基づいて要素を検索します：

agent-browser find role button click --name "Submit"
agent-browser find label "Email" fill "[email protected]"
agent-browser find placeholder "Search..." fill "query"
agent-browser find testid "submit-btn" click