Skip to main content
Toolkit in AG2 KeenableSearchToolkit gives AG2 agents two tools: keenable_search for web search and keenable_fetch for reading a page as markdown. It ships in AG2 itself and talks to the Keenable REST API over httpx, which AG2 already depends on, so there is no extra package. It runs without an API key. → KeenableSearchToolkit in the AG2 repository · AG2’s Keenable Search page

Install

KeenableSearchToolkit ships in AG2 1.2.2 and later. Install AG2 with the extra for your model provider. The example uses OpenAI:
Current AG2 releases need Python 3.11 or later. Set OPENAI_API_KEY for the model, or pass another provider’s config to Agent(config=...).

Give it to an agent

Add KeenableSearchToolkit() to the agent’s tools. It registers both keenable_search and keenable_fetch:
The reply cites the pages the agent found. Each keenable_search result has title, url, snippet and acquired_at, the time Keenable last indexed the page. keenable_fetch returns the page’s url, title, content as markdown, author and published_at. The last two are empty when unknown.

Give it search only

Each tool is a factory method on the toolkit. Pass only toolkit.search() to keep the agent to one site and a set number of results:
toolkit.fetch() returns the fetch tool on its own. Both methods also take name and description to rename the registered tool.

Options

If Keenable returns an error, the tool raises httpx.HTTPStatusError with Keenable’s error message. On 429, the message includes the Retry-After value. See Errors.
Without a key, calls run on the shared public tier at lower rate limits. Set KEENABLE_API_KEY, or pass KeenableSearchToolkit(api_key=...), to use your organization’s limits and remove the hourly cap. See API keys.

Composio

Keenable as a Composio toolkit: your agent searches the web and reads pages through Composio, next to the other apps it uses there.

Agno

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

CrewAI

Give CrewAI agents Keenable web search with the official SDK. Keyless by default.

Overview

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.