浏览器任务桥接 zoahdev/dsh-browser-use

dsh-browser-use

面向 DeepSeek Harness 的 Browser Use 桥接：让你的 dsh 智能体执行真实的网页任务——打开页面、点击、输入、填写表单、提取数据——通过 Browser Use Cloud API。

CI
License: MIT

它是什么

一个轻量、诚实的桥接。它注册一个面向模型的工具 browser_use_run，将任务转发到 Browser Use 的云端端点，并返回原始运行结果。它不会重新实现 Browser Use，也不会声称自己是一个完整的集成。

安装

dsh plugin --profile web add dsh-browser-use

然后设置你的 Browser Use API 密钥（配置项 apiKey，或环境变量 BROWSER_USE_API_KEY）。

两种模式：云端 vs. 本地

| 模式 | 需要 | 你能获得的工具 |
| 云端（本插件） | Browser Use API 密钥 | browser_use_run |
| 本地（免费，无需密钥） | 已安装 Python + browser-use | mcp__browser_use__browser_exec、mcp__browser_use__browser_screenshot |

本地模式（无需 Browser Use API 密钥）

Browser Use 也可以作为 MCP stdio 服务器在本地运行——无需云端订阅。
DeepSeek Harness 已经自带 @deepseek-ai/dsh-mcp-client，因此本地路径不需要本插件。安装一次 Browser Use （pip install 'browser-use[cli]'），然后将以下内容添加到你的 profile 的 cordis.yml 中：

- insert:
- id: browser-use-local
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: browser_use
transport: stdio
command: browser-use
args: ['--cli-mcp']
cwd: !!js process.cwd()

这会注册 mcp__browser_use__browser_exec 和 mcp__browser_use__browser_screenshot。一个可直接复制使用的文件位于 examples/local-mcp.cordis.yml。

工具

| 参数 | 类型 | 描述 |
| task | string | 任务，例如 "Find the stars of the browser-use repo"。 |
| model | string | 可选的带提供商前缀的模型 id，例如 openai/gpt-5.5。 |

返回 { result }——原始的 Browser Use 运行结果。

配置

| 键 | 类型 | 默认值 | 描述 |
| apiKey | string | （环境变量） | Browser Use API 密钥 |
| baseUrl | string | https://api.browser-use.com | 云端 API 基础 URL |
| timeoutMs | number | 300000 | 请求超时 |
| model | string | （无） | 默认模型 |

已验证

- pnpm typecheck · pnpm build · pnpm test（4 个测试，模拟 HTTP）。
- 已使用 @deepseek-ai/dsh-tools ^0.1.0-rc.6 测试。

诚实的局限

- 这是一个云端 API 桥接；它需要 Browser Use API 密钥。
- 本地模式由 DeepSeek Harness 自带的 mcp-client 提供，而非本包；本 README 同时记录了两种方式，以便你选择更省钱的路径。
- 它返回原始响应；不会流式传输或轮询等待完成。
- 社区插件，并非 Browser Use 或 DeepSeek 的官方产品。

给 DeepSeek Harness 的 Browser Use 桥接：让 dsh agent 通过 Browser Use 云 API 执行真实网页任务（打开页面、点击、输入、填表、抽取数据）。

注册一个 browser_use_run 工具：把任务转发给 Browser Use，返回原始运行结果。
这是薄桥接，不重新实现 Browser Use，也不冒充官方。

dsh plugin --profile web add dsh-browser-use

需要配置 Browser Use API key（apiKey 配置项，或环境变量 BROWSER_USE_API_KEY）。

两种模式：云端 vs. 本地

| 模式 | 需要 | 得到的工具 |
| 云端（本插件） | Browser Use API key | browser_use_run |
| 本地（免费，无需 key） | Python + browser-use 已安装 | mcp__browser_use__browser_exec、mcp__browser_use__browser_screenshot |

本地模式（无需 Browser Use API key）

Browser Use 也能以本地 MCP stdio 服务运行，无需云订阅。DeepSeek Harness 已经内置 @deepseek-ai/dsh-mcp-client，所以本地路径不需要本插件。先安装一次 Browser Use（pip install 'browser-use[cli]'），然后把你 profile 的 cordis.yml 加上：

- insert:
- id: browser-use-local
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: browser_use
transport: stdio
command: browser-use
args: ['--cli-mcp']
cwd: !!js process.cwd()

这会注册 mcp__browser_use__browser_exec 和 mcp__browser_use__browser_screenshot。现成可复制的文件在 examples/local-mcp.cordis.yml。