mcpField
U
use-my-browser

use-my-browser

github.com/xixu-meエージェントワークフロー79505.7k 回インストール3 日前に更新
リポジトリ

use-my-browser について

use-my-browser は、必要な根拠に応じてブラウザー操作か静的取得かを選ぶためのエージェント向けスキルです。操作前にライブブラウザーの機能を確認し、タスク別の手順や資料を参照します。

主な機能

  1. 01静的取得とブラウザー必須タスクの分類
  2. 02ライブブラウザー機能の確認
  3. 03タスク別手順の読み込み
  4. 04再利用可能なサイトパターンの管理

活用シーン

  1. 01ページの可視状態が必要かを判断
  2. 02ログインページで保存や公開を実行
  3. 03iframe、Shadow DOM、反自動化の問題を調査

インストール

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

$npx skills add https://github.com/xixu-me/skills --skill use-my-browser

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
README.zh.md
references/
anti-automation-friction.md
browser-capability-matrix.md
browser-playbook.md
browser-recovery.md
control-plane-workflows.md
debug-handoff.md
deep-dom.md
media-inspection.md
parallel-browser-ownership.md
selector-bridge.md
task-routing.md
references/site-patterns/
README.md

詳細

このスキルを汎用的なブラウジングの既定として扱わないでください。ツールの好みではなく、必要な証拠に基づいて経路を選択してください。

経路を選ぶ前に、すべてのタスクを分類する必要があります。

  • static-capable：ライブブラウザーの状態、目に見える確認、ページ操作がなくても証拠を提示できます
  • browser-required：レンダリングされた状態、操作、ライブセッションの動作、ブラウザー専用の構造に証拠が依存します

静的な取得、curl、その他のブラウザーを使わない経路に切り替えられるのは、static-capable のタスクだけです。タスクが browser-required に分類されたら、ブラウザーの経路を維持し、機能が不足している場合は、暗黙に別の経路へ切り替えず blocked としてください。

前提条件の確認

このスキルは、別途新しい自動化ブラウザーを起動するためではなく、ユーザーのライブブラウザーセッション内で作業するためのものです。ブラウザー自動化を行う前に、タスクに必要な機能（ページ一覧の取得、タスク専用ページの作成、ページ選択、スナップショットまたは表示状態の読み取り、DOM の調査、テキストやフォームへの入力、アップロード、ダイアログの操作、コンソールの確認、ネットワークの調査など）を提供できるライブブラウザースタックに、環境がすでにアクセスできることを確認してください。スタックの種類は問いません。ブランドではなく、機能を確認してください。

ライブブラウザースタックを利用できない場合、このスキルを使ったブラウザー自動化は試みないでください。静的な取得に切り替えられるのは static-capable の作業だけです。

ライブブラウザーでの自動化は、一部のサイトでボット対策や自動化対策を引き起こす可能性があります。本当に必要な場合にのみブラウザーを操作し、必要な証拠を得た後は、不必要に同じ操作を繰り返さないでください。

経験のループ

サイトのパターンは、任意の参考情報ではなく、ブラウザープロトコルの一部として扱ってください。

browser-required の作業では、次のループを実行してください。

  1. 対象ドメインが判明したらすぐに、references/site-patterns/ に該当するメモがすでにあるか確認してください。
  2. メモがある場合、そのドメインで最初に重要なブラウザー操作を行う前に読んでください。
  3. 実行中は、今後の実行方法を変えるような、検証済みのサイト固有の事実に注意してください。
  4. タスクを完了とする前に、今回の実行で再利用可能な事実が得られたか、既存の事実が否定されたか、再利用可能なサイト固有の学びが得られなかったかを判断してください。
  5. 再利用可能な事実を確認した場合、または既存の主張を否定した場合は、終了前に該当するメモを更新してください。

一度限りのノイズを理由に、ドメインのメモを作成しないでください。タスク自体が成功した場合でも、実行後の振り返りを省略しないでください。

次のいずれかを確認した場合は、書き戻しが必要です。

  • 安定したルートの形式、または必須のクエリパラメーター
  • ログイン、セッションの継承、または isolatedContext の特性
  • ホバー、キーボード入力、アップロードの順序、セレクターブリッジのパターンなど、信頼できる操作方法
  • 手動で組み立てた URL は信頼できない一方、DOM で生成されたリンクは信頼できるドメイン
  • 予測可能な自動化対策の摩擦、または誤解を招くプラットフォームのエラー状態
  • 再利用可能なメディア抽出、または iframe／Shadow DOM へのアクセス方法

判断ガイド

ツールではなく、目的の結果から始めましょう。ユーザーの目標を明確にし、何をもって完了とするかを定め、必要な証拠を得られる範囲で最もコストの低い方法を選びます。

次の順序で振り分けてください。

  1. タスクが static-capable か browser-required かを判断します。
  2. タスクが static-capable の場合は、references/task-routing.md を読み込み、証拠の目標を満たせる範囲で最もコストの低い方法を選びます。
  3. タスクが browser-required の場合は、references/browser-playbook.md を読み込みます。
  4. 新しいホストセッションでブラウザー必須の機能が不確かな場合は、references/browser-capability-matrix.md も読み込みます。
  5. ユーザーが、選択中のインスペクター要素やネットワークリクエストなど、すでにアクティブなブラウザーデバッグコンテキストを持っている場合は、references/debug-handoff.md も読み込みます。
  6. ブラウザー必須のタスクが、ログイン済みのダッシュボード、管理画面、CMS、エディター、または保存／公開／更新のフローに関係する場合は、references/control-plane-workflows.md も読み込みます。
  7. 現在の失敗の様子から、ソフト 404、コンテンツ利用不可の状態、疑わしい無反応な操作、認証の壁、レート制限、または自動化対策が疑われる場合は、references/anti-automation-friction.md も読み込みます。
  8. ブラウザー必須のタスクに iframe、Shadow DOM、折りたたまれたコンテンツ、または遅延読み込みされる証拠が含まれる場合は、references/deep-dom.md も読み込みます。
  9. 重要な証拠が画像、音声クリップ、または動画に含まれている場合は、references/media-inspection.md も読み込みます。
  10. ブラウザー作業を、独立したページ担当者またはサブエージェントに分担できる場合は、references/parallel-browser-ownership.md も読み込みます。
  11. 信頼できるセレクターはすでに分かっているものの、MCP ネイティブな uid ターゲットが必要な場合は、references/selector-bridge.md も読み込みます。
  12. ページ操作後の状態が曖昧な場合、ページが予期せず移動した場合、古い uid が無効になった可能性がある場合、または次のブラウザー操作を判断するためにコンソール／ネットワークの調査が必要になった場合は、references/browser-recovery.md も読み込みます。
  13. 対象サイトに対応するドメイン別のメモが references/site-patterns/ にある場合は、そのサイトを操作する前にメモを読みます。

以下は、デフォルトで browser-required として扱います。

  • localhost、127.0.0.1、またはベンチマーク形式のローカルフィクスチャ
  • アップロード、ダウンロード、ドラッグ＆ドロップ、ホバー、キーボードによるネイティブ入力、または目に見える確認状態
  • 同一オリジンの iframe の調査、Shadow DOM の調査、details／折りたたまれた証拠、または遅延読み込みされるコンテンツ
  • 「ページに表示されている内容」自体が証拠となるタスク

一般的なタスクの通常の手順では、このエントリーポイントに加えて参照資料を 1 つか 2 つ読み込めば十分です。参照資料一式すべてを読む必要はありません。

厳守事項

  • ライブブラウザーの状態が証拠の一部である場合、または必要な操作を行う場合に限り、ブラウザーを操作してください。
  • タスクがいったん browser-required になったら、黙って別の方法に切り替えないでください。
  • このファイルをエントリーポイントとして扱い、各参照ファイルは単一の目的を持つ権威ある情報源として扱ってください。ルールを重複して記載しないでください。
  • 参照ファイルの読み込みは1階層にとどめてください。別の参照ファイルを参照先につなぐハブにするのではなく、このエントリーポイントから次に読むファイルを判断してください。
  • ページが制限されているように見えるだけで、ユーザーにログインを求めないでください。まず、対象のコンテンツや操作が実際にブロックされているかを確認してください。
  • ページが想定する経路を示した後は、手動で構築した URL より、サイトが生成した DOM リンクを優先してください。
  • タスクが本当にブラウザー内での操作を必要とする場合は、スクリプトによる操作より MCP ネイティブの操作を優先してください。
  • 自分が開いたページのみ閉じてください。
  • アグリゲーターや、繰り返し引用される二次報道より、一次情報源を優先してください。
  • 該当するサイトパターンのメモがある場合は、そのドメインで最初の重要なブラウザー操作を行う前に読んでください。
  • browser-required のタスクを完了する前に、サイトパターンの主張を新規作成、更新、格下げ、削除すべきかを明示的に確認してください。
  • 既存のサイトパターンの主張が同等の条件で機能しない場合は、それを信頼するのをやめ、一般的なワークフローに戻り、古くなった前提を再試行するのではなく、メモを更新してください。
  • browser-required のタスクでは、curl、Invoke-WebRequest、またはシェルによる HTTP 取得を使用しないでください。
  • 汎用的なページを開くツールを、localhost での深い操作が可能である証拠として扱わないでください。
  • ブラウザー機能の確認に失敗したという理由だけで、別の経路に切り替えないでください。利用できない機能を記録し、そこで停止してください。
  • ユーザーが現在進行中のブラウザーデバッグのコンテキストを示している場合は、ゼロから新たに再現するのではなく、その現在のコンテキストから引き継ぐことを優先してください。

参照インデックス

コメント

Markdown 対応