个人网页搜索

快速开始

```bash

3. 添加到客户端（见下方「安装部署 > 注册 MCP 客户端」）

```

安装部署

Docker

git clone --depth 1 https://github.com/daidaiJ/websearch-mcpserver.git
cd websearch-mcpserver && docker build -t websearch:v1 .

```yaml

docker-compose.yml

services: websearch: image: websearch:v1 restart: always volumes: - ./config.yaml:/app/config.yaml ports: - "8338:8338" ```

Agent 快速部署

Agent 可按以下步骤自动完成安装：

```bash

2. 启动（零配置）

./websearch-mcpserver start

2. 写入最小配置（零 Key 即可运行）

mkdir -p ~/.config/websearch cat > ~/.config/websearch/config.yaml << 'EOF' port: 8338 mode: engine EOF

3. 启动并注册（见上方「注册 MCP 客户端」）

./websearch-mcpserver start ```

Windows 自启动（可选）：下载后执行 websearch-mcpserver.exe install。

使用指南

Windows 开机自启动

./websearch-mcpserver.exe install   # 生成 VBS 脚本 + 启动目录快捷方式
./websearch-mcpserver.exe uninstall # 移除快捷方式

使用 COM API（ole32.dll）创建快捷方式，不依赖 PowerShell。

2. 启用并启动服务

sudo systemctl daemon-reload sudo systemctl enable websearch sudo systemctl start websearch

2. 加载并启动

launchctl load ~/Library/LaunchAgents/com.websearch.server.plist launchctl start com.websearch.server

Qwen Code — 在 settings.json 的 mcpServers 中添加：

SmartSearch 高级配置

smartsearch 节控制搜索结果的过滤、截断和输出格式：

smartsearch:
  max_size: 10        # 全局最大结果数（按 score 排序后截断），0 = 不限
  show_meta: true      # 输出中显示引擎来源和相关性分数（默认 true）
  engines:
    tavily_api:        # Tavily API（回传 score，可设 min_score）
      min_score: 0.5   # 最低相关性分数阈值，0 = 不过滤
      max_size: 6      # 单引擎最大结果数（默认 4）
    bing:              # Bing（不回传 score，min_score 无效）
      max_size: 4
    baidu_api:         # 百度千帆 API（不回传 score）
      max_size: 5
    baidu:             # 百度网页搜索（不回传 score）
      max_size: 5
    google:            # Google（不回传 score，需代理）
      max_size: 4

Score 过滤逻辑： - 引擎回传 score 时：按 min_score 过滤，保留 max_size 条 - 引擎不回传 score 时：忽略 min_score，取 min(max_size, ⌈global_max_size / 引擎数⌉) 截断 - 全局 max_size：有 score 时按 score 排序截断，无 score 时按引擎轮询均匀分配

配置

详见 docs/config.md — 完整配置项、默认值、环境变量覆盖。

最小配置（零 Key 启动）：

port: 8338
mode: engine

curl -sL https://api.github.com/repos/daidaiJ/websearch-mcpserver/releases/latest \

curl -sL https://api.github.com/repos/daidaiJ/websearch-mcpserver/releases/latest \

$release = Invoke-RestMethod https://api.github.com/repos/daidaiJ/websearch-mcpserver/releases/latest

作为 Go 模块嵌入

import ("websearch/pkg/config"; "websearch/server")

conf, _ := config.Load("config.yaml")
srv := server.New()
srv.SetRefCount(1)
srv.Run(*conf) // 完整托管

// 或仅获取 Handler 嵌入已有 HTTP Server
handler := srv.Handler(*conf)

详见 docs/api.md。

LiteLLM 集成

search_tools:
  - search_tool_name: searxng-search
    litellm_params:
      search_provider: searxng
      api_base: http://localhost:8338/searxng