Vercel · AI SDK · Connect

一个包,让你的 AI SDK agent 能搜索、读完任意网页,并给出引用

安装 @search1api/ai-sdk,agent 就能搜索 Google、Reddit、GitHub、YouTube、arXiv 等来源,读取任一结果的完整页面,并附上用到的链接作答。不想自己管理 key?用 Vercel Connect。

有什么不同

一个 API 搞定搜索和读全文

同一个 key、同一个包覆盖搜索、新闻和网页读取。agent 找到来源后直接读完整页面,不用再接一家抓取服务。

拿到内容本身,而不是页面外壳

Reddit、GitHub、YouTube 等站点有专用解析,返回帖子和评论、仓库 README 或视频字幕的干净 Markdown,而不是导航和广告。

不用自己管 key

通过 Vercel Connect,用户授权自己的 Search1API 账号,应用在运行时请求 token,环境变量里不必存 key。

两种接入方式

用工具包给 AI SDK agent 加上现成工具,或通过 Vercel Connect 以运行时凭证调用 Search1API。

Vercel AI SDK 工具

给 agent 接上现成的联网工具。

使用 @search1api/ai-sdk 搜索网页、查找新闻和读取网页正文。

支持 AI SDK 的 generateText 和 streamText,包括 Next.js 应用。

安装 npm 包,在服务端配置 Search1API API key。

Vercel Connect

在运行时获取 Search1API 凭证。

连接 Search1API 账号,通过 @vercel/connect 请求授权访问。

适用于 Vercel 项目,可按项目和环境管理访问权限。

创建 Search1API 连接器,完成账号授权,再为用户请求 token。

用实时信息构建应用

为 Next.js 聊天应用添加搜索与网页阅读。

研究近期新闻,返回带来源链接的回答。

在 Vercel 应用中使用已授权的 Search1API 账号。

开始接入

工具调用使用 AI SDK 包。Connect 命令在需要连接器的 Vercel 项目中执行;授权流程与运行时代码见 Vercel 接入指南。

AI SDK 工具:安装与配置 — bash
npm install @search1api/ai-sdk ai zod
export SEARCH1API_API_KEY="your-api-key"
AI SDK 工具:让 agent 搜索与阅读 — ts
import { gateway, generateText, stepCountIs } from 'ai';
import { search1apiTools } from '@search1api/ai-sdk';
​
const result = await generateText({
model: gateway('openai/gpt-5-mini'),
tools: search1apiTools({ only: ['search', 'crawl'] }),
stopWhen: stepCountIs(5),
prompt: 'Find the AI SDK tool calling docs, read them, and cite the URLs you used.',
});
​
console.log(result.text);
Vercel Connect:创建连接器 — bash
npm install @vercel/connect
vercel link
vercel connect create search1api --name acme-search1api
vercel env pull

运行前须知

API key 和 Connect token 均在服务端使用。

AI SDK 工具包使用 Search1API API key;模型提供商需要单独配置凭证。

Vercel Connect 需要关联项目、启用对应环境,并完成用户授权。

Search1API 请求使用所连接账号的积分,计费详情见接入指南。

常见问题

应该选择哪个集成?

需要现成的 AI SDK 工具时,使用 @search1api/ai-sdk;需要 Vercel 管理已授权 Search1API 账号的运行时访问时,使用 Vercel Connect。

AI SDK 工具包必须部署在 Vercel 吗?

不必。可以在兼容的服务端 JavaScript 环境中运行 AI SDK 应用。

Connect 会提供 AI SDK 工具吗?

Connect 提供运行时凭证;@search1api/ai-sdk 提供 search、news 和 crawl 的工具定义与执行。

了解更多