mcpField
A
agent-browser-ios

agent-browser-ios

github.com/owenleezyエージェントワークフロー456 回インストール31 週間前に更新
リポジトリ

agent-browser-ios について

iOS Simulatorのアプリをagent-browserで操作するエージェント向けスキルです。環境準備や端末操作のパターン、iOS特有の注意点を説明します。

主な機能

  1. 01iOSシミュレーターの起動と一覧表示
  2. 02tapとswipeによるネイティブ操作
  3. 03アクセシビリティツリーとWebViewの確認
  4. 04シミュレーター画面のキャプチャ

活用シーン

  1. 01iOS Simulatorでブラウザータスクを実行
  2. 02タッチ操作でネイティブ画面を移動
  3. 03Web Inspector有効化後のWebView確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/owenleezy/agent-browser-skill --skill agent-browser-ios

インストール後、Claude Code で/agent-browser-iosを入力して読み込まれたか確認します。

詳細

Agent Browser — iOS Simulator

内部テンプレート。 エントリーポイント：agent-browser スキル。

推奨設定： agent-browser -p ios（--provider ios の短縮形）

NEVER

NEVER run commands before Simulator is booted — daemon can't connect; boot first with xcrun simctl
NEVER use `scroll` on iOS — use `swipe up` / `swipe down` instead
NEVER use `click` on native touch targets — prefer `tap @ref` for iOS elements
NEVER copy element refs across navigations — re-run `snapshot -i` after every screen change
NEVER assume WebView content is inspectable — must enable Web Inspector in Safari → Develop → [device]

前提条件

iOS Simulator を使用するには、次のものが必要です。

  1. macOS（Apple Silicon または Intel）
  2. iOS Simulator を含む Xcode — Mac App Store からインストールします
  3. Appium — npm install -g appium && appium driver install xcuitest
  4. agent-browser を起動する前に、Simulator が Xcode で起動している必要があります
# Verify prerequisites
xcodebuild -version         # Xcode installed?
appium --version            # Appium installed?
appium driver list --installed   # XCUITest driver present?

環境の確認

printenv | grep AGENT_BROWSER   # already set? Omit the corresponding inline flag

ワークフロー

# 1. Start Simulator in Xcode first (or via xcrun)
xcrun simctl boot "iPhone 15 Pro"
open -a Simulator

# 2. List available simulators
agent-browser -p ios device list

# 3. Open app in simulator
agent-browser -p ios --device "iPhone 15 Pro" open https://app.example.com

# 4. Explore interactive elements
agent-browser -p ios snapshot -i

# 5. iOS-native gestures
agent-browser -p ios tap @e1
agent-browser -p ios swipe up           # scroll up
agent-browser -p ios swipe down         # scroll down
agent-browser -p ios swipe left         # swipe carousel / delete row
agent-browser -p ios swipe right        # go back (swipe edge)

# 6. Standard commands work too
agent-browser -p ios screenshot --full ios-result.png
agent-browser -p ios find role button click --name "Submit"
agent-browser -p ios get text @e3
agent-browser -p ios wait --load networkidle

主なパターン

パターンコマンド
Simulator の一覧表示agent-browser -p ios device list
特定のデバイスを指定-p ios --device "iPhone 15 Pro"
iOS でスクロールswipe up / swipe down（scroll ではありません）
iOS でタップtap @e1（タッチ対象には click より推奨）
戻るswipe right（画面端からのスワイプ）
ボトムシートを閉じるswipe down
証跡用スクリーンショットを撮影screenshot --full ios-result.png
DOM を調査（WebView）snapshot -i（WKWebView 内のウェブコンテンツ用）

iOS でも使用できる Chrome コマンド

次の標準コマンドは -p ios で使用できます。

  • open <url> — 移動
  • snapshot / snapshot -i — アクセシビリティツリー
  • find role button click --name "..." — セマンティックロケーター
  • get text @e1 / get value @e1
  • screenshot [path] / screenshot --full
  • wait @e1 / wait --load networkidle
  • is visible @e1 / is enabled @e1
  • errors / console（WebView のコンテンツ用）

注意点

間違い解決策
実行前に Simulator を起動していない先に Xcode で Simulator を起動するか、xcrun simctl boot "iPhone 15 Pro" を実行します
Appium がインストールされていないnpm install -g appium && appium driver install xcuitest
swipe ではなく scroll を使用しているiOS では scroll ではなく swipe up / swipe down を使用します
タッチ専用要素に click を使用しているネイティブのタッチ対象には tap @e1 を推奨します
device list にデバイスが表示されないSimulator が起動していません — Xcode → Simulators を開いて起動します
XCUITest ドライバーが見つからないappium driver install xcuitest
WebView のコンテンツを調査できないSafari → Develop → [device name] で「Web Inspector」を有効にします

コメント

Markdown 対応