delef/dsh-free-web-search

项目介绍Project Overview

这是 DeepSeek Harness 的免费网页搜索插件,无需 API 密钥即可使用 Bing、DuckDuckGo、SearXNG 等引擎,支持自动故障切换、时间范围筛选、GitHub/Reddit 平台搜索、网页抓取与结果缓存,并可通过设置界面配置引擎和密钥。适合需要开箱即用联网检索、诊断引擎可用性或读取网页内容时使用。注意免费引擎可能受限流影响,付费引擎需自行配置密钥。

A free web search plugin for DeepSeek Harness. It works without API keys using Bing, DuckDuckGo, SearXNG, and other free engines, with automatic fallback, time-filtered search, GitHub/Reddit platform search, page fetching, diagnostics, and caching. Use it when the harness needs out-of-the-box web retrieval or engine checks. Optional paid engines such as Perplexity require API keys, and free engines may be rate-limited.

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:delef/dsh-free-web-search

delef/dsh-free-web-search 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-free-web-search

Free web search plugin for DeepSeek Harness. No API keys required — works out of the box with Bing, DuckDuckGo, and SearXNG. Optional paid engines (Exa, Tavily, Keenable, Perplexity, DeepSeek Official) activate when you add a key.

Features

  • 10 search engines with automatic fallback — if one fails, the next one picks up
  • Time-filtered search via advanced_search tool (last day/week/month/year, or custom ranges like 3d, 2mo, 2026-07-01)
  • Platform search — GitHub repos and Reddit threads via platform_search tool
  • Engine diagnosticsfree_search_test tool to check which engines work
  • Web Settings UI — engine selection, API key management, cache TTL config
  • Result caching — LRU cache (50 entries, configurable TTL up to 5 min) to reduce rate limiting

Install

dsh plugin --profile web add github:delef/dsh-free-web-search

If pnpm blocks the build script, add the key it prints to allowBuilds in your profile's pnpm-workspace.yaml and retry.

Engines

Engine Cost Key required
Bing Free No
DuckDuckGo (HTML / Lite) Free No
SearXNG Free No
AnySearch AI Free No
Exa Free tier / paid Optional
Tavily Free tier / paid Optional
Keenable Free tier / paid Optional
Perplexity Paid Yes
DeepSeek Official Paid Yes

Default engine: Bing (most stable). Change it in Settings > Plugins > Free Web Search, or type /free-search-engine in chat.

Tools

web_search (built-in, powered by this plugin)

Standard harness web search. Uses the configured engine with automatic fallback.

advanced_search

query: "rust async runtime"
timeRange: "week"        # day | week | month | year | 3d | 2mo | 1y | 2026-07-01
engine: "exa"            # optional, override preferred engine
maxResults: 5

platform_search

platform: "github"       # github | reddit
query: "deepseek harness plugins"
maxResults: 5

web_fetch

url: "https://docs.example.com/guide"
maxLength: 50000                       # optional, default 50000 chars

Fetches a single page, strips HTML, returns plain text. For reading articles, docs, or any URL.

free_search_test

Tests engine availability. No arguments tests all engines.

Configuration

Settings are managed through the web UI (Settings > Plugins > Free Web Search) or settings.yaml:

free-search:
  provider: bing
  bingMarket: en-US
  cache: true
  cacheTtl: 5
  platforms:
    - github
    - reddit
  searxngInstances:          # optional, overrides default public instances
    - https://your-instance.example.com
  # Optional API keys
  exaApiKey: ""
  tavilyApiKey: ""
  keenableApiKey: ""
  perplexityApiKey: ""
  deepseekApiKey: ""

License

Apache-2.0

上一个 Prev awesome-dsh 下一个 Next dsh-workspace-snapshot