mcpField
H
herdr-browser

herdr-browser

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

herdr-browser について

Herdr に表示されたブラウザーを CDP 経由で操作するスキルです。Browser Use、PinchTab、Playwright などを使う際に、ビュー選択と接続を案内し、タブ操作を Herdr と同期します。

主な機能

  1. 01ブラウザービューの一覧表示と選択
  2. 02ビュー単位の CDP エンドポイント取得
  3. 03Playwright などの自動化ツール接続
  4. 04タブの作成、切り替え、終了の同期
  5. 05Chromium を終了せずクライアントを切断

活用シーン

  1. 01Playwright で Herdr ブラウザーを操作
  2. 02Browser Use または PinchTab の接続
  3. 03複数ビューから対象タブを選択
  4. 04Chromium を開いたまま自動化クライアントを終了

MCP 対応

Playwright MCP または Chrome DevTools MCP を Herdr ブラウザーに接続する方法を説明します。CDP エンドポイントを使ってブラウザービューに接続します。

インストール

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

$npx skills add https://github.com/ogulcancelik/herdr-browser --skill herdr-browser

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

詳細

Herdr Browser

ユーザーが Browser Use、PinchTab、Playwright、Chrome DevTools MCP、またはその他の CDP クライアントを使って、Herdr に表示されているブラウザーを操作したい場合に、このスキルを使用します。

herdr-browser をグローバルにインストールしないでください。次のコマンドを実行して、インストール済みまたはリンク済みのプラグインルートを特定します。

herdr plugin list --plugin official.browser --json

JSON レスポンスから result.plugins[0].plugin_root を読み取ります。任意の作業ディレクトリから Bun を使って CLI を実行します。

bun run "<plugin_root>/src/cli.ts"

接続する前に、現在のブラウザービューを一覧表示します。

bun run "<plugin_root>/src/cli.ts" views

view_id、pane_id、URL、タイトル、タブから目的のビューを選択します。ビューが複数ある場合は、決して推測しないでください。次のコマンドで接続します。

bun run "<plugin_root>/src/cli.ts" connect --view <view_id>

レスポンスには、ビューにスコープされた cdp_http_url、browser_ws_url、現在アクティブなターゲットが含まれます。自動化ツールがそのビュー内で複数のタブを作成、調査、選択、閉じられるように、ブラウザーレベルのエンドポイントを使用します。

標準 CDP の Target.createTarget、Target.activateTarget、 Page.bringToFront、Target.closeTarget 操作は、Herdr のタブストリップおよびレンダリングされたターゲットと同期します。内部の選択ページ状態だけを変更するツールは、そのページも前面に表示する必要があります。ツールのローカル状態は CDP から確認できません。

ツールのブートストラップ：

  • Browser Use：BU_CDP_URL に cdp_http_url を、または BU_CDP_WS に browser_ws_url を設定します。
  • PinchTab：外部接続ポリシーを有効にしてから、browser_ws_url または cdp_http_url にブリッジを接続します。
  • Playwright：chromium.connectOverCDP(cdp_http_url) を呼び出します。
  • Playwright MCP：--cdp-endpoint=<cdp_http_url> を渡します。
  • Chrome DevTools MCP：--browser-url=<cdp_http_url> を渡します。

Herdr Browser は Chromium のライフサイクルを管理します。接続中の自動化クライアントを閉じると、Chromium を終了せずにゲートウェイから切断されます。Herdr のブラウザーペインを閉じると、そのビューとゲートウェイが閉じます。

コメント

Markdown 対応