免费联网搜索liustack/modsearch

ModSearch

在官方 App 里模型能联网，切到 API 就不能了。ModSearch 把联网补回来：网页搜索、X 搜索、单页抓取。免费，免注册，免 API key。

🥇 全网最强的 DeepSeek Harness (dsh) 免费联网搜索插件 🥇

引擎：Firecrawl（免注册，默认）· Antigravity CLI · Tavily · Exa · Grok（X） · local，自动故障转移

English ·
故障排查 ·
配置 ·
输出契约 ·
安全 ·
ModLens（视觉）

DeepSeek 和 GLM 等模型没有联网能力或联网能力羸弱。ModSearch 通过外挂方式大幅增强模型联网搜索、X 搜索、单页抓取能力。装完即用：默认引擎是 Firecrawl 的免注册通道，每月 1,000 免费 credits，不用注册账号，不用 API key，不用绑卡。

交流

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

特性

- 🥇 全网最强的 DeepSeek Harness (dsh) 免费联网搜索插件： 一条命令即刻安装 npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.3。细节见接入指南。
- 开箱免费，免注册。 搜索和单页抓取默认跑在 Firecrawl 免注册通道上：每月 1,000 免费 credits，没有账号、没有 API key、没有绑卡。后备通道也全部免费：Antigravity CLI 只需浏览器登录，Tavily、Exa 和免费的 Firecrawl key 各带独立的月度额度，均不要求绑卡。
- 自动故障转移。 一个通道失败或额度耗尽时自动切换下一个。
- 单引擎多密钥轮换。 Tavily、Exa、Firecrawl 都可配置逗号分隔的多个密钥。鉴权、限流或配额失败时先轮换到下一个密钥，再按引擎链故障转移。
- 可搜索 X（推特）。 安装 Grok Build 后，可检索网页索引覆盖不到的 X 内容。
- 一次安装，多端可用。 支持 Claude Code、Codex、Pi、OpenCode。

实测

四张截图全部原样记录，前两张来自 Codex 桌面 App，后两张来自 dsh web，驱动的都是自身不能联网的 DeepSeek 模型。

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

不能联网的 DeepSeek 通过 ModSearch 总结博客链接

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

开放问题返回六条带来源的结果，并附可信度说明

在 dsh web 里问今天有哪些重要的 AI 新闻。dsh 原生的搜索工具行直接跑在 modsearch 引擎链上，18 秒返回三条当日消息，每条带来源链接。

dsh web 的原生搜索跑在 modsearch 引擎链上，返回三条带来源的当日新闻

问 Node.js 现在哪条版本线还在维护。read_page 先后读官网版本页和发布计划表，59 秒给出结论和版本状态表，来源附在结尾。

read_page 读取两个页面后给出 Node.js 维护线结论

支持的引擎

Firecrawl 零配置直接可用，其余引擎各一条命令。key 存在 ~/.modsearch/config.json（0600 权限，展示时打码）：

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

key 也可以走环境变量（TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY）。同一引擎可在配置文件或环境变量中写入逗号分隔的多个 key，例如 key-one,key-two。配了多个引擎就自动故障转移，好的优先。每个引擎默认都参与，可以用 modsearch config set tavily.enabled false 排除一个。想用 Tavily、Exa、Firecrawl 兼容的第三方或自建端点？把引擎指过去即可：modsearch config set tavily.baseURL 。官方地址始终内置在代码里，不会作为默认配置写入文件。每个引擎的全部配置项见配置指南。

安装

第一步，交给你的 AI。 skill 一装好，搜索和单页抓取就跑在 Firecrawl 的免注册免费额度上，所以安装只是一句话：

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

也可以直接通过 skills.sh 安装同一个 skill：

npx skills add liustack/modsearch

第二步（可选），再加免费引擎。 Antigravity CLI 的综述质量更高，Tavily、Exa 或免费 Firecrawl key 能在免注册额度之上再加一份个人额度，都不要求绑卡。只有 agy 的浏览器登录需要你亲手完成：

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

选了 key 的话，发一句话给 AI 即可：「把我的 tavily key 设成 tvly-...」。

dsh 用户还有一条不碰命令行的路。设置页的「插件 → 插件配置」里有一张 ModSearch 卡片：选首选引擎、填 API 密钥和自建接口地址、勾选哪些引擎参与故障转移，点保存就生效。

dsh 设置页里的「搜索引擎（ModSearch）」配置卡片：选首选引擎、填 API 密钥与接口地址、勾选参与故障转移的引擎

用法

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

文档

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

Clash、Clash Verge Rev、mihomo、Surge 的代理 fake-ip 模式开箱即用：DNS 返回的 198.18.0.0/15 地址会被视为 fake-ip 占位值，不用开任何开关。URL 中直写的 http://198.18.0.5/ 这类地址在 allowPrivateNetwork 关闭时仍会被拦。VPN 用的其它保留段，或 Steam++ / Watt Toolkit 这类 hosts 文件加速器，见私有网络目标被拦。

参与方式

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

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

插入硬广一条

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

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

Star History

免责声明

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

License

MIT