跳转到主体内容

信息源目录 (Sources Catalog) ​

nb-search 内置支持 18 个搜索源(Search Lanes)与 9 个内容抓取管道(Fetch Pipelines)。本地文档转换与 Markdown/资源保存请使用独立的 nb-extract 工具。这些源依据用途场景、成本结构、延迟特征与输出通道进行分类。

维度说明

表格中的相对成本(free / cheap / expensive)和相对延迟(fast / medium / slow)属于运行时配置内严格声明的定性元数据标签,便于上层编排器进行粗粒度选择,并非真实账单计费依据或基准跑分。

用途分组与配置选择建议 ​

根据官方内置用途指引(src/lane-guidance.ts),能力按业务目标划分为三个主要分组。这些分组反映的是使用场景与接入路径,而非质量高低的等级排序:

  1. 入门通用检索与原文 (onboarding):
    • 配置建议:0.5.0 及以上版本默认使用免密钥的 duckduckgo.search 检索通用网页;公共 HTML 页面可能出现验证或限流,工具会如实报告错误而不会伪装为空结果。仓库检索和文档上下文可显式选择 github.repositories、context7.docs。也可配置 tavily.search、brave.search、exa.search 等来源并设为 defaults.search_lane;显式默认和选择优先,失败不会静默切换来源。抓取默认开启 kiki-common-direct@1 有序 URL 路由(已知 GitHub Raw/API、npm、PyPI 元数据仅走 direct.fetch),其余公共 URL 先用 direct.fetch(Defuddle),失败时尝试免密的 jina.reader。
    • 典型源:duckduckgo.search、brave.search、exa.search、tavily.search、parallel.search、searxng.search、zhipu.search,抓取管道包含 direct.fetch 与 jina.reader。
  2. 按需专题能力 (specialist):
    • 配置建议:针对特定类型数据、网页提取或受控环境显式选用,通常通过 --lane、--lanes 或 --pipeline 直接指定,而非作为全网兜底。
    • 典型源:
      • 代码与工程:github.repositories(仓库检索)、context7.docs(框架文档上下文)。
      • 深度网页/社交:firecrawl.search(带提取内容的搜索)、grok.x-synthesis(针对 X 平台的讨论提炼)。
      • 专用抓取:exa.contents、tavily.extract、firecrawl.scrape、direct.local(兼容的本地免网文件与行内清洗)、wayback.fetch(历史快照)、browser.render(无头 Chromium 渲染)、oac.fetch(模型总结抽取)。
  3. 综合与深度研究 (research):
    • 配置建议:需要模型进行多步推演、生成综合分析或结构化报告的场景。此类源调用开销与延迟相对较高,必须以单个 Lane 显式发起,不支持放入多源 Results Preset。
    • 典型源:exa.synthesis、tavily.synthesis、grok.synthesis、gma.research、oac.synthesis。

诊断与能力查询

在本地运行 node scripts/nb-search.mjs --doctor 可输出包含用途分组指引的配置就绪摘要;调用 capabilities 可查看各源实时的端口激活与支持模式。注意下表中列出的“支持模式”适用于默认未注入自定义 http_transport 的标准本地运行时;若宿主显式注入了自定义 transport,所有异步模式将被禁用。readiness 仅反映本地配置完整度,并非外部上游的在线可用性探测。

18 个搜索源 (Search Lanes) ​

内置 18 个搜索源分布在不同的底层 Provider 与操作中:

