liustack/modsearch

ModSearch – 适用于 LLM 聊天应用的免费网络搜索插件

它是什么

• 一个为 DeepSeek、GLM、Claude Code、Codex、Pi、OpenCode 等大型语言模型（LLM）提供搜索公共网络、获取单个页面或查询 X（Twitter）能力的插件（称为技能），无需模型自带浏览器。
• 它通过第三方搜索后端（Firecrawl、Antigravity CLI、Tavily、Exa、Grok Build 或本地获取器）链路由请求。默认使用 Firecrawl 的无密钥层级，每月提供 1,000 个免费积分，无需注册。
• 如果某个引擎失败或配额用完，会自动尝试下一个引擎（故障转移）。每个引擎可以提供多个 API 密钥，并在出错时轮换。

如何使用

1. 安装 – 在聊天界面或命令行中一行完成，例如：

   npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.6
   # 或
   npx skills add liustack/modsearch
   

2. 配置（可选） – 在 ~/.modsearch/config.json 或通过环境变量（TAVILY_API_KEY 等）添加 Tavily、Exa、Firecrawl 等的 API 密钥。您还可以启用/禁用各个引擎。
3. 聊天 – 只需向模型询问需要最新信息的问题或粘贴 URL。插件会检测意图，选择引擎，执行搜索/获取，并返回包含来源、置信度说明和可选 uncertainty 字段的 JSON 结构化答案。

主要特性

• 默认免费：在 Firecrawl 的无密钥层级（每月 1,000 积分）上开箱即用。其他引擎也是免费的或有低成本免费配额。
• 自动故障转移和密钥轮换 – 配额耗尽或请求出错时在引擎之间无缝切换。
• X（Twitter）搜索：通过 Grok Build，让模型看到常规网络索引遗漏的内容。
• 适用于多种 LLM 前端 – DeepSeek Harness（dsh）、Claude Code、Codex、Pi、OpenCode 等。
• CLI 和配置文档 – 完整的命令行界面（modsearch）、详细配置指南、输出模式和安全性说明（SSRF 防护、私有网络阻止）。

支持的知名引擎

引擎	功能	免费层级	启用方法
Firecrawl（默认）	网页搜索 + 页面获取	每月 1,000 免费积分，无密钥	立即可用
Antigravity CLI	网页搜索 + 获取（更好的综合）	免费，浏览器登录	agy 安装并登录
Tavily	网页搜索	每月 1,000 免费积分	modsearch config set tavily.apiKey <密钥>
Exa	网页搜索	每月 $10 循环积分（约 1,400 次搜索）	modsearch config set exa.apiKey <密钥>
Grok Build	X（Twitter）搜索	使用您的 SuperGrok/X Premium	安装 grok 并登录
local	仅页面获取	内置	无需额外步骤

典型用例

• 通过发送 URL 获取博客文章的简洁、有来源的摘要。
• 提问“今天 AI 有什么有趣的事？”并获得几条带有置信度说明的最新、有来源的新闻。
• 通过获取发布页面来检索软件项目的维护状态。
• 当模型自身知识过时，获取某个话题的最新推文。

文档和支持

• 安装指南、CLI 手册、配置参考、输出模式、安全注意事项和故障排除都在仓库中。
• 问题通过 GitHub 处理；社区更新在 X（@liustack）上公布。
• 项目采用 MIT 许可证，由单一作者维护；不接受拉取请求，但允许分叉。

结论 ModSearch 是一个实用、免费优先的插件，通过智能引擎回退系统和最小化设置，为原本缺乏实时网络访问的 LLM 恢复实时网络访问。对于需要最新信息而无需管理自己搜索基础设施的 AI 代理或基于聊天的工具开发者尤为有用。