liustack/modsearch

DeepSeek-V4-Flash 等模型没有联网能力或联网能力羸弱。ModSearch 通过外挂方式大幅增强模型网页搜索、X 搜索、单页抓取能力。

交流

用出问题了就提个 issue。其他的都欢迎来 X 上聊：@liustack，你用它做了什么、在哪个 harness 上跑、接下来该做什么，新版本也是那边先发。社群正在筹备中。

特性

• 🌐 DeepSeek Harness (dsh) 的 web 插件： 一条命令 npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@latest，dsh 内置的 web_search 就跑在 modsearch 引擎链上，无需 API key，原生引用卡片全部保留。旁边再落两个 dsh 没有的工具：搜 X（推特）的 x_search 和带焦点读单页的 read_page。细节见接入指南。
• 完全免费。 默认走 Antigravity CLI 通道，无需 API key。三个备用通道（Tavily、Exa、Firecrawl）均有月度免费额度，注册均不要求绑卡。
• 自动故障转移。 一个通道失败或额度耗尽时自动切换下一个。
• 可搜索 X（推特）。 安装 Grok Build 后，可检索网页索引覆盖不到的 X 内容。
• 一次安装，多端可用。 支持 Claude Code、Codex、Pi、OpenCode。

支持的引擎

下面任何一个都能让搜索跑起来。各一条命令配置，key 存在 ~/.modsearch/config.json（0600 权限，展示时打码）：

引擎	能做什么	免费额度	怎么开
Antigravity CLI	网页搜索 + 单页抓取	免费，浏览器登录	安装 agy 并登录
Tavily	网页搜索	每月 1,000 credits，不绑卡	modsearch config set tavily.apiKey <key>
Exa	网页搜索	每月 $10 循环额度（约 1,400 次），不绑卡	modsearch config set exa.apiKey <key>
Firecrawl	网页搜索 + 单页抓取	每月 1,000 credits，搜索甚至无 key 可用	modsearch config set firecrawl.apiKey <key>
Grok Build	X（推特）搜索	随 SuperGrok 或 X Premium 订阅	安装 grok 并登录
local	单页抓取	内置，零安装	无需任何操作

key 也可以走环境变量（TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY）。配了多个引擎就自动故障转移，好的优先。想用 Tavily、Exa、Firecrawl 兼容的第三方或自建端点？把引擎指过去即可：modsearch config set tavily.baseURL <url>。每个引擎的全部配置项见配置指南。

安装

第一步，准备搜索引擎（唯一需要你亲手做的）。 默认引擎 Antigravity CLI 需要本人在浏览器完成登录：

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy                                                           # 浏览器完成登录后退出

不想装它就注册一个免费 key，Tavily、Exa、Firecrawl 任选一家（Tavily 每月 1,000 次，Exa 每月约 1,400 次，Firecrawl 每月 1,000 点，注册均无需绑卡）。

第二步，剩下的交给你的 AI。 把这句话发给它，选了 key 的话把 key 一起发：

按 https://github.com/liustack/modsearch 的 INSTALL.md 安装并配置 modsearch skill，完成后运行体检并把结果告诉我。

用法

装好之后不需要记任何命令。正常聊天，提出需要查证的问题或给出一个链接，skill 自动触发：选引擎、跑搜索或抓取，答案带着来源回来。

实测

两张截图均为 Codex 桌面 App 中的原样记录，驱动的是自身不能联网的 DeepSeek-V4-Flash。

给出一个博客链接，询问文章内容。25 秒后返回全文的结构化摘要，全程未打开浏览器。

不指定目标，只问「今天有什么有趣的 AI 新闻」。36 秒后返回六条带来源的结果，并在结尾说明哪些信息来自检索聚合、细节可能有出入。该提醒来自 uncertainty 字段。

文档

文档	适用场景
INSTALL.md	一步步安装 skill（为 agent 编写）
CLI 手册	skill 所驱动的 CLI：参数、配置与体检
故障排查	命令报错，查成因和解法
配置手册	配置 key、切换引擎、排查配置
输出契约	解析 JSON 或构建下游工具
宿主接入	在 Codex、Claude Code、OpenCode、Pi 中配置
安全说明	SSRF 防护、DNS 重绑定防护、不可信输入的处理
更新日志	查询版本变更

参与方式

本仓库不接受 PR。项目由作者独立维护，所有代码经作者本人审阅，这是它可靠性的前提。两种有效的参与方式：

• 提交 issue。 bug、建议、难以理解的报错或文档都欢迎。issue 会被认真阅读，并影响后续开发方向。
• Fork。 MIT 协议下你的副本完全归你，修改和发布不受限制。

插入硬广一条

关注微信公众号「liustack」：AI 工具、实践与想法，第一时间推送。微信扫码，或搜一搜「liustack」：

⭐ 如果它对你有用，请给 ModSearch 一个 star，这是其他开发者找到它的方式。

Star History

免责声明

ModSearch 以 MIT 许可发布，使用不受限制。作者不对任何用途（含商业使用）提供保证与背书。上游引擎（Antigravity CLI、Tavily、Exa、Firecrawl、Grok Build）各有自己的条款与额度，遵守这些约束由使用者负责。

License

MIT