Searchpin — Free Web Search for AI Agents

English | 简体中文

Searchpin

专为 AI Agent 打造的可自托管网页搜索——无需 API 密钥，零成本。2026 年，AI 开发的重心正从“对话”转向“自主执行任务”——本地部署、长期运行的 Agent 正日渐普及。当 Agent 以 24/7 全天候运行时，每次网页搜索都不能因 API 配额或计费问题而中断。Searchpin 从设计之初就着眼于此：零外部依赖、零使用限制。Agent 可以不受限制地搜索、抓取和验证，开发者无需担心成本。

为什么选择 Searchpin

🇨🇳 针对中国网络环境优化

默认使用 百度、搜狗、必应国内版和必应国际版——并行查询四个搜索引擎。可直接在中国网络环境中使用，无需代理或 VPN。大多数海外替代方案依赖 Google、DuckDuckGo 或 Brave，而这些服务在中国境内大多无法访问。

🧠 语义重排序——少有的差异化功能

四个引擎的结果并非简单拼接，而是经过合并，再由嵌入模型根据与查询的语义相似度重新排序。AI 收到的是经过筛选的高质量结果列表，而非一堆嘈杂的链接。在免费的 MCP 搜索服务中，具备此功能的寥寥无几。

💰 完全免费，零门槛

无需注册账号、申请 API 密钥，也没有使用限制。不依赖任何商业 API——无需担心突然收费或配额限制。整个处理流程都在自己的机器上运行。

🔍 为现代网站打造

内置的 SSR 内容提取功能可以解析由 Next.js、Nuxt 等类似框架渲染的页面，并提取 JSON-LD 结构化数据和微数据。普通 HTML 抓取无法从这些网站获取任何内容。

web_fetch 还会根据内容类型或文件签名检测 PDF，并在本地提取带有页码标注的文本。对于无法读取、已加密或仅包含图像的 PDF，会返回明确的错误，而非二进制乱码；不包含 OCR 功能。提取限制为 25 MiB、200 页和 200 万个文本字符。

🛡️ 污染检测 + 交叉验证

自动检测并标记与查询无关的结果。四个相互独立的搜索引擎提供可交叉验证的结果，让大模型能够对照多个来源核实信息，从而给出更可信的答案。

⚡ 深思熟虑的工程取舍

每项设计决策都以实际使用场景为出发点：

• 节省 Token — 搜索结果仅返回标题、URL 和摘要。结构化提取数据简洁且经过截断。由大模型判断哪些页面值得完整抓取，避免浪费上下文窗口。
• 响应快速 — 四个引擎异步并行查询。总耗时取决于最慢的引擎，而非四者耗时之和。典型搜索可在 1–2 秒内完成。
• 节省内存 — 嵌入模型（约 118MB）通过 hf-mirror.com（HuggingFace 中国镜像）下载一次，之后从本地缓存重复使用。

快速开始

pip install searchpin && searchpin-setup

首次运行时，会通过 hf-mirror.com（HuggingFace 中国镜像）下载一次嵌入模型（约 118MB）。这是唯一一次性设置。

配置

Claude Desktop / Cursor / any MCP client

添加到 mcpServers 配置中：

{
  "mcpServers": {
    "Searchpin": {
      "command": "searchpin-server",
      "args": []
    }
  }
}

VS Code

或者手动添加到 .vscode/mcp.json：

{
  "servers": {
    "Searchpin": {
      "command": "searchpin-server",
      "args": []
    }
  }
}

Docker

docker run -i --rm ghcr.io/telly6/searchpin:latest

Python API

from searchpin import SearchEngine

engine = SearchEngine()
results = engine.search("Python 3.13 新特性")
page = engine.fetch("https://docs.python.org/3/whatsnew/3.13.html")
engine.close()