# @nb-corp/nb-search (v0.5.2) > Unified web search, URL-to-Markdown extraction, Reciprocal Rank Fusion (RRF), 32-key failover, and detached async deep research — shipped as a 3-tool MCP server (~1.4k tokens), Agent Skill (~110 idle tokens), CLI, and TypeScript SDK (Node.js >= 24.15, MIT). - Install CLI / Skill: `npm install -g @nb-corp/nb-search` - Install TypeScript SDK: `npm install @nb-corp/nb-search` - Run MCP Server (stdio): `npx -y --package=@nb-corp/nb-search nb-search-mcp` - Complete Single-File Documentation Corpus: [llms-full.txt](https://nb-corp.github.io/nb-search/llms-full.txt) - Repository: [GitHub NB-Corp/nb-search](https://github.com/NB-Corp/nb-search) · [npm @nb-corp/nb-search](https://www.npmjs.com/package/@nb-corp/nb-search) ## Overview - [nb-search Overview & Quick Start](https://nb-corp.github.io/nb-search/en/): Zero-key CLI, 3-tool MCP (~1.4k tokens), Agent Skill (~110 idle tokens), RRF fusion, 32-key failover, and comparison matrix. ## Guides - [Quick Start](https://nb-corp.github.io/nb-search/en/guide/quickstart): Node.js >= 24.15 setup, zero-key DuckDuckGo/Defuddle verification, Skill mounting, and BYOK RRF search. - [Configuration & Multi-Key Rotation](https://nb-corp.github.io/nb-search/en/guide/configuration): Schema v4 config precedence, environment variables, 32-key rotation (round-robin/priority), 429/402 failover, and local SDK keyUsage(). - [Integrations: SDK, CLI, MCP & Skill](https://nb-corp.github.io/nb-search/en/guide/integrations): TypeScript SDK (search, fetch, capabilities, keyUsage), CLI --stdin, npx nb-search-mcp stdio config, Agent Skill, and Remote HTTP client. - [Web Search & RRF Fusion](https://nb-corp.github.io/nb-search/en/guide/search): Results (nb-search.results@1) vs Typed channels, URL canonicalization, Reciprocal Rank Fusion (RRF), and provenance. - [URL-to-Markdown & Routing](https://nb-corp.github.io/nb-search/en/guide/fetch): Defuddle direct.fetch, ordered URL routing (kiki-common-direct@1), fallback chains, SSRF IP pinning, and byte limits. - [Detached Async Jobs](https://nb-corp.github.io/nb-search/en/guide/jobs): Idempotent run/get/read/cancel lifecycle, --wait budgets, immutable SHA-256 chunk reconstruction via read --all, and 72h retention. - [Troubleshooting & Exit Codes](https://nb-corp.github.io/nb-search/en/guide/troubleshooting): CLI exit codes (0/2/3/4/5/6/7), error diagnostics, --doctor offline checks, and capabilities inspection. - [Upgrading Guide](https://nb-corp.github.io/nb-search/en/guide/upgrading): Compatibility notes across 0.3, 0.4, and 0.5.x (zero-key default search, Defuddle direct.fetch, opt-in Zhihu, and adapter fingerprints). ## Supported Sources - [Sources Catalog (18 Search Lanes + 9 Fetch Pipelines + Opt-in)](https://nb-corp.github.io/nb-search/en/sources/): Complete cost, latency, schema, credential, and execution-mode matrix across all built-in and opt-in providers. - [Web & Regional Search](https://nb-corp.github.io/nb-search/en/sources/web-search): DuckDuckGo, Tavily, Exa, Brave, Firecrawl, SearXNG, Zhipu, Parallel, and full opt-in Zhihu schema-4 config & UTC+8 free-quota guard. - [Developer Sources: GitHub & Context7](https://nb-corp.github.io/nb-search/en/sources/developer): Keyless and token-boosted repository search (github.repositories) and library/framework documentation lookup (context7.docs). - [Synthesis & Multi-Agent Research (Grok, GMA, OAC)](https://nb-corp.github.io/nb-search/en/sources/grok): Grok Responses web/X synthesis, Grok Multi-Agent deep research (10-min default deadline), and OpenAI-compatible synthesis. - [Custom Script Lanes & SDK ProviderRegistration](https://nb-corp.github.io/nb-search/en/sources/custom): Trusted local .js/.ts script lanes supporting sync + detached async, plus in-process TypeScript ProviderRegistration. ## Reference & Wire Contracts - [Official CLI Reference](https://nb-corp.github.io/nb-search/en/reference/cli): Complete CLI flags, local/remote profiles, protected secrets.json, --stdin JSON contract, --wait, read --all, and exit codes. - [Runtime & Host Architecture](https://nb-corp.github.io/nb-search/en/reference/runtime): Schema v4 composition, captured host configuration, custom HTTP transport, offline operation resolver, URL routing, and SSRF boundaries. - [Remote HTTP Protocol v1](https://nb-corp.github.io/nb-search/en/reference/remote-protocol): Wire protocol for nb-search-cloud and remote gateways: headers, strict status mapping, idempotency, and URL-only fetch rules. - [Changelog](https://nb-corp.github.io/nb-search/en/reference/changelog): Release history from 0.2.0 through 0.5.2. ## Optional & Sibling Tools - [Agent Skill Protocol (SKILL.md)](https://github.com/NB-Corp/nb-search/blob/main/SKILL.md): Full CLI execution rules, lane selection, URL routing, async job polling, and exit codes for coding agents. - [nb-extract](https://github.com/NB-Corp/nb-extract): Sibling tool for local PDF/Office/OCR conversion to Markdown and webpage media asset export. - [nb-search-cloud](https://github.com/NB-Corp/nb-search-cloud): Self-hosted team gateway implementing nb-search HTTP Protocol v1.