ModSearch: A DSH plugin that brings web search to DeepSeek Harness
liustack/modsearch
Web plugin for DeepSeek Harness that adds web search, X search, and page fetch to models without native web access, returning structured JSON evidence.
Give models without native web access the ability to search the web, X, and any page, returning structured JSON evidence.
dsh plugin --profile web add github:liustack/modsearch- Category
- Tools & Capabilities
- Platform
- DSH-Plugin
- Author
- liustack
- Distribution
- Plugin
modsearch Key Features
modsearch Repository
modsearch Repo Summary
ModSearch is a web plugin (DSH plugin) for DeepSeek Harness, designed to give models without native web access—like DeepSeek-V4-Flash—the ability to search the web, X (Twitter), and fetch single pages. It solves the problem of models lacking real-time information by providing structured JSON evidence through a multi-engine chain (Antigravity CLI, Tavily, Exa, Firecrawl, Grok Build, local) with automatic failover. Maintained by liustack under the MIT license, it was last updated in 2026-08 and has 107 stars on GitHub.
What core features does the ModSearch DSH plugin support?
ModSearch adds three tools to DeepSeek Harness: the built-in web_search (running on the modsearch engine chain with no API key, preserving native citation cards), x_search for searching X/Twitter (requires Grok Build), and read_page for focused single-page reading. All channels offer free tiers—Antigravity CLI is the default with no API key needed, while Tavily, Exa, and Firecrawl provide monthly free credits without requiring a credit card. When a channel fails or exhausts its quota, the next one automatically takes over, ensuring uninterrupted search.
How do I install the ModSearch DSH plugin?
Installing ModSearch is a one-command process that registers the web_search, x_search, and read_page tools into the DSH web profile. After installation, DSH's built-in web_search automatically runs on the modsearch engine chain without extra configuration.
dsh plugin --profile web add github:liustack/modsearch
Which engines and configuration methods does the ModSearch DSH plugin support?
ModSearch supports multiple search engines, each configurable with a single command. Keys are stored in ~/.modsearch/config.json (permission 0600, masked when shown). Antigravity CLI is free and keyless—just install agy and sign in. Tavily offers 1,000 free credits/month, Exa provides ~1,400 searches/month, and Firecrawl gives 1,000 credits/month with keyless search support. Example configuration command: modsearch config set tavily.apiKey <key>.
Which DeepSeek Harness versions and platforms does the ModSearch DSH plugin support?
ModSearch works not only with DeepSeek Harness but also with Claude Code, Codex, Pi, and OpenCode, enabling a single installation across multiple agent frameworks. It is built with TypeScript and requires Node.js. The project is maintained by liustack under the MIT license; more details are available in the official documentation.