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/[email protected]。细节见接入指南。
• 开箱免费，免注册。 搜索和单页抓取默认跑在 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 秒后返回全文的结构化摘要，全程未打开浏览器。

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

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

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

支持的引擎

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 <key>
Exa	网页搜索	每月 $10 循环额度（约 1,400 次），不绑卡	modsearch config set exa.apiKey <key>
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 <url>。官方地址始终内置在代码里，不会作为默认配置写入文件。每个引擎的全部配置项见配置指南。

安装

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

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

第二步（可选），再加免费引擎。 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 密钥和自建接口地址、勾选哪些引擎参与故障转移，点保存就生效。

用法

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

文档

文档	适用场景
INSTALL.md	一步步安装 skill（为 agent 编写）
CLI 手册	skill 所驱动的 CLI：参数、配置与体检
故障排查	命令报错，查成因和解法
配置手册	配置 key、切换引擎、排查配置
输出契约	解析 JSON 或构建下游工具
dsh 插件	安装、配置、验证与更新原生 dsh bundle
宿主接入	在 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