今天（2026-10-06）我翻 Hacker News 热榜，排在最前面的不是又一个大模型发布，而是一条 Cloudflare 的 changelog——Web Search API 进了 beta。我盯着看了两遍才确认：这不是“又多一个搜索接口”那么简单，它把“让 Agent 联网”这件一直很脏、很散的事，收编成了 AI Gateway 里的一行配置。

① 一句话定位

Cloudflare Web Search API 是 2026 年 10 月 2 日上线的 beta 能力，挂在 AI Gateway 之下。它干的事很朴素：让你的 AI Agent 或应用直接联网检索，用实时信息给回答“兜底”，而不是靠模型的训练截止日期去猜一个可能根本不存在的 URL。

老痛点是真的疼。做 Agent 的人都知道，模型记到某个时间点就停了，问它“今天发生了什么”“这个 API 最新参数长啥样”，它要么编，要么甩给你一个半年前的文档链接。过去要补这块，得自己接搜索服务商、管密钥、管日志、管计费，三家供应商三套 SDK，集成成本不低。Cloudflare 现在把这道工序塞进了它本来就在跑的 AI Gateway。

② 核心能力 / 架构

它本质是一个“搜索路由层”，不是自己养了一套爬虫。发布时你可以从三家供应商里挑：Ceramic.ai、Exa、Linkup。三家都承诺通过 Cloudflare 的请求走 Zero Data Retention（不留存数据），也都签了 Cloudflare 的“已验证机器人爬取标准”。

请求统一走 AI Gateway，所以两件原来要自己操心的事被顺便解决了：一是日志，所有搜索请求都会出现在你的 Gateway 日志里，可观测；二是计费，按各家提供商的公开 API 价结算到你的 AI Gateway 额度，Cloudflare 不额外加价（no additional markup）。你也能“自带密钥”（bring your own provider API key），不想走 Cloudflare 额度就用自己的。

调用面给得很全：既有无状态的 REST API，也有 Workers 里的 AI binding。REST 端点是 ` 网页链接/`，POST 一个 JSON，字段含 `query`、`provider`、`limit`、`options.gateway.id`。在 Worker 里则是 `env.AI.websearch({ gatewayId, query, provider, limit })`，拿回来直接 `.json()`。参数上 `provider` 可选 `ceramic` / `exa` / `linkup`，`limit` 控制返回条数。

③ 上手步骤

环境要求就两样：一个 Cloudflare 账号（拿 `CLOUDFLARE_ACCOUNT_ID`），和一个有 AI Gateway 权限的 API Token（填 `CLOUDFLARE_API_TOKEN`）。这两样都是 Cloudflare 既有体系里的东西，没有额外安装包。

跑通第一条最快是 curl。官方示例是搜“盐湖城秋天有什么好玩的”：

```bashcurl 网页链接/ \ --request POST \ --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \ --header "Content-Type: application/json" \ --data '{ "query": "What are some fun things to do in Salt Lake City as fall approaches?", "provider": "ceramic", "limit": 5, "options": { "gateway": { "id": "default" } } }'```

在 Workers 里更短，用 AI binding 一行发起，返回是标准 JSON。我本机（Node 22.22.2 / pnpm 10.33）没有可用的 Cloudflare 账号，所以上面这条是官方 changelog 原文抄的命令行，不是我跑通的——真要本地验证，得先有一个能用的 `CLOUDFLARE_ACCOUNT_ID`，这一步标「待验」。

④ 适用场景与边界

谁该用：做 AI Agent、RAG 之外还想补“实时性”的团队；已经被模型幻觉 URL 坑过的；本来就在用 Cloudflare AI Gateway 跑模型推理的，顺手就把搜索也收编了，日志和账单一处看。

谁别碰：如果你只需要“搜一次”、量极小、且不想绑 Cloudflare 账号，直接调 Exa / Linkup 原生 API 可能更轻；它目前是 beta，生产稳定性按 Cloudflare 一贯节奏要等一段时间才敢全量依赖。另外它只解决“检索”，不解决“检索到的事实对不对”，答案质量仍然取决于你选的供应商和你的提示词。

已知局限：发布时只有 3 家供应商可选，地域覆盖和中文长尾检索能力各家不一；Zero Data Retention 是供应商承诺，不是 Cloudflare 单方面保证；计费走 Gateway 额度，跨供应商比价得自己算。它也不是开源项目，没有 AGPL 之类的许可证负担，反过来也意味着你不能自托管这套路由逻辑——得一直待在 Cloudflare 的栈里。

⑤ 来源与延伸

- Cloudflare 官方 changelog（原文，含 REST 与 Worker 两段示例）：网页链接- AI Gateway 文档入口：网页链接- Hacker News 讨论帖（555 分，发布当天热榜第一）：网页链接

嘴替总结：以前给 Agent 联网，像是让实习生自己上网查资料还不准带笔记本；现在 Cloudflare 直接把“公司账号 + 报销 + 操作留痕”一次性配齐了。