Skip to main content
Search provider plugin Give your Hermes agent Keenable web search and page extraction through web-search-plus, a community plugin that adds Keenable as a provider. → View the change on GitHub Install the plugin, pin Keenable as the default provider, and run a first search.

Install

Install and enable the plugin

After the first install, restart Hermes once so the tools register.

Pin Keenable as the default provider

Run set-default to send every search through Keenable. This also turns off the plugin’s auto-routing. After that, both the web_search_plus agent tool and the standalone search.py (when you run it without --provider) use Keenable.

Authenticate

Since version 5.1, the plugin reads provider keys from your Hermes profile. Store the key there:
In the interactive Hermes CLI, run /reload to apply it.
Set KEENABLE_API_KEY to remove the hourly request cap. To run without a key, turn on the plugin’s public-tier flag, which is off by default: run hermes config set KEENABLE_ALLOW_PUBLIC 1. Under Hermes, the plugin ignores keenable.allow_public in config.json. Without a key, searches run on the shared public tier at lower rate limits.

Check the pin

Run setup.py config show and check that the default provider is keenable.

Hermes Agent

Keenable is built into Hermes Agent as a web backend for web_search and web_extract, and works without a key.

WeKnora (Tencent)

Use Keenable as a built-in web search provider in Tencent WeKnora, set up in the settings or over the API. Works without an API key.

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.