woodcoal/SearchHub

SearchHub normalizes Serper, Tavily, Exa, AnySearch, and other search APIs behind one HTTP, CLI, and MCP interface. It manages provider keys, quotas, rate limits, circuit breakers, logs, and failover

About SearchHub

One protocol. Multiple search providers. Automatic key rotation and failover.

SearchHub 把 Serper、Tavily、Exa、AnySearch 等搜索 API 统一成一个协议，并集中处理 API Key 轮换、限流、配额、供应商故障切换和熔断。

它适合需要稳定联网搜索能力的 MCP 客户端、AI Agent、RAG 应用和内部自动化服务。

- 一个 Key 失效或被限流：自动换下一个 Key - 一个供应商故障或超时：自动切换供应商 - 连续失败：熔断，冷却后半开探测 - 每个 Key 独立设置 QPS、日/月/总配额 - HTTP API、CLI、MCP 和管理后台统一提供 - 自托管，密钥和调用日志留在自己的机器上

概览 —— 每个供应商一张卡片：熔断状态、可用密钥数、冷却 / 隔离数、能力标签与全局默认配额。

搜索调试 —— 一次真实调用。第一把 Exa 密钥返回配额耗尽（keyQuotaExhausted），系统自动换到第二把并成功返回；调用链路把两次尝试完整记录下来，一眼看清命中了谁、用了哪把 Key、有没有降级。

供应商配置 —— 按权重（优先级）排序。全局 QPS 与三级配额可作为兜底，密钥里留空的字段自动继承；超时、单供应商最大换 Key 次数、熔断阈值与冷却时长都可调。

用量统计 —— 按尝试次数统计，含最近 24 小时与 14 天趋势、分供应商与分密钥的成功率、平均耗时与最近错误。

API 接口 —— 内置接口文档：认证方式、请求格式，以及各供应商在分页上的能力差异。

这两项保护的是你的上游供应商密钥和后台登录。示例里出现的 change-me 只是占位符，直接沿用会让密钥加密形同虚设。 另外 SEARCHHUBSECRET 一旦设置就不要再改——它是密钥的解密主密钥，改了之后已落盘的供应商密钥将无法解密。

打开 。数据和日志保存在 Docker 命名卷 searchhub-data 中。

注意 heredoc 用的是 生成的值请自行保管：SEARCHHUBSECRET 是供应商密钥的解密主密钥，设置之后不要再更改；改了已落盘的密钥将无法解密。

不要把 .env 提交到 Git。生产环境请把 SEARCHHUBADMINPASSWORD、SEARCHHUBSECRET 和供应商密钥放进安全的 Secret 管理系统。

1. 登录管理后台。 2. 进入「供应商」或「密钥管理」，添加 Serper / Tavily / Exa / AnySearch 的 API Key。 3. 进入「API 授权」，创建一个调用方 API Key。 4. 用调试台或 CLI 发起第一次搜索。

供应商密钥和 SearchHub 调用方 API Key 是两套凭据：前者用于访问上游搜索服务，后者用于保护 SearchHub 接口。

适用于 Claude Desktop、Cursor、Cline 等支持本地 MCP 的客户端：

工具 用途 ------ searchhubsearch 执行统一搜索 searchhubstatus 查看供应商健康度、熔断状态和密钥数量 searchhubproviders 查看供应商及其能力

搜索接口使用管理后台「API 授权」生成的 Key，或 SEARCHHUBAPITOKEN：

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/woodcoal--SearchHub.html)

Related MCP servers