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

# PraisonAI web search tool

> Give PraisonAI agents web search with no API key through keenable_search, a tool in praisonai-tools.

*Tool in praisonai-tools*

`keenable_search` gives PraisonAI agents Keenable web search. It ships in [praisonai-tools](https://github.com/MervinPraison/PraisonAI-Tools), the official tools package for PraisonAI, and runs without an API key.

→ [praisonai-tools on PyPI](https://pypi.org/project/praisonai-tools/)

## Install

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
pip install "praisonai-tools>=0.2.45" praisonaiagents
```

## Give it to an agent

`keenable_search` is a plain function, so pass it in the agent's `tools` list:

```python theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
from praisonaiagents import Agent
from praisonai_tools import keenable_search

agent = Agent(
    instructions="You are a research assistant. Cite the pages you use.",
    tools=[keenable_search],
)

agent.start("What changed in the latest Python release?")
```

Each result is a dict with `title`, `url` and `snippet`, a short excerpt of the page text. The agent picks `max_results` itself (5 by default, up to 50).

## Call it directly

To search outside an agent, use the tool class:

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

results = KeenableSearchTool().search("vector database benchmarks", max_results=5)
for r in results:
    print(r["title"], r["url"])
```

If a search fails, the tool returns a single `{"error": "..."}` item instead of raising an exception, so an agent can read the error and continue.

> [!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 `KeenableSearchTool(api_key=...)`, to use your organization's limits and remove the hourly cap.

## Related pages

> [card] [Scalekit](https://docs.keenable.ai/integrations/scalekit.md)
>
> Keenable MCP as a built-in connector in Scalekit AgentKit: each of your users signs in to Keenable once, and your agent calls search and fetch through Scalekit.

> [card] [OctoTools](https://docs.keenable.ai/integrations/octotools.md)
>
> Give OctoTools solvers web search with Keenable\_Search\_Tool, a tool card in the OctoTools toolbox, with site and date filters and no API key.

> [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] [Overview](https://docs.keenable.ai/sdks.md)
>
> Install the official Keenable SDK for Python, TypeScript, Go or Rust with one command, search with no key, then add fetch, tool calling and Monitors.


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