Projects
面向 AI Agent 场景的 Tavily Search 代理与密钥池管理平台，提供统一入口、失败切换与可视化后台
项目简介
Tavily Search 是一个为 LLM / Agent 设计的实时搜索接口，适合做网页检索、事实补充、研究问答，以及 RAG 和自动化工作流中的外部信息获取。它解决的是“让模型拿到最新网页信息”这件事。
TavilyProxy 解决的则是“如何把 Tavily 稳定接进系统”。它把多把 Tavily API Key 收口成一个统一入口，对外只暴露单一 Master Key，对内负责密钥池调度、失败切换、请求日志和后台管理，更适合长期运行的 Agent、检索流程和内部工具。
TavilyProxy 首页界面预览
这张封面图展示的是 TavilyProxy 的首页界面。项目本质上是在 Tavily Search 与实际 AI Agent 系统之间增加一层统一代理与管理平面，因此首页本身就能很好体现它“统一入口 + 后台管理”的产品定位。
先理解 Tavily Search：它适合给 Agent 提供实时外部信息
Tavily Search 不只是普通搜索接口，更适合接进 AI 应用。它可以给 agent 提供最新网页结果，也能服务于研究型问答、RAG 补充检索、内容聚合和自动化工作流。
但当调用从“偶尔用一下”变成“长期运行”，工程问题就出现了：API Key 怎么管、额度怎么分配、单 Key 失效怎么办、请求记录怎么追踪。TavilyProxy 就是在这里切入。
统一入口 + 密钥池，让 Tavily 更适合长期运行
TavilyProxy 把多个上游 Tavily API Key 收拢到同一个代理层后面。客户端只需要配置一套 Master Key，就能通过统一地址访问 Tavily，不必在业务代码里自己处理多 Key 切换、额度耗尽或失败重试。
它会根据额度状态选择可用 Key，并在认证失败、限流或配额问题出现时自动切换，让原本脆弱的单 Key 依赖变成更适合生产使用的可调度资源池。
不只是代理，也是一块可视化运维面板
这个项目不只负责转发请求，还提供完整的 Web 管理后台。你可以管理密钥、查看请求日志、观察额度使用情况，并处理定时维护任务。
对个人开发者来说，它减少了手动换 Key 和排查问题的摩擦；对团队来说，它让 Tavily 的使用状态更透明，也更容易长期维护。
MCP 接入，让它可以自然融入 Agent 工具链
TavilyProxy 还提供 MCP endpoint，因此它不只是一个后端代理服务，也可以作为 Claude Code、VS Code 或其他 Agent runtime 里的搜索工具层。
这意味着它既适合普通应用调用，也适合本地 AI 工作流、团队内部 Agent 平台或统一搜索中间层。这种兼顾 API 代理和 Agent 接入的设计，是它最有辨识度的亮点之一。
功能亮点
统一 Tavily 访问入口
对外暴露单一 Master Key 与代理地址，客户端无需直接管理多把 Tavily API Key
密钥池调度
根据额度状态选择可用 Key，并在相近候选之间随机分配，提高整体配额利用率
自动重试与失败切换
当上游出现认证失败、限流或配额问题时，自动切换其他 Key 继续完成请求
管理后台与日志
提供 Web UI、密钥管理、请求日志、使用趋势查看与后台运维入口
定时维护任务
支持额度重置与日志清理等周期性任务，便于长期稳定运行
MCP Endpoint
可作为 Claude / VS Code 等 Agent 工具链中的搜索服务层接入
技术栈
后端
- • Go
前端
- • Vue 3
- • Vite
- • TypeScript
- • Naive UI
数据存储
- • SQLite
部署
- • Docker
- • Docker Compose
- • GHCR 镜像
- • Render Blueprint
接口能力
- • HTTP API Proxy
- • MCP Endpoint
开源许可
MIT License – 可在保留版权声明的前提下自由使用、复制与分发