# ModSearch：给不能联网的模型补上永不断链的免费搜索

> 给不能联网的模型补上搜索：免费免key开箱即用，多引擎自动降级+多key轮询，网页和X搜索怎么折腾都不断链

## 一句话

ModSearch 是给"不能联网的模型"补上搜索能力的插件：DeepSeek、GLM 这类模型在聊天 App 里能联网，走 API 就瞎了——ModSearch 把网页搜索、X（Twitter）搜索、单页抓取补回来，**免费、免注册、免 API key**。

## 差异化在哪：不是"能搜"，是"不会断"

市面上搜索插件一大把，ModSearch 的卖点是**搜索闭环**：

1. **零配置开箱即用**：默认引擎是 Firecrawl 的 keyless 额度，每月 1000 次免费，不用注册、不用 key、不用绑卡，装完就能搜。
2. **多引擎自动降级**：Firecrawl → Antigravity CLI → Tavily → Exa → Grok → 本地抓取，一条挂了或额度用完，自动切下一条。你配得越多，链路越硬。
3. **单引擎多 key 轮询**：Tavily / Exa / Firecrawl 支持逗号分隔塞多个 key，鉴权失败、限流、超额度都会先在引擎内部轮 key，轮完才降级——免费额度可以叠着用。
4. **能搜 X（Twitter）**：装了 Grok Build 就能搜网页索引摸不到的 X 语料，这是多数搜索插件给不了的。
5. **支持自建/第三方端点**：Tavily、Exa、Firecrawl 兼容接口可以 `config set xxx.baseURL` 指到自己的服务。

换句话说：别家插件是"给你一个搜索工具"，ModSearch 是"给你一条怎么折腾都不断的搜索链"。

## 安装

```bash
# DeepSeek Harness 插件形式（主打）
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.1

# 或独立 CLI
npm install -g @liustack/modsearch
```

装完不用配任何东西就能搜。想加免费额度再逐条开：

| 引擎 | 干什么 | 免费额度 | 怎么开 |
|---|---|---|---|
| Firecrawl（默认） | 网页搜索+抓取 | keyless 1000 次/月；注册再送 1000 | 装即能用 |
| Antigravity CLI | 网页搜索+抓取 | 免费 | 装 `agy` 浏览器登录 |
| Tavily | 网页搜索 | 1000 次/月，免绑卡 | `modsearch config set tavily.apiKey <key>` |
| Exa | 网页搜索 | $10/月额度（约 1400 次） | `modsearch config set exa.apiKey <key>` |
| Grok Build | 搜 X | 需 SuperGrok 或 X Premium | 装 `grok` 登录 |

key 存在 `~/.modsearch/config.json`（0600 权限），也支持环境变量。

## 适合谁

- 用 DeepSeek / GLM 等**无联网能力模型**跑 agent，需要补搜索的；
- 在 Claude Code / Codex / Pi / OpenCode / Hermes 里想要一条**免费兜底、永不掉线**的搜索链的；
- 需要搜 X 内容的。

MIT 协议，TypeScript 写的，更新很勤。

---

**分类**：软件
**标签**：搜索 · 免费 · key
**作者**：子龙
**链接**：https://octohz.com/p/2115