Vercel

Search1API 能为 Vercel 应用带来：

• 一个 API 完成搜索与阅读。 你的智能体可以搜索 Google、Reddit、GitHub、YouTube、arXiv 等，读取搜索结果对应的完整页面，并引用所用的 URL。无需第二个抓取服务。
• 只要内容，不要页面外壳。 针对 Reddit、GitHub、YouTube 等站点的专用站点解析器会返回帖子及其评论、仓库 README 或视频字幕，而不是导航和广告。
• 无需管理 API 密钥。 使用 Vercel Connect 时，用户授权其 Search1API 账户，你的代码在运行时请求令牌。

Search1API 提供两种 Vercel 集成：AI SDK 工具包和 Vercel Connect 连接器。

选择集成方式复制锚点链接

如果使用 generateText 或 streamText 工作流，请选择工具包。如果需要通过 Vercel 管理对用户 Search1API 账户的访问，请选择 Connect。

AI SDK 工具包复制锚点链接

安装工具包：

npm install @search1api/ai-sdk ai zod
export SEARCH1API_API_KEY="your-api-key"

将 search1apiTools() 传给 AI SDK 调用的 tools 选项。它提供 search、news、crawl 和 ask；你可以在应用代码中选择要包含哪些工具并设置搜索参数。

AI SDK 指南介绍了工具调用、流式输出、配置和错误处理。组织仓库中提供了一个完整的 Next.js 示例。请将模型提供商的凭证与 Search1API API 密钥分开配置。

Vercel Connect复制锚点链接

打开 Vercel Connect 上的 Search1API 创建连接器，或在已登录 Vercel CLI 的情况下，于使用方项目中运行以下命令：

npm install @vercel/connect
vercel link
vercel connect create search1api --name acme-search1api
vercel env pull

完成账户授权，并为项目的目标环境启用该连接。在服务端代码中请求令牌：

import { getToken } from '@vercel/connect';

// 传入服务端认证中已登录用户的 ID。
export async function searchForUser(userId: string, query: string) {
  const token = await getToken('search1api/acme-search1api', {
    subject: { type: 'user', id: userId },
  });

  const response = await fetch('https://api.search1api.com/search', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${token}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query, max_results: 5, crawl_results: 0 }),
  });

  if (!response.ok) throw new Error(`Search1API returned ${response.status}`);
  return response.json();
}

getToken 返回一个凭证字符串。请将其保留在服务端，并在调用 Search1API 时使用。将 acme-search1api 替换为你的连接器名称。设置步骤请参阅 Connect 快速入门，用户授权和令牌错误请参阅 SDK 参考。

Connect 负责管理运行时凭证，AI SDK 包提供工具 schema 和执行逻辑。如果你需要其他 API 能力（例如站点地图发现），请参阅 REST API 参考。

验证配置复制锚点链接

• AI SDK 工具包： 让智能体搜索某个主题并读取一条结果。检查它是否调用了预期的工具并返回来源 URL。
• Connect： 从已关联的项目和环境中，为已授权用户请求令牌。如果提示需要授权，请先完成该用户的连接再重试。

计费复制锚点链接

Search1API 请求使用凭证所属 Search1API 账户的积分。详见积分与限制。模型用量和 Vercel 服务按各自提供商的方式计费。

资源复制锚点链接

• AI SDK 工具指南
• Vercel Connect 上的 Search1API
• npm 上的工具包
• 工具包源码