modsearch 是什么？为 DeepSeek Harness 补上免费联网搜索

modsearch 是 liustack 开发的 DeepSeek Harness（DSH）免费联网搜索插件，为 DeepSeek、GLM 等没有原生联网能力的模型补上网页搜索、X 搜索与单页抓取，免注册、免 API key 开箱即用。 模型在聊天应用里可以搜索，但在 API 场景下无法访问网络，这正是 modsearch 要解决的问题（来源）。它默认使用 Firecrawl 的无密钥层级，每月 1000 次免费额度，不需要账号、API key 或银行卡。本文基于插件最新 README 与官方文档，介绍其核心能力、安装启用方式、典型用法与常见问题。

modsearch 是什么？

modsearch 是一个把网络能力还给 DeepSeek Harness 模型的免费搜索插件，一句话定位是「让无原生联网的模型也能搜索网页、搜索 X 并抓取单页」。 DeepSeek、GLM 这类模型在 API 场景下没有网络访问或访问很弱，聊天应用里却可以搜索，落差让「查实时信息、给带来源的答案」变得困难。作为一款 DSH Plugin，modsearch 通过一套引擎链解决这个问题：默认走 Firecrawl 的无密钥层级，额度不足或失败时自动切换到 Antigravity CLI、Tavily、Exa 等免费通道。它的目标是「免费、免注册、免 API key」，作者 liustack 在 README 中称其为 DeepSeek Harness 生态里「最强的免费联网搜索插件」（来源）。无论网页搜索、X（Twitter）搜索还是单页抓取，模型都会拿到带来源的结构化 JSON 证据，而不是一段无法核实的回答。

modsearch 的核心功能有哪些？

modsearch 的核心能力是「免费联网搜索 + 自动故障转移 + 每引擎密钥轮换 + X 搜索」，一次安装即可在多个 Agent 框架中使用。 具体包括（来源）：

• 免费开箱即用：默认 Firecrawl 无密钥层级，每月 1000 次免费额度，无账号、无 API key、无银行卡；回退通道也全部免费，Antigravity CLI 只需浏览器登录一次。
• 自动故障转移：当某个引擎失败或配额耗尽时，自动切换到下一个可用引擎，搜索不中断。
• 每引擎密钥轮换：Tavily、Exa、Firecrawl 可配置逗号分隔的多个密钥，认证、限流或配额失败时先轮换密钥，再回退到其他引擎。
• 搜索 X（Twitter）：配合 Grok Build 安装与登录，查询网页索引覆盖不到的 X 语料。
• 一次安装，处处使用：兼容 Claude Code、Codex、Pi 和 OpenCode，dsh web 的原生搜索工具行也能直接跑在 modsearch 引擎链上。
• 结构化结果：返回带来源的 JSON 证据，含 uncertainty 字段标注聚合细节，提醒用户二次核实。

怎么安装与启用 modsearch？

modsearch 的安装、更新、卸载都是标准的 DSH 插件命令，装完在 dsh 的插件列表里启用即可，无需任何注册步骤。 下面四组步骤覆盖安装、启用、更新与卸载（安装命令以最新 README 为准，来源）：

1. 安装 modsearch：在 DeepSeek Harness 终端执行下面的命令，把插件装进当前 profile：

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.0

等待命令输出安装完成，就拥有了搜索与抓取能力，默认走 Firecrawl 免费额度。

2. 启用并配置 modsearch：在「设置 → 插件」确认 modsearch 已启用；dsh 的「设置 → 插件 → Plugin config」里还有 ModSearch 卡片，可以选首选引擎、填 API key 或自托管端点、勾选参与故障转移的引擎，全部可视化完成。

3. 更新 modsearch：有新版时执行更新命令：

dsh plugin --profile web update @liustack/modsearch

4. 卸载 modsearch：不再需要时执行卸载命令移除：

dsh plugin remove @liustack/modsearch

卸载后搜索工具行不再路由到 modsearch 引擎链。

modsearch 典型用法

modsearch 用起来不需要记命令——装好后直接像平时一样提问，搜索和抓取会自动触发。 几个典型用法（来源）：

1. 抓取一个网页链接并总结：把博客链接发给模型，问「这篇讲了什么」，modsearch 会读取整页并返回结构化摘要，无需打开浏览器。

2. 开放式实时搜索：直接问「今天 AI 有什么有趣的事」，模型执行搜索后返回带来源的若干条新闻，并用 uncertainty 字段标注聚合细节。

3. 为引擎配置 API key：给 Tavily、Exa 或 Firecrawl 配置密钥：

modsearch config set tavily.apiKey <key>

密钥也可用环境变量 TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY 提供，一个引擎可放多个逗号分隔的密钥用于轮换。

4. 排除引擎或指向自托管端点：不想让某引擎参与故障转移就关掉它：

modsearch config set tavily.enabled false

使用 Tavily/Exa/Firecrawl 兼容的自托管或第三方端点时，把引擎指过去：

modsearch config set tavily.baseURL <url>

所有配置项都会在下次搜索时生效。

modsearch 常见问题与排错

modsearch 的大多数问题集中在 X 搜索不可用、私有网络目标被拦、配额耗尽三类，前两个都有明确的解决步骤。 逐个排查如下（来源）：

1. 症状：X 搜索没有任何结果或报错。 原因：未安装 Grok Build 或未登录。解决：安装 grok CLI 并登录，X 搜索依赖 SuperGrok 或 X Premium 订阅；登录后重新提问即可。

2. 症状：报错提示「Blocked private network target」。 原因：Steam++ / Watt Toolkit / VPN 把 GitHub 等域名指到了本机或保留地址，触发 modsearch 的 SSRF 防护。解决：关闭 Steam++、Watt Toolkit 或调整代理设置，再重试。

3. 症状：免费额度用完，搜索返回失败。 原因：Firecrawl 无密钥层级每月 1000 次额度已耗尽，且没有其他引擎可回退。解决：为 Tavily、Exa 或 Firecrawl 配置免费 key，或给同一引擎配置多个密钥自动轮换。

4. 症状：命令报错但不知道哪里配置错了。 解决：运行 modsearch 自带的诊断命令：

modsearch config doctor

它会检查配置与密钥状态，输出可读的排查结果。

适用场景与注意

modsearch 最适合「模型无原生联网 + 需要实时信息 + 想要带来源答案」的场景，部署前也值得了解它的安全与合规边界。 适用场景包括：DeepSeek、GLM 等无联网模型驱动的 API 应用；需要实时新闻、行情、文档状态的问答；需要搜索 X 语料的内容研究；以及 Claude Code、Codex、Pi、OpenCode 等已接入的环境（来源）。注意事项：密钥存放在 ~/.modsearch/config.json，权限为 0600，显示时会打码；modsearch 有 SSRF 防护与 DNS-rebinding 保护，私有网络目标会被拦截；上游引擎（Antigravity CLI、Tavily、Exa、Firecrawl、Grok Build）各自带有独立的条款与配额，合规使用是用户的责任；项目采用 MIT 协议，作者不提供任何担保。

项目链接

modsearch 是 liustack 维护的 MIT 开源项目，以「免费联网搜索」定位收录于 DSH 插件市场。 本页是完整的使用导读，更多配置项、输出契约与安全说明见插件详情页：modsearch 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：liustack/modsearch。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。