@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 readprocess.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:
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).
Related pages
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.