@keenable/dsh-keenable

Keenable for DeepSeek Harness

Web search and page reading for DeepSeek Harness through Keenable, with no API key and no account. It works with whatever model you run in Harness, local models included.

The plugin points Harness's built-in web_search and web_fetch tools at Keenable. It adds no new tools: the model asks for a query or a URL exactly as before, and Keenable answers.

Why

The search provider Harness ships with needs a DeepSeek account or a DeepSeek API key. With a local or third-party model and neither of those, web_search fails. Keenable's public endpoints need no key, so search works on a fresh install:

• web_search returns ranked web results with an excerpt of each page and its publication date, when known.
• web_fetch returns a page as markdown. The page is retrieved on Keenable's servers, so a URL the model chose is never requested from the machine running Harness, and private or internal hosts are refused.

An API key is optional. It only lifts the rate limit described below.

Install

Requires DeepSeek Harness 0.1.7-rc.2 or later and Node.js 22.12 or later.

From Harness: open Plugins → Add plugin, enter @keenable/dsh-keenable, then Install → Enable now.

From the terminal: install into the profile you use, then restart Harness:

npx @deepseek-ai/dsh plugin --profile web add @keenable/dsh-keenable
npx @deepseek-ai/dsh web

Profiles are separate: web, tui and headless each need their own install. Replace web with the profile you run.

Then ask your model to search the web. No further setup is needed.

Limits and the optional API key

Without a key, requests go to Keenable's public endpoints, limited to 10 requests per second and 1,000 per hour per IP address. Search and fetch are counted separately. Everyone behind the same network address shares the limit, so a busy office or CI runner can reach it; the tool error then says so.

A key lifts the limit. Create one in the Keenable console, then either:

• set KEENABLE_API_KEY in the environment Harness starts in, or
• enter it as apiKey in this plugin's settings on the Plugins page.

A key in the settings wins over the environment variable.

Settings

Setting	Default	Meaning
apiKey	$KEENABLE_API_KEY	Optional. Switches both tools to the authenticated endpoints.
maxSnippetChars	500	Excerpt length per search result, 180 to 10,000 characters.
fetchLive	true	Fetch pages live from the source. When off, web_fetch returns Keenable's indexed copy and fails for pages it has not indexed.
maxBodyChars	100000	Maximum characters of page text web_fetch returns. Longer pages are cut and marked as truncated.
baseURL	https://api.keenable.ai	API origin. HTTPS only.

Keeping the local fetch provider

The plugin pins both capabilities to Keenable. To keep Harness's local HTTP fetch provider and use Keenable for search only, override the web row in your profile's cordis.patch.yml:

- id: web
  config:
    searchProvider: keenable
    fetchProvider: http

Both fields are needed: a config patch replaces the row's whole config object.

Privacy

Search queries and fetched URLs are sent to Keenable, even when your model runs locally. Requests identify the plugin with an X-Keenable-Title: dsh-keenable header, which the public endpoints require. Results are external content, and Harness marks them as untrusted data for the model.

Troubleshooting

Symptom	What to check
WEB_PROVIDER_CONFIGURED_MISSING	The plugin is not loaded in this profile. Install it into the profile you run, and restart Harness.
"requests share a per-IP limit"	The keyless limit was reached. Wait, or set an API key.
"Fetching from private/internal hosts is not allowed"	Keenable does not fetch localhost or private addresses. Use the local HTTP fetch provider for those (see above).
Search still asks for DeepSeek credentials	Another patch layer pins searchProvider back. Check the composed profile with npx @deepseek-ai/dsh --profile web --dump-config.

Development

npm ci
npm test            # offline: providers, plugin registration, model-facing tools, manifest
npm run test:live   # real Keenable API, no key

The tests load the plugin into a real Cordis context with Harness's own dsh-web seam and web_search/web_fetch tools. The code is plain JavaScript and needs no build step.

License

MIT