POST
/v1/search统一搜索#
一种写法调任意引擎,返回统一结构。想用某家就指定 engine;不指定则用默认引擎;想对比就传 engines。返回的 engine 字段与响应头 x-engine 是实际使用的引擎。某引擎不支持的公共参数返回 400 说明,不静默忽略。传 engines 数组时返回 by_engine 按引擎分组(每家各自的 results / points_charged / error),points_charged 为合计;只调你点名的引擎,不替换、不追加。
请求体
enginestring可选引擎:exa / serpapi / tavily / serper / anysearch / brave / bocha / baidu。不填则用默认引擎(anysearch);和 engines 二选一。失败不会自动换别家
enginesarray可选同时搜几个引擎,如 ["a", "b"];只调你点名的引擎,各自按价目扣分,失败的那家不扣
mergeboolean可选多引擎时 true:另给一份去重合并的 results,每条带 engines 标出哪几家搜到
querystring必填搜索词
num_resultsinteger可选每个引擎返回条数 1-10;Exa 1-100(超过 10 条每多 10 条加收积分);超出返回 400,不扣分
depthstring可选basic(默认,基础档)/ advanced / deep;引擎不支持时报错
time_rangestring可选day / week / month / year
include_domainsarray可选只搜这些域名
exclude_domainsarray可选排除这些域名
languagestring可选语言,如 zh
rawboolean可选true 时附带该引擎官方原生返回
extraobject可选引擎专属参数,原样透传
错误
| 错误 | 什么时候 | 怎么办(error.hint) |
|---|---|---|
400invalid_request | 参数错误(网关拦截或引擎判定参数错) | 看 message 里说的是哪个参数,改好再试;本次未扣积分 |
401unauthorized | 缺少密钥或密钥无效 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
402insufficient_points | 积分不足 | 兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分 |
404engine_not_found | 引擎不存在 | 检查引擎名是否写错,GET /v1/engines 可查看全部引擎 |
429rate_limited | 超过套餐每秒请求数(排队超过上限) | 稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐 |
429engine_busy | 引擎繁忙 | 稍等几秒再试,或用 engine 换一家 |
502engine_error | 引擎暂时异常(已自动重试) | 稍后重试(已自动重试过);着急可用 engine 换一家,本次未扣积分 |
503engine_unavailable | 引擎暂不可用或暂未开放 | 稍后再试,或用 engine 换一家已开放的引擎;本次未扣积分 |
POST /v1/search
curl https://jusouai.cn/v1/search \
-H "Authorization: Bearer $JUSOU_KEY" \
-H "Content-Type: application/json" \
-d '{"engine": "exa", "query": "量子计算", "num_results": 5}'import os
import requests
r = requests.post(
"https://jusouai.cn/v1/search",
headers={"Authorization": "Bearer " + os.environ["JUSOU_KEY"]},
json={
"engine": "exa",
"query": "量子计算",
"num_results": 5
},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/search", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.JUSOU_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"engine": "exa",
"query": "量子计算",
"num_results": 5
})
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 200
{
"request_id": "js-20261031120000-a1b2c3d4e5f6",
"engine": "exa",
"results": [
{
"title": "…",
"url": "https://example.com/a",
"snippet": "…",
"content": "…",
"published_at": "…",
"score": null
}
],
"points_charged": 1,
"points_tier": "standard",
"billing": {
"points": 1,
"balance": 999,
"summary": "本次:Exa -1 积分,剩余 999"
}
}参数支持对照表
公共参数与 depth 在各家的支持情况、对应的官方参数与扣分(读自各引擎适配器与实时价目,和实际行为一致)。不支持的传了返回 400,不扣分;引擎专属参数放进 extra 原样透传。
| 公共参数 | Exa | SerpApi | Tavily | Serper | AnySearch | Brave | 博查 | 百度 |
|---|---|---|---|---|---|---|---|---|
query搜索词(必填) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
num_results返回条数(1-10;Exa 1-100,超过 10 条加收) | ✓numResults | ✓num(常被忽略,统一接口按条数截断) | ✓max_results | ✓num | ✓max_results | ✓count(advanced 时为 maximum_number_of_urls) | ✓count | ✓resource_type_filter 的 web top_k |
time_range时间范围 day / week / month / year | ✓startPublishedDate(按天数往前推) | ✓tbs(qdr:d / w / m / y) | ✓time_range | ✓tbs(qdr:d / w / m / y) | —不支持(400) | ✓freshness(pd / pw / pm / py) | ✓freshness | ✓search_recency_filter(week / month / year) |
include_domains只搜这些域名 | ✓includeDomains | —不支持(400) | ✓include_domains | —不支持(400) | —不支持(400) | —不支持(400) | ✓include(仅 basic) | ✓search_filter.match.site(仅 basic) |
exclude_domains排除这些域名 | ✓excludeDomains | —不支持(400) | ✓exclude_domains | —不支持(400) | —不支持(400) | —不支持(400) | ✓exclude(仅 basic) | —不支持(400) |
language结果语言,如 zh / en | —不支持(400) | ✓hl(zh → zh-cn) | —不支持(400) | ✓hl(zh → zh-cn) | —不支持(400) | ✓search_lang(zh → zh-hans) | —不支持(400) | —不支持(400) |
extra引擎专属参数,原样透传 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Exa
支持的公共参数
num_results→ numResultstime_range→ startPublishedDate(按天数往前推)include_domains→ includeDomainsexclude_domains→ excludeDomains
不支持(传了返回 400)
language
depth
basic1 积分:type=lite:最快、最省advanced2 积分:type=auto:Exa 默认档,结果更准deep4 积分:type=deep:多轮深度搜索,最全也最慢
SerpApi
支持的公共参数
num_results→ num(常被忽略,统一接口按条数截断)time_range→ tbs(qdr:d / w / m / y)language→ hl(zh → zh-cn)
不支持(传了返回 400)
include_domains、exclude_domains
depth
basic4 积分:Google 网页搜索(engine=google,只有这一档)
Tavily
支持的公共参数
num_results→ max_resultstime_range→ time_rangeinclude_domains→ include_domainsexclude_domains→ exclude_domains
不支持(传了返回 400)
language
depth
basic1 积分:search_depth=basic:普通搜索advanced2 积分:search_depth=advanced:每个来源给更相关的多段内容
Serper
支持的公共参数
num_results→ numtime_range→ tbs(qdr:d / w / m / y)language→ hl(zh → zh-cn)
不支持(传了返回 400)
include_domains、exclude_domains
depth
basic1 积分:Google 网页搜索(/search)
AnySearch
支持的公共参数
num_results→ max_results
不支持(传了返回 400)
time_range、include_domains、exclude_domains、language
depth
basic1 积分:普通网页搜索(只有这一档)
Brave
支持的公共参数
num_results→ count(advanced 时为 maximum_number_of_urls)time_range→ freshness(pd / pw / pm / py)language→ search_lang(zh → zh-hans)
不支持(传了返回 400)
include_domains、exclude_domains
depth
basic2 积分:网页搜索advanced2 积分:给 AI 的正文上下文:每个网页里与问题相关的正文片段
博查
支持的公共参数
num_results→ counttime_range→ freshnessinclude_domains→ include(仅 basic)exclude_domains→ exclude(仅 basic)
不支持(传了返回 400)
language
depth
basic1 积分:网页搜索
百度
支持的公共参数
num_results→ resource_type_filter 的 web top_ktime_range→ search_recency_filter(week / month / year)include_domains→ search_filter.match.site(仅 basic)
不支持(传了返回 400)
exclude_domains、language
depth
basic1 积分:百度搜索advanced3 积分:AI 搜索(生成答案)
depth 在各家的含义与扣分
depth 决定走该引擎的哪个接口、哪一档;扣分读自实时价目表。
| depth | Exa | SerpApi | Tavily | Serper | AnySearch | Brave | 博查 | 百度 |
|---|---|---|---|---|---|---|---|---|
basic默认 | 1 积分type=lite:最快、最省/v1/exa/search | 4 积分Google 网页搜索(engine=google,只有这一档)/v1/serpapi/search | 1 积分search_depth=basic:普通搜索/v1/tavily/search | 1 积分Google 网页搜索(/search)/v1/serper/search | 1 积分普通网页搜索(只有这一档)/v1/anysearch/search | 2 积分网页搜索/v1/brave/web/search | 1 积分网页搜索/v1/bocha/web-search | 1 积分百度搜索/v1/baidu/web-search |
advanced | 2 积分type=auto:Exa 默认档,结果更准/v1/exa/search | —不支持(400) | 2 积分search_depth=advanced:每个来源给更相关的多段内容/v1/tavily/search | —不支持(400) | —不支持(400) | 2 积分给 AI 的正文上下文:每个网页里与问题相关的正文片段/v1/brave/llm/context | —不支持(400) | 3 积分AI 搜索(生成答案)/v1/baidu/ai-search |
deep | 4 积分type=deep:多轮深度搜索,最全也最慢/v1/exa/search | —不支持(400) | —不支持(400) | —不支持(400) | —不支持(400) | —不支持(400) | —不支持(400) | —不支持(400) |
MCP 与 Skill(给 AI 用)
远程 MCP 服务(Streamable HTTP,无状态):https://jusouai.cn/mcp,请求头带同一个 Key,扣分规则与 API 一致;工具结果末尾有一句本次扣分与剩余积分,出错时带「怎么办」。
| 工具 | 说明 |
|---|---|
web_search | 联网搜索:query + engine(或 engines 同时搜几家,可 merge 去重);num_results / depth / time_range / 域名过滤可选 |
list_engines | 列出开放的引擎和各档位扣分(免费) |
get_balance | 查询可用积分(免费) |
通用配置(mcpServers JSON)
{
"mcpServers": {
"jusou": {
"type": "http",
"url": "https://jusouai.cn/mcp",
"headers": {
"Authorization": "Bearer <你的 Key>"
}
}
}
}Claude Code
claude mcp add --transport http jusou https://jusouai.cn/mcp --header "Authorization: Bearer <你的 Key>"Skill(SKILL.md)
不支持 MCP 的 Agent,把 https://jusouai.cn/skill.md 给它(或下载放进 skills 目录)。
发给 Agent 的一段话
请用「聚搜GO」帮我联网搜索。
密钥:【把控制台里复制的 API Key 粘贴到这里】(只用于该服务,不要外传)
说明:https://jusouai.cn/skill.md (先读完再调用);
想用某家就指定 engine(exa / serpapi / tavily / serper / anysearch / brave / bocha / baidu),不指定则用默认引擎,想对比就传 engines;
只有需要我确认时再问我(比如一次要花较多积分)。