Lane 标识Provider / 操作输出通道与 Schema支持模式 (就绪时)必需凭据与端点配置相对成本 / 延迟特征与端点约定
brave.searchbrave/searchResults (nb-search.results@1)sync, async必需 NB_SEARCH_BRAVE_API_KEY;Base URL 可选cheap / fast独立网页搜索索引,端点补全 /res/v1/web/search
exa.searchexa/searchResults (nb-search.results@1)sync, async必需 NB_SEARCH_EXA_API_KEY;Base URL 可选cheap / fast神经搜索,端点补全 /search
exa.synthesisexa/synthesisTyped (nb-search.synthesis@1)sync, async必需 NB_SEARCH_EXA_API_KEY;Base URL 可选expensive / medium提炼型搜索,返回综合段落与引用
tavily.searchtavily/searchResults (nb-search.results@1)sync, async必需 NB_SEARCH_TAVILY_API_KEY;Base URL 可选cheap / fast面向 Agent 优化的搜索,端点补全 /search
tavily.synthesistavily/synthesisTyped (nb-search.synthesis@1)sync, async必需 NB_SEARCH_TAVILY_API_KEY;Base URL 可选cheap / medium返回带直接答案回答的提炼型结果
tavily.crawltavily/crawlTyped (nb-search.crawl@1)sync, async必需 NB_SEARCH_TAVILY_API_KEY;Base URL 可选cheap / slow官方 Crawl POST,返回有界 Markdown 文档集合
tavily.researchtavily/researchTyped (nb-search.research@1)sync, async必需 NB_SEARCH_TAVILY_API_KEY;Base URL 可选expensive / slow官方 Research Task POST/GET 轮询,返回内容与来源
firecrawl.searchfirecrawl/searchResults (nb-search.results@1)sync, async必需 NB_SEARCH_FIRECRAWL_API_KEY;Base URL 可选cheap / fast搜索接口,端点补全 /v2/search
searxng.searchsearxng/searchResults (nb-search.results@1)sync, async无需 Key;必需 NB_SEARCH_SEARXNG_BASE_URLfree / medium自建或私有聚合搜索实例,端点补全 /search
zhipu.searchzhipu/searchResults (nb-search.results@1)sync, async必需 NB_SEARCH_ZHIPU_API_KEY;Base URL 可选cheap / fast智谱 Web Search,端点补全 /paas/v4/web_search
parallel.searchparallel/searchResults (nb-search.results@1)sync, async必需 NB_SEARCH_PARALLEL_API_KEYcheap / fast固定端点 https://api.parallel.ai/v1/search
github.repositoriesgithub/repositoriesResults (nb-search.results@1)sync, asyncNB_SEARCH_GITHUB_TOKEN 可选free / fast按需仓库检索;无 Token 易受匿名频控限制
duckduckgo.searchduckduckgo/searchResults (nb-search.results@1)sync, async无需凭据或自建端点free / medium零配置默认通用网页搜索;公共 HTML 检索,遇到验证或限流直接报错
context7.docscontext7/docsTyped (nb-search.docs-context@1)sync, asyncNB_SEARCH_CONTEXT7_API_KEY 可选cheap / medium框架与代码库文档上下文提取,无 Key 时按公用模式调用
grok.synthesisgrok/synthesisTyped (nb-search.synthesis@1)sync, async必需 NB_SEARCH_GROK_API_KEY;Base/Model 可选expensive / slow基于 xAI Grok Responses API,启用 web_search 工具
grok.x-synthesisgrok/x-synthesisTyped (nb-search.synthesis@1)sync, async必需 NB_SEARCH_GROK_API_KEY;Base/Model 可选expensive / slow基于 xAI Grok Responses API,启用 x_search 工具
gma.researchgrok-multi-agent/researchTyped (nb-search.multi-agent-research@1)sync, async必需 NB_SEARCH_GROK_API_KEY + NB_SEARCH_GROK_MULTI_AGENT_BASE_URLexpensive / slow深度多代理推演,支持 chat_completions 与 messages 模式
oac.synthesisopenai-compatible/synthesisTyped (nb-search.synthesis@1)sync, async必需 NB_SEARCH_OAC_API_KEY + NB_SEARCH_OAC_BASE_URL + NB_SEARCH_OAC_MODELexpensive / slow基于 OpenAI 兼容 Chat Completions 的结构化综合回答

9 个抓取管道 (Fetch Pipelines) ​

Pipeline 标识Provider / 操作适用输入与输出支持模式 (就绪时)凭据与依赖要求相对成本 / 延迟默认抓取链位置与说明
direct.fetchdirect-http/fetchURL -> nb-search.fetch@1sync, async无需凭据,直接 HTTP 请求free / fast默认 URL 抓取链第 1 位;Defuddle 静态提取 HTML、JSON 与 GitHub API 文本
jina.readerjina-reader/readerURL -> nb-search.fetch@1syncNB_SEARCH_JINA_API_KEY 可选free / medium默认 URL 抓取链第 2 位;正文提取与 Markdown 转换
direct.localdirect-http/localinline / file -> nb-search.fetch@1sync, async无需凭据;file 需配置 file_scopesfree / fast默认 inline/file 抓取链唯一项;不出网 (egress: none)
exa.contentsexa/contentsURL -> nb-search.fetch@1sync必需 NB_SEARCH_EXA_API_KEYcheap / fast需显式指定或自定义 chain;调用 Exa 内容提取端点 /contents
tavily.extracttavily/extractURL -> nb-search.fetch@1sync必需 NB_SEARCH_TAVILY_API_KEYcheap / fast需显式指定或自定义 chain;调用 Tavily 页面提取端点 /extract
firecrawl.scrapefirecrawl/scrapeURL -> nb-search.fetch@1sync必需 NB_SEARCH_FIRECRAWL_API_KEYcheap / medium需显式指定或自定义 chain;调用 Firecrawl 抓取端点 /v2/scrape
wayback.fetchwayback/fetchURL -> nb-search.fetch@1sync无需凭据;自动查询 Wayback 归档快照free / medium需显式指定或自定义 chain;适用于页面已下线或需要历史快照的场景
browser.renderbrowser-render/renderURL -> nb-search.fetch@1async依赖 Playwright + Chromium;仅支持异步free / slow需显式指定或自定义 chain;通过浏览器内核渲染客户端 JavaScript 页面
oac.fetchopenai-compatible/fetchURL -> nb-search.fetch@1sync必需 OAC Key + Base URL + Modelexpensive / slow需显式指定或自定义 chain;使用兼容模型对页面内容进行归纳提取

显式启用与自定义扩展源 (Opt-in & Custom) ​

以下内置适配器不会自动创建默认实例或默认通道,需在 config.json 或宿主代码中显式声明后启用:

  • 知乎内置源 (provider_id: "zhihu"):支持社区问答与专栏检索(zhihu.search)、中文全网检索(zhihu.global)以及直达综合回答(zhihu.synthesis),内置 GET /api/v1/quota 免费额度门禁(默认 allow_paid: false)与本地 keyUsage() 指标。完整 Schema v4 配置见网页搜索源:显式启用知乎。
  • 本地脚本源 (provider_id: "script") 与 SDK 自定义注册:将可信本地 .js/.mjs/.ts/.mts 模块绑定为支持 sync 与 detached async 的标准搜索通道,或通过 ProviderRegistration 在宿主进程内注入自定义适配器。详见自定义源与脚本 Lane。

基于 MIT 协议开源 · AI 索引: /nb-search/llms.txt