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 助手。