liustack/modsearch

🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件，免费免注册免 API key。为不能联网的模型补上搜索，问网页或 X，拿回结构化 JSON 证据（搜索、抓取、引用）。

什么是 ModSearch？

ModSearch 是一个插件，为大型语言模型（LLM）聊天应用（尤其是 DeepSeek Harness（dsh））提供实时网页搜索、X（Twitter）搜索和单个页面抓取功能。它通过串联一组免费或低成本的搜索后端（Firecrawl、Antigravity CLI、Tavily、Exa、Grok 以及内置的本地抓取器）来实现这一点，并在配额耗尽或请求失败时自动回退到下一个后端。

为什么重要

许多流行的 LLM（DeepSeek、GLM、Claude 等）在没有直接互联网访问的情况下运行，这限制了它们获取最新信息的能力。ModSearch 在无需任何 API 密钥或信用卡注册的情况下恢复了这一能力（默认引擎 Firecrawl 的免密钥层级每月提供 1,000 个免费积分）。它让开发者和最终用户可以向模型询问最新新闻、总结博客文章或检索特定页面，并获得包含来源和置信度说明的结构化 JSON 响应。

核心功能

功能	说明
默认免费的网页搜索	开箱即用，使用 Firecrawl 的免密钥层级（每月 1,000 个免费积分）。
多引擎自动故障转移	可添加 Antigravity CLI、Tavily、Exa、Grok（X）和本地抓取器；系统会在配额或错误发生时轮换密钥并切换引擎。
按引擎密钥轮换	可以为单个引擎提供多个 API 密钥；ModSearch 会在回退前按顺序尝试。
X（Twitter）搜索	当安装了 Grok Build 工具时，ModSearch 可以查询 X 语料库，覆盖常规网页索引无法触及的内容。
DeepSeek Harness 一键安装	`npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@<version>` 直接将插件安装到 dsh 中。
适用于多种聊天环境	也可在 Claude Code、Codex、Pi、OpenCode 以及 CLI（`modsearch`）中使用。
结构化输出	返回包含结果、来源 URL 以及 `uncertainty` 字段（标记聚合或低置信度信息）的 JSON。

工作原理（高层流程）

向模型提问，需要最新信息或提供 URL。
ModSearch 技能检测到请求，并选择最佳可用引擎（从 Firecrawl 开始）。
自动处理认证、速率限制和配额检查，执行搜索或页面抓取。
原始结果返回给 LLM，LLM 综合生成响应，并附加来源列表和置信度说明。

快速开始

安装（最快路径）

# 作为 DeepSeek Harness 插件安装（最常见用例）
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.2

或使用通用技能安装器：

npx skills add liustack/modsearch

默认的 Firecrawl 免密钥引擎立即可用——无需账户，无需 API 密钥。

添加额外引擎（可选）

# Antigravity CLI – 需要浏览器登录
curl -fsSL https://antigravity.google/cli/install.sh | bash
agy   # 登录后退出

# 添加 Tavily 密钥（如果有）
modsearch config set tavily.apiKey <YOUR_TAVILY_KEY>

# 添加 Exa 密钥
modsearch config set exa.apiKey <YOUR_EXA_KEY>

也可以通过环境变量（TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY）设置密钥。

基本用法

安装后无需运行任何命令。直接聊天即可：

“总结最新的 AI 新闻。” → ModSearch 执行网页搜索，聚合六条近期报道，并返回包含来源和 uncertainty 说明的 JSON。
“Node.js 发布页面关于维护说了什么？” → ModSearch 抓取页面，提取时间表，并用表格和来源链接回复。

如果更喜欢用 CLI 测试：

modsearch search "AI breakthroughs 2024"
modsearch read_page https://example.com/blog/post

CLI 反映了技能在后台执行的操作。

配置亮点

引擎启用/禁用 – modsearch config set tavily.enabled false
密钥轮换 – 用逗号分隔多个密钥：modsearch config set exa.apiKey key1,key2
自托管端点 – 将引擎指向自定义 URL：modsearch config set tavily.baseURL https://my-proxy.example.com
安全性 – 内置 SSRF 防护、DNS 重绑定保护，以及可选阻止私有网络地址（参见 docs/security.md）。

所有设置存储在 ~/.modsearch/config.json 中，权限为 0600。

适用人群

构建 AI 代理的开发者，需要最新信息而无需支付付费搜索 API。
DeepSeek Harness 用户，希望获得更丰富的网页搜索体验。
任何尝试 LLM 驱动助手（Claude Code、Codex、Pi、OpenCode）的人，需要一个开箱即用的插件。

限制与注意事项

免费层级有月度积分限制（例如 Firecrawl 1,000 积分）。耗尽后，ModSearch 会回退到下一个引擎，但整体吞吐量受免费配额总和限制。
X（Twitter）搜索需要 Grok Build 工具以及有效的 X Premium 或 SuperGrok 订阅。
该仓库不接受拉取请求；贡献仅限于问题或个人分支。

了解更多

安装指南 – INSTALL.md
CLI 参考 – skills/modsearch/references/cli.md
引擎配置 – skills/modsearch/references/configure.md
输出模式 – skills/modsearch/references/output-schema.md
安全详情 – docs/security.md
演示截图 – README 中包含插件实际运行的截图。

快速要点

ModSearch 是 LLM 聊天应用的免费、即插即用网页搜索层。
它捆绑了多个搜索后端，支持自动密钥轮换和故障转移。
对于 DeepSeek Harness，安装只需一条命令；默认引擎无需用户提供任何凭据即可工作。
该工具返回结构化 JSON，包含来源和置信度信息，便于构建可靠的 AI 助手。