换搜索提供商再也不头秃了

做 AI 应用的都知道，给智能体接搜索功能这事儿，一直挺让人烦躁的。

你吭哧吭哧花了几个礼拜，把 Tavily 调教得服服帖帖，结果呢——人家改价格了、接口限流了、或者突然发现有个更香的替代品。这时候你就得满代码库去找哪些地方调用了这玩意儿，然后一行行改。这活儿谁干谁崩溃。

websearch-sdk 这个工具，就是为了解决这个痛点来的。它的思路很简单：别再给每个搜索提供商单独写适配代码了，一套接口打天下，换底层 provider 跟换灯泡一样轻松。

一套接口，多个后端随便换

核心思想特别直接：不管是 Firecrawl、Tavily、Exa、Brave 还是 Serper，你只管调 search() 和 scrape() 就完事。返回的数据结构永远一个样，不用记各家乱七八糟的字段名。

// 想换提供商？改这一行就行
const provider = createProvider('firecrawl', { apiKey: process.env.FIRECRAWL_KEY });
// 或者
const provider = createProvider('tavily', { apiKey: process.env.TAVILY_KEY });

// 后面调用代码纹丝不动
const results = await provider.search({ query: "2025年AI趋势" });

这下你的搜索逻辑就变成了"可拔插"的。想测试新 provider？工厂函数换个参数就行。要迁移到别家？配置改一改，代码不用动。这才叫正常的软件架构。

跟 Vercel AI SDK 配合得天衣无缝

如果你用的是 Vercel AI SDK，那更省心了。SDK 自带的 web.tools() 能直接给你生成好格式的 ToolSet，里面包含 web_search 和 web_scrape 两个工具，直接丢给模型就能用。

不用自己去折腾工具的 schema 定义、不用写格式化函数这些乱七八糟的东西。脏活累活 SDK 都帮你干了，你只管专注业务逻辑。

体积小，部署到哪儿都行

我挺喜欢它的一点是，这玩意儿直接用原生的 fetch，没有拖着一堆厂商 SDK 依赖。bundle 体积小很多，部署到边缘函数或者一些资源紧张的环境里也不心虚。

包本身同时支持 ESM 和 CommonJS，TypeScript 类型声明也是完整的。不管你用 Node 18+、Deno 还是 Bun，都能无缝接入。

聪明的能力感知设计

还有一个挺贴心的细节：SDK 是"能力感知"的。啥意思呢？就是 scrape 这类方法，只有当当前 provider 支持的时候才会暴露出来。

你不会遇到那种"调了个方法结果人家不支持，然后直接报错"的情况。工具和方法会自动适配 provider 的能力范围，用起来很顺滑。

怎么上手

安装超级简单：

npm install websearch-sdk
npm install @websearch/firecrawl-provider

完事儿。几分钟就能跑起第一个统一搜索请求。

聊聊感想

搜索这个领域变化太快了，尤其是 AI 智能体火起来之后。有一个跟 provider 解耦的抽象层，不光是用起来方便，慢慢会变成刚需。

websearch-sdk 把我们做数据库、做登录认证时那套成熟的架构思路，用到了搜索这里。说实话，这种抽象对于做 AI 产品的人来说，挺实用的。

不管你是创业公司需要快速迭代，还是大厂在管着一堆复杂的 agent 工作流，这种方案都能让你在不同的搜索提供商之间自由切换，不用把身家性命押在某一家的 API 上。这种灵活性，才是真的能 scale 的做法。