Skip to main content
Convex component @keenable/convex installs into a Convex app’s convex.config.ts and exposes search and fetch as component actions behind a typed client. Both environment variables are optional, so registering the component is the whole setup. You don’t need a key or any environment variables before the first call. → @keenable/convex on npm

Install

Install the package

Register the component

Add the component to your app’s config:

Call it from your own action

Wrap the component in an action your app owns rather than exposing it directly. Put your auth and rate limiting in that wrapper. This action searches and returns the results as numbered sources:
toContext renders results as numbered sources and drops whole sources at the budget rather than cutting one mid-page. keenable.fetch(ctx, { url }) returns the page as markdown with a truncated flag, so a caller can tell a whole page from a truncated one.

Add a key to lift the rate limit

The component can’t read process.env. Convex passes environment variables in through the app, so declare the key on the app and bind it to the component. Replace convex/convex.config.ts with this version:
Then set the key in your Convex deployment:
Binding a key removes the hourly request cap. Without one, calls run on the shared public tier at lower rate limits.

Parameters

search takes site, publishedAfter / publishedBefore, acquiredAfter / acquiredBefore, snippetMaxLength (default 1000) and maxResults. fetch takes contentMaxLength (default 10000).

Dify

Add web search and page fetch to Dify agents and workflows with the Keenable plugin from the Dify Marketplace. Works without an API key.

Tines

Call Keenable web search and page fetch from Tines stories with the HTTP Request action, with no key to start.

Langflow

Add web search and page fetch to the Langflow canvas with the Keenable Search and Keenable Fetch components. Works without an API key.

Search

Search the web with POST /v1/search: ranked results with titles, URLs and snippets, filtered by site, excluded domains, publish date or index date.