A vision plugin for DeepSeek Harness that lets text-only models like DeepSeek and GLM read pasted images as structured JSON (OCR, layout, semantics).
liustack/modsearch
A free, keyless web search, X search and page fetch plugin that gives DeepSeek and other text-only models live web access.
- Stars
- 800
- Forks
- 28
- Open issues
- 2
- Last commit
- 4 days ago
What is it?
ModSearch is a plugin that adds web search, X (Twitter) search and single-page fetching to AI models that lack built-in web access, such as DeepSeek and GLM when used through an API. It returns structured JSON evidence, including search results, fetched page content and citations, so the model can answer with sources.
The default engine is Firecrawl's keyless tier, which needs no account, API key or card. Other engines include Keenable, Antigravity CLI, Tavily, Exa and Grok Build for X search, along with a local page fetcher. When several engines are configured, ModSearch fails over to the next one if a channel errors or runs out of quota, and multiple keys per engine can be rotated on authentication or rate-limit failures.
It works with DeepSeek Harness (dsh) as a native plugin and also installs as a skill for Claude Code, Codex, Pi and OpenCode. Configuration lives in a local config file with masked key display, and SSRF and DNS-rebinding protections are documented.
Key features
- 01Web search, X search and single-page fetch in one plugin.
- 02Free default engine with no signup, API key or card required.
- 03Automatic failover across multiple search engines.
- 04Per-engine key rotation for quota and rate-limit handling.
- 05Structured JSON output with sources for downstream use.
- 06Installs as a DeepSeek Harness plugin or a skill for several coding agents.
Use cases
- Giving a text-only DeepSeek or GLM model access to current web information.
- Summarising a blog post or article from a URL without a browser.
- Searching X for discussions that general web indexes do not cover.
- Adding sourced web research to Claude Code, Codex or OpenCode workflows.
Quick start
- 1
Install the plugin into DeepSeek Harness (dsh)
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.10 - 2
Or install the skill via skills.sh
npx skills add liustack/modsearch - 3
Optionally install Antigravity CLI for extra search (run the official install script from the README)
- 4
Sign in to Antigravity CLI in the browser, then exit
agy
Things to know
- Contributions via pull requests are not accepted; the project is maintained by one author.
- Some engines (Grok Build for X search) require a paid SuperGrok or X Premium subscription.
- Keyless engines are rate-limited, and free quotas on other engines are monthly and capped.
Topics
FAQ
- What is modsearch?
- A free, keyless web search, X search and page fetch plugin that gives DeepSeek and other text-only models live web access. ModSearch is a plugin that adds web search, X (Twitter) search and single-page fetching to AI models that lack built-in web access, such as DeepSeek and GLM when used through an API. It returns structured JSON evidence, including search results, fetched page content and citations, so the model can answer with sources.
- Is modsearch free to use? What license does it have?
- modsearch is open source under the MIT license. Check the license terms before using it in commercial products.
- Is modsearch still maintained?
- Actively maintained. The last commit to modsearch was on Oct 18, 2026.
- What can I use modsearch for?
- Giving a text-only DeepSeek or GLM model access to current web information. Summarising a blog post or article from a URL without a browser. Searching X for discussions that general web indexes do not cover. Adding sourced web research to Claude Code, Codex or OpenCode workflows.
- How do I install modsearch?
- Install the plugin into DeepSeek Harness (dsh): npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.10 Or install the skill via skills.sh: npx skills add liustack/modsearch Optionally install Antigravity CLI for extra search (run the official install script from the README) Sign in to Antigravity CLI in the browser, then exit: agy
- Where can I get modsearch?
- The source code and installation instructions are on GitHub: https://github.com/liustack/modsearch
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Official MCP server that gives AI agents and MCP clients web search, scraping, crawling, browser interaction and Markdown or structured-data extraction via Firecrawl.
A Python metasearch library that queries multiple web search backends and returns unified text, image, video, news and book results.
An MCP server giving AI assistants real-time web search, content extraction, site mapping and crawling through Tavily's API.
An MCP server giving AI agents real-time web search, vertical domain search, parallel batch search and URL-to-Markdown page extraction.
An Agent Skill that gives local AI agents like Claude Code full web access via tiered tool routing, a CDP browser proxy, and per-site experience notes.