API 文档v0.9.11 Base URL https://jusouai.cnBearer 鉴权1–4 积分/次,Exa 部分参数另加 MarkdownOpenAPISKILL.md
开发文档 / 想多家一起用

统一接口 /v1/search

一种写法调任意引擎、返回统一结构;想对比就传 engines 同时搜几家。只用一家的话,直接看那家的页面更省事,参数和官方一致。

我的 Key登录或兑换后,这里显示你的 Key,代码里自动填好去兑换登录控制台
1复制 Key没有就先兑换卡密,自动开户
2写 engine 或 engines不写用默认引擎;某家不支持的公共参数返回 400,不静默忽略
3看扣分返回里 billing.summary;多家时写明每家各扣多少

参数支持对照表

公共参数与 depth 在各家的支持情况、对应的官方参数与扣分(读自各引擎适配器与实时价目,和实际行为一致)。不支持的传了返回 400,不扣分;引擎专属参数放进 extra 原样透传。

公共参数ExaSerpApiTavilySerperAnySearchBrave博查百度
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 → numResults
  • time_range → startPublishedDate(按天数往前推)
  • include_domains → includeDomains
  • exclude_domains → excludeDomains
不支持(传了返回 400)

language

depth
  • basic 1 积分:type=lite:最快、最省
  • advanced 2 积分:type=auto:Exa 默认档,结果更准
  • deep 4 积分: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
  • basic 4 积分:Google 网页搜索(engine=google,只有这一档)
Tavily
支持的公共参数
  • num_results → max_results
  • time_range → time_range
  • include_domains → include_domains
  • exclude_domains → exclude_domains
不支持(传了返回 400)

language

depth
  • basic 1 积分:search_depth=basic:普通搜索
  • advanced 2 积分:search_depth=advanced:每个来源给更相关的多段内容
Serper
支持的公共参数
  • num_results → num
  • time_range → tbs(qdr:d / w / m / y)
  • language → hl(zh → zh-cn)
不支持(传了返回 400)

include_domains、exclude_domains

depth
  • basic 1 积分:Google 网页搜索(/search)
AnySearch
支持的公共参数
  • num_results → max_results
不支持(传了返回 400)

time_range、include_domains、exclude_domains、language

depth
  • basic 1 积分:普通网页搜索(只有这一档)
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
  • basic 2 积分:网页搜索
  • advanced 2 积分:给 AI 的正文上下文:每个网页里与问题相关的正文片段
博查
支持的公共参数
  • num_results → count
  • time_range → freshness
  • include_domains → include(仅 basic)
  • exclude_domains → exclude(仅 basic)
不支持(传了返回 400)

language

depth
  • basic 1 积分:网页搜索
百度
支持的公共参数
  • num_results → resource_type_filter 的 web top_k
  • time_range → search_recency_filter(week / month / year)
  • include_domains → search_filter.match.site(仅 basic)
不支持(传了返回 400)

exclude_domains、language

depth
  • basic 1 积分:百度搜索
  • advanced 3 积分:AI 搜索(生成答案)

depth 在各家的含义与扣分

depth 决定走该引擎的哪个接口、哪一档;扣分读自实时价目表。

depthExaSerpApiTavilySerperAnySearchBrave博查百度
basic默认1 积分type=lite:最快、最省/v1/exa/search4 积分Google 网页搜索(engine=google,只有这一档)/v1/serpapi/search1 积分search_depth=basic:普通搜索/v1/tavily/search1 积分Google 网页搜索(/search)/v1/serper/search1 积分普通网页搜索(只有这一档)/v1/anysearch/search2 积分网页搜索/v1/brave/web/search1 积分网页搜索/v1/bocha/web-search1 积分百度搜索/v1/baidu/web-search
advanced2 积分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
deep4 积分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 目录)。

下载 SKILL.md Markdown 版文档

发给 Agent 的一段话
请用「聚搜GO」帮我联网搜索。
密钥:【把控制台里复制的 API Key 粘贴到这里】(只用于该服务,不要外传)
说明:https://jusouai.cn/skill.md (先读完再调用);
想用某家就指定 engine(exa / serpapi / tavily / serper / anysearch / brave / bocha / baidu),不指定则用默认引擎,想对比就传 engines;
只有需要我确认时再问我(比如一次要花较多积分)。