# dsh-browser-use

> Browser Use bridge for DeepSeek Harness: let your `dsh` agent run real web tasks — open pages, click, type, fill forms, extract data — through the [Browser Use](https://github.com/browser-use/browser-use) Cloud API.

[![CI](https://github.com/zoahdev/dsh-browser-use/actions/workflows/ci.yml/badge.svg)](https://github.com/zoahdev/dsh-browser-use/actions)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

English | [中文](#中文)

## What it is

A thin, honest bridge. It registers one model-facing tool, `browser_use_run`,
forwards the task to Browser Use's cloud endpoint, and returns the raw run
result. It does **not** reimplement Browser Use and does **not** claim to be a
full integration.

## Install

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

Then set your Browser Use API key (config `apiKey`, or the `BROWSER_USE_API_KEY`
env var).

## Tool

| Parameter | Type | Description |
| --- | --- | --- |
| `task` | string | The task, e.g. "Find the stars of the browser-use repo". |
| `model` | string | Optional provider-prefixed model id, e.g. `openai/gpt-5.5`. |

Returns `{ result }` — the raw Browser Use run result.

## Config

| Key | Type | Default | Description |
| --- | --- | --- | --- |
| `apiKey` | string | *(env)* | Browser Use API key |
| `baseUrl` | string | `https://api.browser-use.com` | Cloud API base URL |
| `timeoutMs` | number | `300000` | Request timeout |
| `model` | string | *(none)* | Default model |

## Verified

- `pnpm typecheck` · `pnpm build` · `pnpm test` (4 tests, mocked HTTP).
- Tested with `@deepseek-ai/dsh-tools ^0.1.0-rc.6`.

## Honest limits

- This is a cloud-API bridge; it needs a Browser Use API key.
- It returns the raw response; it does not stream or poll for completion.
- Community plugin, not an official Browser Use or DeepSeek product.

---

# 中文

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

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

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

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