Agent全网搜 · 搜索能力的水龙头

给 AI 应用用的搜索底座:一级 API 三档(结果 / 快答案 / 读原文的深答案)+ 6 个开箱即用的垂直单元,每次调用都给一条永久快照链接。

服务 agent-websearch · 版本 0.1.0 · 端口 3181 · 对外地址 https://search.ozforce.cn

三条卖点

永久链接

每次调用返回 /s/{token}:正文逐字节冻结,同一 token 永不覆盖。 20 天后打开,和今天一字不差 —— 可以直接发客户、贴进合同附件。

定时归档不再付费

新闻 / 音乐 / 财经这类定时单元每天只向上游付一次钱,当天全站复用 (归档命中 cost_cny=0)。你调 100 次也只花一次检索的钱。

单元即插即用

一个单元 = 一份 JSON 声明 = 一条独立二级 API。加单元不改代码、不重启进程 (热挂载),每个单元独立授权(l2:<单元>)、独立定价。

商品概览(1 credit = ¥0.05)

一级 3 档 + 二级 6 个单元。 完整说明(含每档返回什么、典型延迟、典型场景与代码)见 商品与价格; 机器可读的价格与授权 token 见 /v1/catalog。

商品端点价格档位 / modescope
l1
基础搜索 API
POST /v1/search 1 credits — l1
l1_answer
快答案 API(读片段写答案)
POST /v1/answer 2 credits depth=fast l1:answer
l1_deep
深答案 API(读原文)
POST /v1/search 4 credits depth=deep l1:deep
wiki
世界百科
POST /v2/m1/wiki/run 1 credits 实时 l2:wiki
news
即时新闻
POST /v2/m1/news/run 1 credits 定时 l2:news
music
流行音乐时
POST /v2/m1/music/run 1 credits 定时 l2:music
travel
旅行灵感
POST /v2/m1/travel/run 3 credits 混合 l2:travel
why
十万个为什么
POST /v2/m1/why/run 3 credits 实时 l2:why
finance
财经速览
POST /v2/m1/finance/run 3 credits 定时 l2:finance

POST /v1/search 只给结果(answer 恒为 null); POST /v1/answer 给一段带引用的答案(不传 depth = 快答案, depth:"deep" = 读原文的深答案);二级单元走 POST /v2/{middleware}/{unit}/run。

健康检查

/healthz → {"ok":true,…},其中 sellable / blockers 说明现在到底能交付哪些商品;/version → 版本与运行时信息。

搜索源(只列已接入的两家,不显示密钥)

原料来自两家已接入的搜索源(deepseek → bocha), 它们只是原料供应商:你调的是我们的 API,不必关心底下用了哪一家。 一家抖动时自动降级到另一家,并在响应里如实标 degraded:true 与原因。

id名称状态
bocha博查 Bocha就绪
deepseekDeepSeek Search就绪
mockMock 演示源就绪

资费与配额

tier名称日配额月配额折扣
free免费档50500×1
member会员5005000×0.5
pro专业档200020000×0.3

新 key 赠送 100 credits; 同 key 限速 5 rps。会员折扣不会跌破成本线(宪法 8.6)。 申请入口:/apply。