← 返回列表
skills·

Search Router：让 Agent 自动选择合适的搜索渠道

一份 Search Router 的安装与使用指南：在 Tavily、Serper、Exa 和 Brave 之间自动路由，并在失败时依次回退。

#AI#Skill#搜索#Agent

Search Router 是给 Agent 使用的「搜索智能路由」。它把 Tavily、Serper、Exa 和 Brave 四个搜索渠道放到同一个入口后面，再根据任务类型选择更合适的渠道：新闻和快讯偏向速度，深度报告需要更完整的全文检索，竞品研究则更看重 Google 结果的准确度。

使用者不必先决定要调用哪个 API，只需要描述自己想找什么。项目代码与最新说明都在 Search Router GitHub 仓库。

安装方式

Hermes Agent

项目默认位于 Skill 目录中。如果需要重新安装：

git clone https://github.com/Zsmboom/search-router.git ~/.hermes/skills/research/search-router
pip install requests

安装完成后，直接对 Hermes 说「搜索 XXX」，Agent 就会自动调用它。

Codex CLI 或 Claude Code

git clone https://github.com/Zsmboom/search-router.git
cd search-router
pip install requests

然后告诉 Agent：「search-router 项目在这个路径下，用它做搜索」。

配置 API Key

配置过程只有两步：先到搜索服务商官网注册并获取 Key，再让 Agent 把 Key 写入配置。最少配置一个渠道即可，第一次使用推荐 Tavily。

渠道 注册地址 免费额度 适合搜什么
Tavily tavily.com 1000 次/天 新闻、快讯、通用搜索
Serper serper.dev 2500 次/月 竞品分析、Google 排名
Exa exa.ai 1000 次/月 深度研究、长文、学术
Brave brave.com/search/api 2000 次/月 通用搜索、隐私场景

拿到 Key 后，可以直接告诉 Agent：

帮我配一下 search-router 的 API Key，Tavily 的 Key 是 tvly-xxx，Serper 的 Key 是 xxx

之后也可以随时追加或更换：

再加一个 Tavily 的 Key：tvly-yyy
把 Serper 的 Key 换成 xxx

怎么用：直接描述搜索需求

通用搜索

帮我搜一下 MiniMax 最新模型发布。

Search Router 会按默认顺序尝试 Tavily → Exa → Serper → Brave，并在当前渠道不可用时自动回退。

新闻与快讯

帮我查一下最近英伟达有什么新闻。

这类任务优先使用速度更快的 Tavily。

深度研究

帮我深入研究一下 small language model 2026 的趋势。

这类任务优先使用全文检索能力更强的 Exa。

竞品分析

帮我查一下 Notion AI 的最新功能。

这类任务优先使用更擅长 Google 排名结果的 Serper。

如果 Agent 没有自动识别，也可以直接说：「用 search-router 搜一下 XXX」。

会得到什么

结果会按相关度排列，每条包含标题、可点击链接、内容摘要和发布日期。例如：

MiniMax 发布最新模型 XXX

https://example.com/article1

摘要：MiniMax 今日正式发布……

（2026-04-07）

MiniMax 模型深度评测

https://example.com/article2

摘要：本文对 MiniMax 最新模型进行了全面评测……

常见问题

Key 用完了怎么办？

回到对应官网注册新 Key，然后告诉 Agent：「加一个 Tavily 的 Key：tvly-xxx」。如果已经配置多个渠道，一个渠道的额度耗尽后会自动切换到下一个。

怎么查当前配置状态？

告诉 Agent：「查一下 search-router 的 Provider 状态」。

结果不理想，想换一个渠道怎么办？

直接指定渠道，例如：「用 Serper 搜 XXX」或「用 Exa 搜 XXX」。

怎么增加搜索渠道？

注册并获取新 Key 后，告诉 Agent：「再加一个 XXX 的 Key」，不需要修改代码。

使用边界

  • 免费额度以各服务商当前规则为准；本文记录的是 Tavily 1000 次/天、Exa 1000 次/月、Serper 2500 次/月、Brave 2000 次/月。
  • 搜索结果摘要通常只有 200–300 字，需要完整内容时应让 Agent 继续打开原文。
  • Search Router 使用公开搜索 API，无法检索必须登录后才能访问的内容。