Introduction

The plugin ecosystem of DeepSeek Harness (DSH) emphasizes “everything is a plugin,” and the community directory is an independent site with no official affiliation to DeepSeek / HuiFang. For DSH users, web search does not necessarily have to go through the built-in web_search tool chain. dsh-web-search-provider provides an alternative path: using the provider’s server-side search capabilities.

What is it

dsh-web-search-provider is maintained by hiyms and uses the MIT license. It provides web search support for DeepSeek Harness based on the provider’s server-side search capabilities.

To use it, the following conditions must be met:

  • The model provider uses the OpenAI Responses API or Anthropic-compatible Messages API
  • The provider itself provides web search capability

It is not implemented through DSH’s built-in web_search tool, so it can be used simultaneously with other web search provider plugins. Under the OpenAI Responses API, it can also directly view or search URL page content.

Installation and Usage

First, install the plugin:

dsh plugin add dsh-web-search-provider

If installing from source, you can run:

pnpm install

Then, reference the plugin in the cordis.yml overlay:

- insert:
    - id: web-search-provider
      name: 'dsh-web-search-provider'
      config:
        enabled: true
        probe: true

The configuration above enables the plugin and turns on probe.

Configuration

The configuration section is web-search-provider. The following items can be set:

  • enabled: Enable or disable plugin capability
  • providers: Provider whitelist
  • baseURL: Endpoint override
  • model: Model override
  • apiKeyEnv: API key override
  • includeSources, stripServerTools, idleTimeoutMs, probe, probeTimeoutMs: Request, timeout, and probing related configurations

Typical Usage

Below are a few points to confirm before using.

  • It is recommended to prioritize providers using the OpenAI Responses API, as they additionally support viewing or searching URL page content.
  • If the provider uses the Response API / Message API but does not provide web search capability, the first use of the session might result in an error; DSH will continue to work without this plugin capability.
  • When the model uses this plugin’s web search capability, there may be no visible search-call UI, or it may appear as a continuous thinking segment.
  • Some model providers may charge extra for web search capabilities; confirm the billing method before use.
  • DSH’s built-in OpenCode Go provider uses different API types for different models; to use this plugin capability, you may need to manually add custom providers of the Response / Message API types.

Security and Checks

This plugin runs with the permissions of the current dsh process. Before installing, it is recommended to check the source code and the MIT license to ensure that the scope of configuration, credentials, and requests sent is as expected.

Links

  • GitHub: https://github.com/hiyms/dsh-web-search-provider
  • Community Directory: The URL is not specified in this article; you can search for it in the DSH plugin directory using the plugin name dsh-web-search-provider.