# searchSDK

> Alpha TypeScript search SDK with explicit normalized web-search adapters and separate native clients. Install the prerelease in your Node server with `npm install @belweave/search-sdk@alpha`; alpha APIs may change before a stable release.

Provider requests belong on your server. Documentation and deterministic fixtures establish local contracts, not live availability, quality, latency, or pricing. WonderSearch retrieves a private corpus rather than the open web.

## Start here

- [Introduction](https://searchsdk.dev/docs/index.md): A TypeScript SDK for web retrieval. Choose a provider, preserve source identity, and make failure behavior explicit.
- [Installation](https://searchsdk.dev/docs/installation.md): Install the alpha package, configure server-only credentials, and run on Node 24.
- [Your first search](https://searchsdk.dev/docs/quickstart.md): Run a key-free fixture first, then configure a real provider on your server.
- [MCP and agent access](https://searchsdk.dev/docs/guides/mcp.md): Read documentation, provider capabilities, examples, and one integration skill through the public, unauthenticated MCP endpoint.
- [Provider reference](https://searchsdk.dev/docs/providers.md): All 15 providers, with explicit boundaries between web results, provider-native operations, and corpus retrieval.
- [web.search](https://searchsdk.dev/docs/api/search.md): The portable request for ranked web results, with capability checks before dispatch.
- [Provider-native transport](https://searchsdk.dev/docs/api/native-transport.md): Use fixed-origin operations with typed inputs, bounded responses, explicit retries, and sanitized metadata.
- [Verification and limits](https://searchsdk.dev/docs/reliability/verification.md): Read validation claims at the right evidence level and evaluate providers on your workload.

## Catalogs

- [All articles and canonical Markdown URLs](https://searchsdk.dev/agent-index.json): Small searchSDK-specific content index, including MCP endpoint details.
- [Provider capabilities](https://searchsdk.dev/provider-capabilities.json): SDK limits and native operation catalogs, generated from source.
- [Documentation, providers, and examples](https://searchsdk.dev/mcp-public-data.json): Full searchSDK-specific dataset used by the read-only MCP tools.

## Optional

- [Integration workflow skill](https://searchsdk.dev/skills/searchsdk/SKILL.md): One curated Agent Skill, also available through the official MCP Skills extension.
- [All documentation in one file](https://searchsdk.dev/llms-full.txt): Convenience concatenation; fetch individual articles when possible.
- [Website overview](https://searchsdk.dev/index.md): Public routes and entry points.
- [Benchmark methodology draft](https://searchsdk.dev/benchmark-methodology.json): No measured scores are published.