liustack/modsearch
Web search bridge for text-only agents: ask the web or X, get structured JSON evidence (search, fetch, citations).
Install
via npm
Resolves a published tarball rather than cloning the repository, and installs without any extra setup. Swap `web` for your profile name if you run another one.
via GitHub · npm package
Installing from GitHub runs the project's build script, which pnpm blocks until you allowlist it — run the command once and pnpm prints the exact key to add under `allowBuilds` in ~/.dsh/profiles/web/pnpm-workspace.yaml.
What happened when we ran it
Installed cleanly when we ran it
Every command here is run in a throwaway container against a clean profile, and the result is whatever the harness recorded — not a guess from the source. Last run yesterday.
Due diligence
What it is — ModSearch provides web search, X search, and page fetching capabilities for text models in DeepSeek Harness.
Who it is for — When using DeepSeek-V4-Flash for tasks requiring up-to-date information, it supplements web search capabilities. If you use a model with native web access, it is not needed.
Watch out — Installation requires browser login for the default engine or free API keys from alternatives. Sandbox test passed: works in fresh profile and registered. The plugin executes shell commands. No obvious issues found.
The verdict — I would install it because of the free default engine and automatic failover support.
Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.
modsearch is a DeepSeek Harness plugin that adds web, X, and single-page reading tools for text-only agents. It connects the harness’s built-in web_search to an engine chain, adds x_search and read_page, and returns structured JSON evidence with sources and citations. The available engines are Antigravity CLI, Tavily, Exa, Firecrawl, Grok Build, and the built-in local fetcher; configured engines fail over when one fails or exhausts its quota.
Configuration is stored in ~/.modsearch/config.json with mode 0600. API credentials can be set with modsearch config set tavily.apiKey, modsearch config set exa.apiKey, or modsearch config set firecrawl.apiKey, or supplied through TAVILY_API_KEY, EXA_API_KEY, and FIRECRAWL_API_KEY. The plugin can also use compatible endpoints through each engine’s baseURL setting.
It is intended for agents that need current web evidence, X search, or focused page extraction beyond the harness’s native search. It is a poor fit when existing web_search is sufficient, or when external engine setup is unacceptable: Antigravity CLI needs browser sign-in, X search needs Grok Build with SuperGrok or X Premium, and API engines require quotas or credentials. The terminal surface reaches the host terminal to install or run helper CLIs such as agy and grok, and to run the plugin’s configuration commands.
modsearch uses an engine chain. The default channel is Antigravity CLI, which is free but requires browser sign-in. API credentials may be stored in ~/.modsearch/config.json with file mode 0600, or supplied through environment variables.
| Engine | Capability | Configuration |
|---|---|---|
Antigravity CLI |
Web search and page fetch | Install agy and sign in |
Tavily |
Web search | tavily.apiKey; TAVILY_API_KEY |
Exa |
Web search | exa.apiKey; EXA_API_KEY |
Firecrawl |
Web search and page fetch | firecrawl.apiKey; FIRECRAWL_API_KEY |
Grok Build |
X search | Install grok and sign in |
local |
Page fetch | Built in |
Each engine can be pointed at a compatible third-party or self-hosted service with its baseURL setting. Multiple configured engines are tried in order, with automatic failover.
The documented configuration form is modsearch config set <key> <value>, for example modsearch config set tavily.apiKey <key> or modsearch config set tavily.baseURL <url>. The CLI also provides configuration and health-check functions through its config and doctor commands.
The plugin connects the harness’s built-in web_search to the configured engine chain and supplies x_search for X and read_page for focused single-page reading. Results are returned as structured JSON evidence, including sources and citations. A search or fetch can be triggered through conversation when the agent needs current information or a URL read.
At least one search-capable engine is needed for web search. Antigravity CLI requires the agy installation and browser sign-in; Grok Build requires a SuperGrok or X Premium account. Tavily, Exa, and Firecrawl use their respective quotas or API-compatible endpoints. local provides page fetching only, so it does not replace a web-search engine.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub
Same category
superdesigndev
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
Installed cleanly when we ran it
Lum1104
Chrome sidebar extension that lets DSH operate your browser directly, no vision capabilities required.
Installed cleanly when we ran it
zhaoolee
Export DSH conversations as Smartisan Notes-style PNGs, or create and update Markdown notes in a configured account-scoped workspace.
Installed cleanly when we ran it
taxueseek
Search built for agents: multilingual coverage across web, academic, code, shopping, finance, news, and encyclopedias.
Installs, but not as a profile layer
lire1131
Undo/redo & rollback system for DSH: every config change is auto-snapshotted; undo/redo/restore to any version from the WebUI or the offline CLI/GUI tools (works even when DSH fails to boot).
Installed cleanly when we ran it
Vladimir-Human
Skills and optional MCP rows for ten Russian marketplaces: price comparison across Wildberries, Detsky Mir and Yandex Market, plus per-source search, product cards and reviews. The 13 skills load on install; both MCP rows stay disabled until RU_MARKETPLACE_MCP_DIR points at a local clone, which needs Python 3.12+ and uv.
No one-line install — this plugin lives inside a larger repository and publishes no npm package.
