---
name: wigolo-search
description: 中搜（wigolo）本地Web搜索/抓取/爬虫工具。用户吉冠佳命名"中搜"。本地MCP服务器，零API费用。
---

# 中搜（wigolo）使用指南

## 是什么

wigolo 是一个本地运行的 MCP 服务器，给AI Agent提供搜索、抓取、爬虫、提取能力。用户命名它为**中搜**（介于小搜和大搜之间的定位）。

## 安装状态

- 版本：v0.2.1
- 安装方式：全局 npm（`npm install -g wigolo`）
- 数据目录：`~/.wigolo/`（约128MB + 模型文件）
- 全局二进制：`/c/Users/32295/AppData/Roaming/npm/wigolo`

## 常用命令

```bash
# 搜索
wigolo search "关键词" --max-results 5

# 抓取网页内容
wigolo fetch <url>

# 健康检查
wigolo doctor

# 预热（首次装完后跑）
wigolo warmup --all

# 查看配置
wigolo config --plain
```

## 配置要点

| 配置项 | 当前值 | 说明 |
|--------|--------|------|
| WIGOLO_RERANKER | true | ML重排序（已从hf-mirror.com下载模型） |
| WIGOLO_LLM_PROVIDER | ollama | 使用本地Ollama模型做研究摘要 |
| WIGOLO_RERANKER_MODEL | ms-marco-MiniLM-L-12-v2 | 默认reranker模型 |

## 国内网络注意事项

wigolo 的 ML reranker 模型（`Xenova/ms-marco-MiniLM-L-6-v2`）托管在 HuggingFace，从中国直接下载会被墙。解决方案：

```bash
# 方法1：用国内镜像下载后放入 ~/.wigolo/transformers/
export HF_ENDPOINT=https://hf-mirror.com
python -c "
from huggingface_hub import snapshot_download
snapshot_download(
    repo_id='Xenova/ms-marco-MiniLM-L-6-v2',
    local_dir=os.path.expanduser('~/.wigolo/transformers/Xenova/ms-marco-MiniLM-L-6-v2'),
)
"

# 方法2：关掉reranker（搜索一样能用，只是排序不精准）
wigolo config --set WIGOLO_RERANKER=false
```

## MCP 集成

将中搜挂到 Hermes 或其他 Agent 上：
```bash
# 启动MCP服务器
npx wigolo mcp

# 或在Agent配置中注册
# claude mcp add wigolo --scope user -- npx wigolo
```

## 与其他搜索工具的关系

| 工具 | 用户称呼 | 定位 | 数据来源 |
|------|---------|------|---------|
| AnySearch | 小搜 | 通用网页搜索 | 百度+Bing |
| wigolo | **中搜** | 本地Web全能（搜+抓+爬） | 自有浏览器引擎+模型 |
| Agent Reach | 大搜 | 垂直平台搜索 | 各平台API |