Cloudflare Web Search API 测试版

Cloudflare 已推出 Web Search API 的测试版，使 AI 代理和应用程序能够检索实时互联网信息，以增强其响应的准确性。该工具旨在通过提供一个标准化的实时网络检索接口，消除 AI 常见的“编造 URL”或依赖过时训练数据的问题。

集成的搜索提供商与定价

Cloudflare 并不维护自己的搜索索引；相反，它作为通往三个第三方提供商的网关。用户可以使用 Cloudflare 的 AI Gateway 信用额度，或提供自己的 API 密钥。

可用的提供商

Ceramic.ai：最经济的选择，约为每 1,000 次请求 0.25 美元。
Linkup：位于欧盟的提供商，保证符合 GDPR，约为每 1,000 次请求 5.00 美元。
Exa：高端提供商，约为每 1,000 次请求 7.00 美元。

实现方式

开发者可以通过标准的 REST 调用集成该 API，或直接在 Cloudflare Worker 中使用 AI 绑定：

REST API 示例：

curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ \
  --request POST \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "当秋天临近时，盐湖城有哪些有趣的活动？",
    "provider": "ceramic",
    "limit": 5,
    "options": { "gateway": { "id": "default" } }
  }'

Cloudflare Worker 示例：

const response = await env.AI.websearch({
  gatewayId: "default",
  query: "当秋天临近时，盐湖城有哪些有趣的活动？",
  provider: "exa",
  limit: 5,
});

const results = await response.json();

数据隐私与保留

Cloudflare 声称，通过 Cloudflare 发出的所有请求，这三个提供商均支持 零数据保留（ZDR）。然而，这一说法在开发者社区中引发了质疑。

文档冲突：用户指出，Cloudflare 自己的提供商页面将 Exa 列为不支持零数据保留，与主公告相矛盾。
隐私政策疑虑：一些用户指出，Exa 的通用隐私政策提到会对数据进行训练，这引发了对 ZDR 如何在 Cloudflare 流量中具体实现的疑问。
日志记录：由于 API 通过 AI Gateway 运行，搜索请求会被记录在网关日志中，这引发了关于计费数据是否能与实际搜索查询分离以确保真正隐私的疑问。

社区分析与批判性观点

Hacker News 上的技术讨论揭示了关于 Web Search API 的价值主张和伦理问题的多个争议点。

“守门人”悖论

社区中相当一部分人对 Cloudflare 作为机器人防护服务和搜索 API 提供商的双重角色表示担忧。

"创建机器人检测和防护服务，然后出售爬虫。这难道是虚伪的顶峰吗？"

批评者认为，Cloudflare 可能正在构建一个“付费入场”的生态系统，只有其合作提供商的“已验证机器人”才能绕过 Cloudflare 向网站所有者销售的机器人防护机制。

价值主张 vs. 直接集成

许多开发者质疑在应用与搜索提供商之间增加 Cloudflare 作为代理层的实用性。

延迟与复杂性：一些人认为，“云跳转”增加了不必要的延迟，并引入了新的依赖项，而并未显著抽象或标准化不同提供商返回的数据。
成本：用户指出，一些替代方案（如 Gemini Flash Lite 2.5，每日提供 1,000 次免费搜索）或 Serper.dev（每 1,000 次 1 美元）可能比 Cloudflare 集成的提供商更具成本效益。
服务条款：开发者警告，搜索 API 通常有严格的条款。例如，Ceramic 的条款 reportedly 禁止收集、聚合或存储输出以创建数据库或索引，这可能限制代理系统提供“分享对话记录”功能的能力。

性能反馈

早期的非正式报告表明结果质量参差不齐。一位用户报告称，Ceramic.ai 对特定技术查询（例如“qwen-3.8 flash next”）未能返回相关结果，而这些结果在 Google 或 DuckDuckGo 上很容易找到。