Repolode
Submit
DDDMUC

DDDMUC/dsh-free-search

A DeepSeek Harness plugin that adds free, key-less web search via DuckDuckGo, Bing and other engines, with automatic fallback between them.

View on GitHub
Stars
542
Forks
41
Open issues
10
Last commit
yesterday

What is it?

dsh-free-search is a plugin for DeepSeek Harness (dsh) that registers a web search provider. It addresses the case where dsh's default search depends on an official DeepSeek API key, or runs through a gateway that does not support the web_search tool, leaving the agent unable to search. The plugin offers free engines such as DuckDuckGo, Bing and SearXNG that need no key, along with many paid and keyed engines.

Engines can be switched from a settings page, from the /free-search-engine chat command, or by asking the agent to test them. When an engine fails, the plugin classifies the failure (quota, auth, rate limit, parse error) and falls back to the next engine, cooling down engines that are out of quota or misconfigured. Results can be merged across engines in a multi-search mode, filtered by time range, and blocked by domain.

The plugin also adds tools for platform-specific search (GitHub, Reddit, Hacker News, Stack Overflow and others), vertical lookups in keyless academic, package and finance sources, page fetching, and a research tool that gathers sourced evidence in one call. It is MIT licensed and is installed with the dsh plugin command.

Key features

  • 01Free engines (DuckDuckGo, Bing, SearXNG, AnySearch) work without any API key
  • 02Automatic fallback across engines with failure classification and temporary cooldowns
  • 03Settings page and /free-search-engine command for switching engines and managing keys
  • 04Multi-search mode that queries a language pool of engines concurrently and merges results
  • 05Time-range filtering, domain blocklist and safe-search options
  • 06Platform search and keyless vertical lookups for developer, academic and finance sources

Use cases

  • Giving a DeepSeek Harness agent web search without a DeepSeek official key
  • Running dsh through a gateway whose endpoint lacks the web_search tool
  • Searching recent news with a time filter such as the last three days
  • Cross-checking a question across several engines before trusting an answer

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/DDDMUC/dsh-free-search.git
  2. 2

    Install the plugin into your DSH profile

    dsh plugin --profile web add /path/to/dsh-free-search
  3. 3

    Restart DSH web

    dsh web

Things to know

  • Depends on the DeepSeek Harness (dsh) runtime; it is a plugin, not a standalone search tool.
  • Free engines such as DuckDuckGo may be rate-limited or blocked by anti-bot measures.
  • Requires manual cleanup of the provider config line before uninstalling, or searches will fail.

Topics

#web-search#duckduckgo#bing#deepseek#plugin#free-api#search-aggregator#deepseek-harness#dsh#dsh-plugin

FAQ

What is dsh-free-search?
A DeepSeek Harness plugin that adds free, key-less web search via DuckDuckGo, Bing and other engines, with automatic fallback between them. dsh-free-search is a plugin for DeepSeek Harness (dsh) that registers a web search provider. It addresses the case where dsh's default search depends on an official DeepSeek API key, or runs through a gateway that does not support the web_search tool, leaving the agent unable to search. The plugin offers free engines such as DuckDuckGo, Bing and SearXNG that need no key, along with many paid and keyed engines.
Is dsh-free-search free to use? What license does it have?
dsh-free-search is open source under the MIT license. Check the license terms before using it in commercial products.
Is dsh-free-search still maintained?
Actively maintained. The last commit to dsh-free-search was on Oct 20, 2026.
What can I use dsh-free-search for?
Giving a DeepSeek Harness agent web search without a DeepSeek official key Running dsh through a gateway whose endpoint lacks the web_search tool Searching recent news with a time filter such as the last three days Cross-checking a question across several engines before trusting an answer
How do I install dsh-free-search?
Clone the repository: git clone https://github.com/DDDMUC/dsh-free-search.git Install the plugin into your DSH profile: dsh plugin --profile web add /path/to/dsh-free-search Restart DSH web: dsh web
Where can I get dsh-free-search?
The source code and installation instructions are on GitHub: https://github.com/DDDMUC/dsh-free-search

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects