briqt/my-agent-browser

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

21 stars 2 forks 品質 70 トレンド 24

Repository Install

AIエージェントの信頼できるブラウザの自動化スキル — クロームのライフサイクル管理とワークフローのガイダンスは、クローム・デベロッパー・mcpの上部にあります.

概要

Chrome-devtools-mcp のまわりの生産準備ができたラッパー。 chrome-devtools-mcp はブラウザ MCP 用具を提供しますが、Chrome プロセス管理、複数のセッション共有および欠陥の回復を完全に残します。このプロジェクトでは、運用レイヤーを追加し、AIエージェントはブラウザを確実に使用できます。 - システム(macOS/Linux/Windows)でChromeの自動検索、Edge/Brave/Arc/Chromiumを含む10以上のパスを検索 - Lazy start — Chromeは、エージェント起動時にではなく、最初のツール/コールで起動します。複数のエージェントセッションは、ブラウザを介して1つのChromeインスタンスを共有します.

概要（AI 翻訳）

日报社**

これは、ベアクローム-devtools-mcp の上に追加するもの

##Chrome のライフサイクル管理

システム(macOS/Linux/Windows、Edge/Brave/Arc/Chromiumを含む10以上のパスを検索)でChrome自動検索
レイジースタート — エージェント起動ではなく、Chromeは最初の[tools/callで起動します
複数のエージェントセッションは、1つのChromeインスタンスを[browser.lock]で共有します。
終了までの最終セッションは自動的にクロームを閉じます
エージェントのクラッシュ後の孤児なし:親心拍検出+スタートアップ孤児プロセスクリーンアップ
WSL /ヘッドレスLinux:自動検出とDISLAY(WSLg、Wayland、X11)の設定

故障回復

CDPポートプローブによるChromeのクラッシュ検出 — エラーテキストを単独で信頼しません
確認されたクラッシュ→自動再発クロム、再航するために代理店に指示するためにMCPの応答を書き換えて下さい
MCP の stale 状態(閉鎖したタブを参照) → MCP の子プロセスだけを再起動して下さい、Chrome はとどまります

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

my-agent-browser

Production-ready wrapper around chrome-devtools-mcp. chrome-devtools-mcp provides the browser MCP tools, but leaves Chrome process management, multi-session sharing, and fault recovery entirely to you. This project adds the operational layer so AI agents can use the browser reliably.

中文文档

What this adds over bare chrome-devtools-mcp

Chrome Lifecycle Management

Auto-find Chrome on your system (macOS/Linux/Windows, searches 10+ paths including Edge/Brave/Arc/Chromium)
Lazy start — Chrome only launches on first tools/call, not at agent startup
Multiple agent sessions share one Chrome instance via browser.lock reference counting
Last session to exit automatically closes Chrome
No orphans after agent crash: parent heartbeat detection + startup orphan process cleanup
WSL / headless Linux: auto-detect and configure DISPLAY (WSLg, Wayland, X11)

Fault Recovery

Chrome crash detection via CDP port probe — never trusts error text alone
Confirmed crash → auto-relaunch Chrome, rewrite MCP response to tell agent to re-navigate
MCP stale state (referencing closed tab) → restart only the MCP child process, Chrome stays
Profile lock leftover (SingletonLock after hard kill) → auto-clean before launch

Config-driven + Anti-detection

Headless mode, proxy, viewport size, custom launch args — all Chrome startup flags configurable
evaluate_script stack traces are stripped of the pptr: marker and the MCP install path (which normally leaks your OS username) — measured against a site-origin trap, see anti-detection.md
Flag recommendations backed by one-flag-at-a-time measurements rather than folklore
Direct connection to existing Chrome (browserUrl mode, for pre-authenticated long-lived sessions)
Opt-in background tabs via mcp.backgroundNewPages (default false), preserving explicit per-call choices

Agent Workflow Guidance (SKILL.md)

Heavy pages: file-based snapshots to prevent DOM overflow crashes
Error recovery: stale UIDs, timeouts, Chrome restart — correct response for each
Multi-tab: open/extract/close pattern, UID isolation between tabs
Scraping: URL-based pagination, lazy-load triggering, JS extraction
Login flows: persistent profile, automated credentials, connect to existing session

Install

npx skills add briqt/my-agent-browser -g -y
npm install -g [email protected]
mkdir -p ~/.config/agent-skills/my-agent-browser
cp ~/.agents/skills/my-agent-browser/config.example.json ~/.config/agent-skills/my-agent-browser/config.json

Then register the MCP server in your agent:

Claude Code

claude mcp add browser -s user -- node ~/.agents/skills/my-agent-browser/scripts/start-mcp.js

GitHub で README 全文を見る

インストール

npx skills add briqt/my-agent-browser -g -y

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "browser": {
      "command": "node",
      "args": ["~/.agents/skills/my-agent-browser/scripts/start-mcp.js"]
    }
  }
}