liustack/modsearch
1055Last commit Aug 15, 2026
modsearch DSH plugin
ModSearch is a plugin for DeepSeek Harness that gives models web access. It supports multiple search engines including Antigravity CLI, Tavily, Exa, Firecrawl, and Grok Build for X search. It also provides automatic failover between engines and works in various AI platforms like Claude Code, Codex, Pi, and OpenCode.
How to install the modsearch DSH plugin
dsh plugin --profile web add @liustack/modsearch@latestCopying does not run this command. Review the repository and version before installing the modsearch DSH plugin.
modsearch DSH plugin data source
modsearch DSH plugin snapshot date: Aug 16, 2026
discovered
What the modsearch DSH plugin can do
- Integrates with dsh's built-in `web_search` tool, adding no-API-key web search via Antigravity CLI.
- Adds `x_search` for X (Twitter) search and `read_page` for focused single-page reading.
- Automatic failover between configured engines when one fails or exhausts quota.
- Supports multiple engines: Antigravity CLI, Tavily, Exa, Firecrawl, and Grok Build (for X).
- Engine keys can be set via CLI config or environment variables, and stored securely in `~/.modsearch/config.json`.
Where the modsearch DSH plugin fits
- Enable a model without web access to search real-time news or information.
- Search X (Twitter) for posts, trends, or discussions using the Grok Build engine.
- Fetch and summarize the content of a single webpage by pasting a URL.
- Combine multiple search engines with automatic failover to increase reliability.
- Use the same plugin across different AI platforms (Claude Code, Codex, Pi, OpenCode) after one installation.
Who the modsearch DSH plugin is for
- DeepSeek Harness (dsh) users who want their models to have web search capabilities.
- AI developers and researchers who need real-time web data without leaving the chat environment.
- Users of AI coding assistants like Claude Code, Codex, Pi, or OpenCode who want to extend their model's reach.
modsearch DSH plugin limitations
- The default Antigravity CLI engine requires a browser-based sign-in, which cannot be fully automated.
- Free tiers of Tavily, Exa, and Firecrawl have monthly credit limits (e.g., 1,000 credits/month).
- The project is maintained by a single author and does not accept pull requests, relying on issues and forks for contributions.
- Users are responsible for complying with the terms and quotas of upstream engines.
modsearch DSH plugin: from the repository README
Quoted from the liustack/modsearch README, the upstream source of the modsearch DSH plugin. Copyright remains with the original authors.
Models like DeepSeek-V4-Flash have no web access, or a weak one. ModSearch is a plug-in that greatly strengthens the model's web search, X search, and single-page fetch. ## Talk to us Something broken, or something missing? [Open an issue](https://github.com/liustack/modsearch/issues/new/choose). For everything else, come find me on X: **[@liustack](https://x.com/liustack)**. What you built with it, which harness you are on, what should come next. New releases land there first, and a proper community space is on the way. ## Features - **🌐 The web plugin for DeepSeek Harness (dsh):** one command, `npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@latest`, and dsh's built-in `web_search` runs on the modsearch engine chain with no API key, keeping its native citation cards. Two tools dsh does not have land beside it: `x_search` for X (Twitter) and `read_page` for focused single-page reading. Details in [harness setup](docs/harness-setup.md#deepseek-harness-dsh). - **Completely free.** The default channel is Antigravity CLI, no API key needed. All three fallback channels (Tavily, Exa, Firecrawl) offer monthly free tiers with no card required. - **Automatic failo
Read the full READMERepository license: MIT
modsearch DSH plugin questions
How do I install ModSearch in DeepSeek Harness?
Run the command: `npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@latest`. Before that, you need to set up at least one search engine. The default Antigravity CLI requires a browser sign-in; alternatively, you can get a free API key from Tavily, Exa, or Firecrawl.
Do I need an API key to use ModSearch?
Not necessarily. The default engine Antigravity CLI is free and requires only a browser sign-in. Tavily, Exa, and Firecrawl offer free tiers with monthly credits (no credit card required). If you want to use X search, you need a Grok Build subscription (SuperGrok or X Premium).
How do I configure an API key for a specific engine?
Use the CLI command `modsearch config set <engine>.apiKey <key>`, for example `modsearch config set tavily.apiKey tvly-xxx`. You can also set environment variables like `TAVILY_API_KEY`. Keys are stored in `~/.modsearch/config.json` with restricted permissions (0600).
Which AI platforms does ModSearch work with?
ModSearch is a plugin for DeepSeek Harness (dsh), but it also works with Claude Code, Codex, Pi, and OpenCode. Once installed in dsh, the skills are available in any platform that supports dsh.
What happens if the current search engine fails or runs out of quota?
ModSearch has automatic failover: if one engine fails (e.g., quota exhausted or network error), it tries the next configured engine in order. You can configure multiple engines to ensure continuity.