96 lines
1.9 KiB
Markdown
96 lines
1.9 KiB
Markdown
 
|
# Web Search Providers
|
||
|
|
|
||
|
|
NanoBot supports multiple web search providers. Configure in `~/.nanobot/config.json` under `tools.web.search`.
|
||
|
|
|
||
|
|
| Provider | Key | Env var |
|
||
|
|
|----------|-----|---------|
|
||
|
|
| `brave` (default) | `apiKey` | `BRAVE_API_KEY` |
|
||
|
|
| `tavily` | `apiKey` | `TAVILY_API_KEY` |
|
||
|
|
| `searxng` | `baseUrl` | `SEARXNG_BASE_URL` |
|
||
|
|
| `duckduckgo` | — | — |
|
||
|
|
|
||
|
|
Each provider uses the same `apiKey` field — set the provider and key together. If no provider is specified but `apiKey` is given, Brave is assumed.
|
||
|
|
|
||
|
|
When credentials are missing and `fallbackToDuckduckgo` is `true` (the default), searches fall back to DuckDuckGo automatically.
|
||
|
|
|
||
|
|
## Examples
|
||
|
|
|
||
|
|
**Brave** (default — just set the key):
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"tools": {
|
||
|
|
"web": {
|
||
|
|
"search": {
|
||
|
|
"apiKey": "BSA..."
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
**Tavily:**
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"tools": {
|
||
|
|
"web": {
|
||
|
|
"search": {
|
||
|
|
"provider": "tavily",
|
||
|
|
"apiKey": "tvly-..."
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
**SearXNG** (self-hosted, no API key needed):
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"tools": {
|
||
|
|
"web": {
|
||
|
|
"search": {
|
||
|
|
"provider": "searxng",
|
||
|
|
"baseUrl": "https://searx.example"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
**DuckDuckGo** (no credentials required):
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"tools": {
|
||
|
|
"web": {
|
||
|
|
"search": {
|
||
|
|
"provider": "duckduckgo"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Options
|
||
|
|
|
||
|
|
| Key | Type | Default | Description |
|
||
|
|
|-----|------|---------|-------------|
|
||
|
|
| `provider` | string | `"brave"` | Search backend |
|
||
|
|
| `apiKey` | string | `""` | API key for the selected provider |
|
||
|
|
| `baseUrl` | string | `""` | Base URL for SearXNG (appends `/search`) |
|
||
|
|
| `maxResults` | integer | `5` | Default results per search |
|
||
|
|
| `fallbackToDuckduckgo` | boolean | `true` | Fall back to DuckDuckGo when credentials are missing |
|
||
|
|
|
||
|
|
## Custom providers
|
||
|
|
|
||
|
|
Plugins can register additional providers at runtime via the dispatch dict:
|
||
|
|
|
||
|
|
```python
|
||
|
|
async def my_search(query: str, n: int) -> str:
|
||
|
|
...
|
||
|
|
|
||
|
|
tool._provider_dispatch["my-engine"] = my_search
|
||
|
|
```
|