🦆 DuckDuckGo Search Provider for DeepSeek Harness
A 100% free, zero-config, API-key-free web search provider plugin for DeepSeek Harness (ctx.web).
💡 Why this plugin?
By default, DeepSeek Harness requires paid API keys for web search (DeepSeek Messages API, Exa.ai, or Perplexity).
If you are running local models (such as Qwen 2.5 / 3.8, DeepSeek R1, Llama 3 via Ollama, vLLM, or LM Studio) to keep your setup completely private and free, paying for search APIs defeats the purpose.
This plugin connects the web_search tool directly to DuckDuckGo:
- 🆓 100% Free: No subscriptions, no credit cards, no tokens.
- 🔑 Zero Credentials: No API key needed.
- 🛡️ Anti-Bot & CAPTCHA Resilient: Multi-tier architecture (DuckDuckGo Form POST → DuckDuckGo Lite → Open Knowledge Fallback) to guarantee 100% search uptime without dead crashes or rate-limit blocks.
- 🔌 Seamless Integration: Plugs cleanly into DeepSeek Harness's
ctx.webseam without any core hacks.
📦 Installation & Setup
Option 1: Use in your DeepSeek Harness deployment
- Add the package to your DeepSeek Harness workspace:
pnpm add dsh-web-search-duckduckgo
- Enable it in your
cordis.yml(orcordis.patch.yml):
plugins:
web:
searchProvider: duckduckgo
web-search-duckduckgo: {}
Option 2: Environment Variable
You can also set DuckDuckGo as your active search provider via environment variable:
DSH_WEB_SEARCH_PROVIDER=duckduckgo
🧪 Verification
Once enabled, whenever your agent or local model executes web_search:
> web_search {"queries": ["RTX 3060 multi GPU local LLM"]}
It will retrieve live, real-time results from DuckDuckGo and feed citations and summaries directly into your conversation.
☕ Support the Project
If this plugin saves you money and helps you run your local AI agents with free internet search, consider buying me a coffee! Every coffee is greatly appreciated and helps maintain this plugin:
Or visit: https://buymeacoffee.com/kitopizzas
📄 License
MIT License © 2026 ncouvin
No comments yet. Be the first to write one.