Skip to main content
Built-in web provider Give your Rakazo bots web search and page reading with Keenable, a built-in web provider that needs no key. Rakazo is an open source AI agent for persistent teammates that you can self-host. Keenable serves both of Rakazo’s built-in web tools: web_search returns titles, URLs and snippets, and web_fetch returns a page as readable text. → View the change on GitHub

Install

No separate install

Keenable ships with Rakazo v0.3.3 and later. There is no Keenable package to install.

Select Keenable

Rakazo’s default web provider is keyless HTTP search (DuckDuckGo HTML) with local Readability extraction. To switch to Keenable, set these in the deployment’s .env:
Restart both the API and the worker, because each one builds its own web provider. If you don’t set a key, requests are anonymous and Keenable limits them per IP address. If KEENABLE_API_KEY is set on both the API and the worker, Rakazo sends it to Keenable and the per-IP limit no longer applies. To go back to the default, set WEB_PROVIDER=keyless-http or remove the line.

Use it

Ask a bot something that needs the web. The thread shows Searching the web: ... while web_search runs and Reading page: ... while web_fetch reads a page.

How it works

  • web_search calls Keenable’s search_web_pages tool on the hosted MCP server at https://api.keenable.ai/mcp. It returns 5 results by default and up to 10.
  • web_fetch calls fetch_page_content on the same server. It returns 8,000 characters by default, up to 50,000 when the bot asks for more, and marks longer pages as truncated. Rakazo checks that the URL points to a public address before the request leaves your deployment.
  • Keenable receives search queries and the page URLs a bot asks to read, plus an X-Keenable-Title: rakazo header that names the app. Rakazo sends no user, bot or conversation identifiers.
  • Rate-limit and other provider errors go back to the bot as tool errors. Rakazo doesn’t fall back to another provider.
  • A bot’s Disabled tools setting still turns either tool off.

SearXNG

Add Keenable results to a SearXNG instance with the built-in keenable engine (shortcut !keen), enabled in settings.yml.

PipesHub

Use Keenable as the web search provider for PipesHub assistants, from workspace settings or the admin API. No API key needed, in PipesHub 1.1.0 and later.

Vellum Assistant

Keenable as a built-in web-search provider in Vellum Assistant, alongside Brave, Perplexity, Tavily and Firecrawl.

Search quickstart

Give your agent ranked web pages with excerpts ready to cite. Try it with no API key. Code, cost per mode, filters by site, date and domain, and gotchas.