> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keenable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Every page is listed in https://docs.keenable.ai/llms.txt. To pick a product for a job, read https://docs.keenable.ai/choose.md
> Setup steps for agents, covering the SDKs, the MCP server and the CLI: https://docs.keenable.ai/skill.md
> Keenable search and fetch work without an API key. To add them to code, use the official SDK for the project's language: https://docs.keenable.ai/sdks.md
> Without a key, call POST https://api.keenable.ai/v1/search/public or GET https://api.keenable.ai/v1/fetch/public with an X-Keenable-Title header that names your app.
> With a key, send it in the X-API-Key header and read it from the KEENABLE_API_KEY environment variable. Never ask a user to paste a key into chat. Every access method: https://docs.keenable.ai/auth.md
> To get an API key without the console, use device login: https://docs.keenable.ai/authentication.md#device-login
> MCP server: https://api.keenable.ai/mcp (no key, or X-API-Key; keyless Codex uses https://api.keenable.ai/mcp-public), or https://api.keenable.ai/mcp-oauth for OAuth sign-in. These docs are an MCP server at https://docs.keenable.ai/mcp and the OpenAPI spec is at https://docs.keenable.ai/api-reference/openapi.json
> Keenable searches and fetches public web pages. If a question needs no web information, skip the call.
> On 402 with an API key (code insufficient_credits), stop and ask a human to add credits; don't retry. On 429, wait the number of seconds in Retry-After, then retry. Before you ship, follow https://docs.keenable.ai/production.md
> Every error, with its cause and fix, is in https://docs.keenable.ai/errors.md and moving from another search API is covered in https://docs.keenable.ai/migrate.md
> Before you compare Keenable with another search API, read https://docs.keenable.ai/guides/evaluate-search-apis.md

# ToolUniverse web search backend

> Select Keenable as the backend of ToolUniverse's web_search tool with backend="keenable", in ToolUniverse 1.5.9 and later. No API key required.

*web\_search backend*

ToolUniverse's `web_search` tool can send its queries to Keenable: pass `backend="keenable"` in the call. [ToolUniverse](https://github.com/mims-harvard/ToolUniverse) builds AI scientist systems from 2,700+ tools, and Keenable is one of its opt-in hosted search backends. It runs without an API key. The default `auto` chain doesn't use Keenable, so nothing changes until you select it.

→ [The Keenable backend in the ToolUniverse repository](https://github.com/mims-harvard/ToolUniverse/blob/main/src/tooluniverse/web_search_tool.py)

## Install

The Keenable backend ships in ToolUniverse 1.5.9 and later. ToolUniverse recommends installing with `uv`:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
uv venv --python 3.12 && source .venv/bin/activate
uv pip install "tooluniverse>=1.5.9"
```

## Search with Keenable

Load the web search tools, then call `web_search` with `backend` set to `"keenable"`:

```python theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
from tooluniverse import ToolUniverse

tu = ToolUniverse()
tu.load_tools(categories=["web_search_tools"])

result = tu.run({
    "name": "web_search",
    "arguments": {
        "query": "AlphaFold 3 protein structure prediction",
        "backend": "keenable",
        "max_results": 5,
    },
})
print(result["data"]["results"])
```

The response has `status` and a `data` object. `data["results"]` is the ranked result list, where each result has `title`, `url`, `snippet` and `rank`, and `data["backend_used"]` says which engine answered. Each snippet is Keenable's short page summary, or the first 500 characters of the page text when there is none.

`web_api_documentation_search`, the second tool in the same category, takes `backend="keenable"` too.

## Arguments

| Argument | Default | What it does |
| - | - | - |
| `query` | Required | The search query. |
| `backend` | `"auto"` | Set to `"keenable"` to search with Keenable. |
| `max_results` | `10` | Number of results, from 1 to 50. |
| `region` | `"us-en"` | Leave it at the default. With the Keenable backend, any other value returns a `status: "error"` response. |
| `safesearch` | `"moderate"` | Leave it at the default. With the Keenable backend, any other value returns a `status: "error"` response. |

If Keenable fails or returns nothing, ToolUniverse falls back to its `auto` chain, and `data["provider_errors"]` holds Keenable's error. With the Keenable backend, the query goes to `https://api.keenable.ai`, so don't send sensitive or patient-identifying information. See [Data privacy](https://docs.keenable.ai/data-privacy.md).

> [!NOTE]
>
> If `KEENABLE_API_KEY` isn't set, the backend calls `/v1/search/public` on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). Set `KEENABLE_API_KEY` to use your organization's limits and remove the hourly cap. See [API keys](https://docs.keenable.ai/api-keys.md).

## Related pages

> [card] [RL and eval environments](https://docs.keenable.ai/integrations/rl-eval-environments.md)
>
> Use Keenable as the search backend in SkillOpt OfficeQA rollouts and Halo GRPO search environments: one config value, opt-in, never a default.

> [card] [Spider](https://docs.keenable.ai/integrations/spider.md)
>
> Search the web from the Spider Rust crawler with KeenableProvider, behind the search\_keenable feature. Works without an API key.

> [card] [AgentField](https://docs.keenable.ai/integrations/agentfield.md)
>
> Run AgentField's deep research example on Keenable web search with SEARCH\_PROVIDER=keenable. No account or API key needed.

> [card] [Tool calling](https://docs.keenable.ai/tool-calling.md)
>
> Give an LLM web search and page fetch as tools. Pass the SDK's TOOLS to any OpenAI-compatible chat completions client and run each call with run\_tool\_call.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.