wigolo – 開源的本地搜索工具，支持接入多種編程 Agent

wigolo是什麼

wigolo 是開源的本地搜索工具，通過 MCP 接入 Claude Code、Cursor 等編程 Agent。無需 API Key，零成本可在本地完成搜索、網頁抓取、全站爬取、結構化提取、緩存和研究。工具支持 18 個搜索引擎並行查詢，結果附帶可解釋評分與原文引用，所有數據保存在本地。

wigolo的主要功能

• search：並行調用 18 個搜索引擎，通過設備端 ML 重排序返迴帶可解釋評分的搜索結果。
• fetch：分層路由抓取網頁，從純 HTTP 自動升級到無頭瀏覽器，智能應對反爬和 SPA 頁面。
• crawl：支持 BFS、DFS 和站點地圖模式的全站爬取，遵守 robots.txt 並自動去重。
• extract：從頁面中提取表格、元數據、JSON-LD 及自定義 JSON 模式的結構化數據。
• cache：將抓取內容存入本地索引，支持關鍵詞與語義檢索，重複查詢毫秒級響應且離線可用。
• find_similar：通過關鍵詞、語義和實時網頁三方融合，找到與目標 URL 或概念相似的頁面。
• research：自動分解複雜問題爲子查詢，並行獲取資源後合成帶引用來源的結構化研究報告。
• agent：執行”計劃→搜索→獲取→提取→合成”的自主收集循環，附帶步驟日誌和時間預算。
• diff + watch：監控頁面自上次訪問後的變化，並將變更結果推送到指定 webhook。

微信關注回覆“開源”，加入AI開源項目交流羣

如何使用wigolo

• 環境準備：確保本地已安裝 Node.js 20 或以上版本。
• 一鍵安裝：運行 npx wigolo init 自動下載瀏覽器引擎和模型，接入 Claude Code、Cursor 等 Agent。
• 健康檢查：執行 npx wigolo health 驗證搜索、瀏覽器和設備端模型是否正常運行。
• 可選 LLM 配置：如需 research 或 agent 功能，設置免費 Gemini API Key 或本地 Ollama 模型。
• Agent 中調用：在 Claude Code、Cursor 等支持 MCP 的 Agent 中直接通過自然語言調用搜索、抓取等工具。
• CLI 直接使用：通過命令行運行 npx wigolo search/fetch/crawl 等指令執行具體操作。
• 本地緩存複用：所有數據自動存儲在 ~/.wigolo/ 目錄，支持離線複用和語義檢索。

wigolo的核心優勢

• 本地優先：所有搜索、抓取和緩存都在本機完成，數據不出設備，斷網也能正常使用。
• 零成本零門檻：無需註冊賬號、無需 API Key，每條查詢永久免費，一條命令即可接入主流 Agent。
• 結果完全可解釋：每條搜索結果附帶字節級原文摘錄、引用 ID 和評分分解，質量高低一目瞭然。
• 多引擎並行搜索：18 個搜索引擎同時查詢，通過排名融合和設備端 ML 重排序，確保結果全面且精準。
• 智能分層抓取：從純 HTTP 自動升級到 TLS 僞裝和無頭瀏覽器，誠實應對反爬，失敗即明確告知。
• 持久本地緩存：所有內容存入本地混合索引（關鍵詞+語義向量），重複查詢毫秒級響應。

wigolo的項目地址

• 項目官網：https://knockoutez.github.io/wigolo/
• GitHub倉庫：https://github.com/KnockOutEZ/wigolo

wigolo的同類競品對比

wigolo的應用場景

• AI 編程輔助：Agent 在寫代碼時自動搜索最新 API 文檔、官方教程和最佳實踐，無需手動切換瀏覽器。
• 技術調研與競品分析：讓 Agent 自主搜索、抓取多個技術博客和文檔站點，合成帶引用的結構化研究報告。
• 全站數據抓取：批量爬取產品目錄、價格信息、論文庫或新聞站點，提取表格和結構化數據到本地。
• 本地知識庫構建：將頻繁查閱的文檔和網頁緩存到本地，形成個人/團隊的離線可檢索知識庫。
• 頁面變更監控：持續監控競品官網、文檔更新頁或價格頁面，變更時通過 webhook 自動通知。