> ## 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

# Agno web search toolkit

> Give Agno agents web search and page reading with KeenableTools, a toolkit built into Agno, with no API key required.

*Toolkit in Agno*

`KeenableTools` gives Agno agents Keenable web search and page reading. It ships in [Agno](https://github.com/agno-agi/agno) itself, so there is nothing extra to install, and it runs without an API key.

→ [KeenableTools in the Agno repository](https://github.com/agno-agi/agno/blob/main/libs/agno/agno/tools/keenable.py)

## Install

`KeenableTools` ships in Agno 3.1.5 and later:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
pip install -U "agno>=3.1.5" openai
```

The examples use Agno's default OpenAI model, so set `OPENAI_API_KEY`, or pass any other model to `Agent(model=...)`.

## Give it to an agent

Add `KeenableTools()` to the agent's tools:

```python theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
from agno.agent import Agent
from agno.tools.keenable import KeenableTools

agent = Agent(tools=[KeenableTools()], markdown=True)
agent.print_response("What changed in the latest Python release?")
```

`KeenableTools()` registers the `web_search` tool. Each result has its title, URL and the first 500 characters of the page text. Results come back as markdown, or as JSON if you pass `format="json"`.

## Search and read pages

Pass `all=True` to let the agent read pages too:

```python theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
agent = Agent(tools=[KeenableTools(all=True)], markdown=True)
agent.print_response("Find the Agno docs page on toolkits and summarize it, with the link")
```

`all=True` adds `fetch_url_content`, which returns a page's main content as markdown under its title. Requests to private and internal addresses are refused. Async variants are registered under the same names, so `agent.arun()` and `agent.aprint_response()` work unchanged.

## Options

| Parameter | Default | What it does |
| - | - | - |
| `api_key` | `None` | Keenable API key. If unset, the toolkit reads `KEENABLE_API_KEY`. If neither is set, it uses the keyless public endpoints. |
| `enable_search` | `True` | Register `web_search`. |
| `enable_fetch` | `False` | Register `fetch_url_content`. |
| `all` | `False` | Register both. |
| `max_results` | `5` | Default number of search results. The agent can ask for a different number per call. |
| `max_snippet_chars` | `500` | Page text kept per result. `0` keeps it all. |
| `format` | `"markdown"` | `"markdown"` or `"json"` for search results. |
| `timeout` | `30` | Request timeout in seconds. |

> [!NOTE]
>
> Without a key, calls run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). Set `KEENABLE_API_KEY`, or pass `KeenableTools(api_key=...)`, to use your organization's limits and remove the hourly cap.

## Related pages

> [card] [AG2](https://docs.keenable.ai/integrations/ag2.md)
>
> Give AG2 agents web search and page fetch with KeenableSearchToolkit, built into AG2 1.2.2 and later, with no API key required.

> [card] [Vercel AI SDK](https://docs.keenable.ai/integrations/vercel.md)
>
> Keyless web search and page fetch for the Vercel AI SDK (`@keenable/ai-sdk`), plus Vercel Connect to keep the API key out of environment variables.

> [card] [Composio](https://docs.keenable.ai/integrations/composio.md)
>
> Keenable as a Composio toolkit: your agent searches the web and reads pages through Composio, next to the other apps it uses there.

> [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.