mcpField
H
herdr-browser

herdr-browser

github.com/ogulcancelikAgent 工作流36040 次安装10 周前更新
代码仓库

关于 herdr-browser

Herdr Browser 技能用于通过 CDP 控制 Herdr 中显示的浏览器，适用于 Browser Use、PinchTab、Playwright 等自动化工具。它要求先识别浏览器视图，再连接对应端点，并与 Herdr 标签页状态同步。

主要功能

  1. 01列出并选择浏览器视图
  2. 02获取视图级 CDP 连接端点
  3. 03连接 Playwright 等自动化工具
  4. 04同步标签页创建、切换与关闭
  5. 05断开客户端而不终止 Chromium

适用场景

  1. 01让 Playwright 控制 Herdr 浏览器
  2. 02将 Browser Use 或 PinchTab 接入浏览器
  3. 03在多个视图中选择目标标签页
  4. 04关闭自动化客户端并保留 Chromium

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