mcpField
B
browse

browse

github.com/topshark-jimエージェントワークフロー054 回インストール33 週間前に更新
リポジトリ

browse について

browse は `agent-browser` を使ったブラウザー自動化向けのエージェントスキルです。明示的なコマンド手順に沿って、ページの確認や操作を行えます。

主な機能

  1. 01ブラウザーセッションの操作と管理
  2. 02ページ読み込み完了の待機
  3. 03インタラクティブスナップショットでの確認
  4. 04スナップショット参照を使った操作
  5. 05コンソール、エラー、通信リクエストの確認

活用シーン

  1. 01ウェブサイトの移動と操作の自動化
  2. 02セレクターが不明なページの内容確認
  3. 03ブラウザー診断情報を使った問題調査

インストール

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

$npx skills add https://github.com/topshark-jim/gstack --skill browse

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

詳細

browse

ブラウザーの自動化には agent-browser を直接使用してください。コマンドは明示的に記述し、2 つ目のラッパーレイヤーを追加するのではなく、組み込みのセッションモデルを優先してください。

要件

  • agent-browser が PATH 上で利用できる必要があります。
  • ブラウザーバイナリが見つからない場合は、agent-browser install を実行してください。
  • 分離が必要な場合を除き、デフォルトのセッションを再利用してください。ワークフローが完了したら、agent-browser close でセッションを閉じてください。

デフォルトのフロー

agent-browser open https://example.com
agent-browser wait --load networkidle
agent-browser snapshot -i

セレクターが不明確な場合は snapshot -i を使用し、スナップショットの出力にある @ref ターゲットを操作してください。

コマンド一覧

# Open or navigate
agent-browser open https://example.com
agent-browser back
agent-browser forward
agent-browser reload

# Inspect content
agent-browser get title
agent-browser get url
agent-browser get text body
agent-browser get html main
agent-browser snapshot -i

# Interact
agent-browser click @e3
agent-browser fill @e4 "[email protected]"
agent-browser type @e5 "hello"
agent-browser press Enter
agent-browser select @e6 option-a
agent-browser upload @e7 /tmp/file.png
agent-browser wait @e8

# Visual checks
agent-browser screenshot /tmp/page.png
agent-browser screenshot --full /tmp/page-full.png
agent-browser pdf /tmp/page.pdf

# Debugging
agent-browser console
agent-browser errors
agent-browser network requests
agent-browser eval "document.title"

# State and tabs
agent-browser cookies get
agent-browser storage local get
agent-browser tab new
agent-browser tab list
agent-browser tab 2
agent-browser close

作業ルール

  • ナビゲーションが多い手順の後は、wait --load networkidle を優先してください。
  • ページが CSS セレクターを使えるほど安定していない場合は、click、fill、または select の前に snapshot -i を使用してください。
  • ページが壊れていると結論づける前に、console、errors、network requests を確認してください。
  • 永続的なログインやブラウザープロファイルが必要な場合は、--profile <path> を使用してください。
  • 同じタスクでブラウザーコンテキストを分ける必要がある場合は、--session <name> を使用してください。
  • agent-browser が見つからない場合は、続行する前にインストール方法をユーザーに正確に伝えてください。

コメント