dsh-searxng

Unofficial SearXNG search-provider plugin for DeepSeek Harness (DSH), independently maintained by xoykor. It lets DSH route web-search requests through a self-hosted SearXNG instance instead of depending on a proprietary search provider. Not affiliated with or endorsed by DeepSeek.

The plugin registers a searxng provider with DSH's web service and sends searches to a configurable SearXNG instance. The default endpoint is http://127.0.0.1:8888.

Architecture

DSH web service
    |
    v
dsh-searxng provider
    |
    v
SearXNG JSON endpoint
    |
    v
normalized search results

The adapter is intentionally small: it does not launch SearXNG, manage its configuration or proxy arbitrary traffic.

Requirements

• DeepSeek Harness with the web service available.
• A reachable SearXNG instance.
• JSON output enabled on the SearXNG server.

The plugin does not install or launch SearXNG.

Installation

Clone the repository and add it to the desired DSH profile:

git clone https://github.com/xoykor/dsh-searxng.git
cd dsh-searxng
dsh plugin --profile web add "$(pwd)"

Inspect cordis.patch.yml and the effective profile configuration before restarting DSH. Select searxng as the web-search provider if necessary.

The loader's baseURL option can point to a different SearXNG endpoint. maxResults is sent as a server hint; this adapter does not guarantee a client-side result cap or detect server-side truncation.

Configuration

The provider defaults to:

http://127.0.0.1:8888

The loader's baseURL option can point to another reachable SearXNG instance. The server must have JSON output enabled. maxResults is forwarded as a hint; the adapter does not guarantee that every SearXNG deployment will enforce the same result count.

Tests

With a recent Node.js version:

npm test

The tests mock HTTP transport and cover provider registration, query encoding, result mapping, HTTP failures and cancellation. They are not a live SearXNG end-to-end certification.

Provenance

Originally extracted from xoykor's DSH configuration/backup and subsequently published as a standalone plugin. Maintained with AI-assisted development and review.

License

GNU General Public License v3.0. See LICENSE.