7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.
TypeScript
feat(search): Keenable as a keyless web search engine (#1594)
Ilya Bogin7c9e26f29b5e
diff --git a/client/src/components/command-palette.tsx b/client/src/components/command-palette.tsxindex cbb12e0e..0998413a 100644--- a/client/src/components/command-palette.tsx+++ b/client/src/components/command-palette.tsx@@ -114,7 +114,7 @@ export function CommandPalette() {{ id: 'p-audio', group: 'pages', label: t('models.audioTab'), keywords: 'models audio speech tts stt transcription whisper', icon: AudioLines, run: go('/models/audio') },{ id: 'p-embeddings', group: 'pages', label: t('models.embeddingsTab'), keywords: 'models embeddings vectors', icon: Layers, run: go('/models/embeddings') },{ id: 'p-decision', group: 'pages', label: t('decision.tab'), keywords: 'models decision classify choice yes no score clef mercury', icon: Scale, run: go('/models/decision') },- { id: 'p-search', group: 'pages', label: t('search.tab'), keywords: 'models search web tavily exa firecrawl linkup parallel', icon: Globe, run: go('/models/search') },+ { id: 'p-search', group: 'pages', label: t('search.tab'), keywords: 'models search web tavily exa firecrawl linkup parallel keenable', icon: Globe, run: go('/models/search') },{ id: 'p-fusion', group: 'pages', label: t('models.fusionTab'), keywords: 'models fusion synthesis panel judge', icon: Zap, run: go('/models/fusion') },{ id: 'p-playground', group: 'pages', label: t('nav.playground'), keywords: 'playground test chat try', icon: SquareTerminal, run: go('/playground') },{ id: 'p-keys', group: 'pages', label: t('nav.keys'), keywords: 'keys providers api tokens', icon: KeyRound, run: go('/keys') },diff --git a/client/src/lib/routing.ts b/client/src/lib/routing.tsindex 9cb9256b..02f4e983 100644--- a/client/src/lib/routing.ts+++ b/client/src/lib/routing.ts@@ -482,6 +482,7 @@ export const platformColors: Record<string, string> = {linkup: '#10b981',parallel: '#0ea5e9',serpsearch: '#2563eb',+ keenable: '#7c3aed',beatapi: '#8b5cf6',apinex: '#06b6d4',onomeo: '#f97316',diff --git a/client/src/lib/search.ts b/client/src/lib/search.tsindex 406bb157..a3059171 100644--- a/client/src/lib/search.ts+++ b/client/src/lib/search.ts@@ -8,7 +8,7 @@ import type { SearchPlatform as SharedSearchPlatform } from '@freellmapi/shared/// Mirrors SEARCH_PLATFORMS in shared/types.ts. The client only imports types// from shared, so the list is repeated here; the two assertions below fail the// typecheck if either side gains a platform the other lacks.-export const SEARCH_PLATFORMS = ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'serpsearch'] as const+export const SEARCH_PLATFORMS = ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'serpsearch', 'keenable'] as constexport type SearchPlatform = (typeof SEARCH_PLATFORMS)[number]const sharedCoversClient: SharedSearchPlatform = '' as SearchPlatformconst clientCoversShared: SearchPlatform = '' as SharedSearchPlatform@@ -29,6 +29,7 @@ export const SEARCH_PROVIDERS: { value: SearchPlatform; label: string; url: stri{ value: 'linkup', label: 'Linkup (€5 credits/month)', url: 'https://app.linkup.so/api-keys' },{ value: 'parallel', label: 'Parallel (no key needed)', url: 'https://platform.parallel.ai', keyless: true },{ value: 'serpsearch', label: 'SerpSearch (1,000 searches/month)', url: 'https://serpsearch.com/dashboard/api-keys' },+ { value: 'keenable', label: 'Keenable (no key needed)', url: 'https://keenable.ai', keyless: true },]/** Short provider name for chips and badges ("Tavily", not the full label). */diff --git a/server/src/__tests__/providers/search-providers.test.ts b/server/src/__tests__/providers/search-providers.test.tsindex 543d1a4a..096f6484 100644--- a/server/src/__tests__/providers/search-providers.test.ts+++ b/server/src/__tests__/providers/search-providers.test.ts@@ -4,6 +4,7 @@ import { ExaProvider } from '../../providers/exa.js';import { FirecrawlProvider } from '../../providers/firecrawl.js';import { LinkupProvider } from '../../providers/linkup.js';import { ParallelProvider } from '../../providers/parallel.js';+import { KeenableProvider } from '../../providers/keenable.js';import { getProvider } from '../../providers/index.js';// Search platforms (#1174) validate keys without spending search credits and@@ -27,6 +28,7 @@ const cases = [{ provider: new FirecrawlProvider(), url: 'https://api.firecrawl.dev/v2/team/credit-usage', method: 'GET' },{ provider: new LinkupProvider(), url: 'https://api.linkup.so/v1/credits/balance', method: 'GET' },{ provider: new ParallelProvider(), url: 'https://api.parallel.ai/v1/search', method: 'POST' },+ { provider: new KeenableProvider(), url: 'https://api.keenable.ai/v1/search', method: 'POST' },];describe.each(cases)('$provider.name key validation', ({ provider, url, method }) => {@@ -81,8 +83,33 @@ describe('Parallel keyless validation', () => {});});+describe('Keenable keyless validation', () => {+ it('is keyless', () => {+ expect(new KeenableProvider().keyless).toBe(true);+ });++ it('checks the stored sentinel on the public endpoint with the app title, sending no key', async () => {+ const fn = respond(400);+ expect(await new KeenableProvider().validateKey('no-key')).toBe(true);+ const [calledUrl, init] = (fn.mock.calls as unknown as [string, RequestInit][])[0];+ expect(calledUrl).toBe('https://api.keenable.ai/v1/search/public');+ expect((init.headers as Record<string, string>)['X-Keenable-Title']).toBe('freellmapi');+ expect((init.headers as Record<string, string>)['X-API-Key']).toBeUndefined();+ expect(init.body).toBe('{}');+ });++ it('sends a real key as X-API-Key with an empty body, which runs no search', async () => {+ const fn = respond(400);+ expect(await new KeenableProvider().validateKey(' real-key ')).toBe(true);+ const [calledUrl, init] = (fn.mock.calls as unknown as [string, RequestInit][])[0];+ expect(calledUrl).toBe('https://api.keenable.ai/v1/search');+ expect((init.headers as Record<string, string>)['X-API-Key']).toBe('real-key');+ expect(init.body).toBe('{}');+ });+});+describe('registry', () => {it('registers every search platform', () => {- for (const p of ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel'] as const) expect(getProvider(p)?.platform).toBe(p);+ for (const p of ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'keenable'] as const) expect(getProvider(p)?.platform).toBe(p);});});diff --git a/server/src/__tests__/routes/keys.test.ts b/server/src/__tests__/routes/keys.test.tsindex c9eb5cf9..cfbf2ea0 100644--- a/server/src/__tests__/routes/keys.test.ts+++ b/server/src/__tests__/routes/keys.test.ts@@ -412,7 +412,7 @@ describe('Keys API', () => {expect(storedKey(created.id)).toBe('kilo-real-secret');});- it.each(['kilo', 'ovh', 'aihorde', 'parallel'])('POST /api/keys without a key stores one anonymous %s row', async (platform) => {+ it.each(['kilo', 'ovh', 'aihorde', 'parallel', 'keenable'])('POST /api/keys without a key stores one anonymous %s row', async (platform) => {const first = await request(app, 'POST', '/api/keys', { platform });const second = await request(app, 'POST', '/api/keys', { platform, key: ' ' });@@ -425,7 +425,7 @@ describe('Keys API', () => {expect(keys[0]).toMatchObject({ platform, keyless: true, keyOptional: true, exportable: false });});- it.each(['kilo', 'ovh', 'aihorde', 'parallel'])('POST /api/keys stores a real %s key encrypted', async (platform) => {+ it.each(['kilo', 'ovh', 'aihorde', 'parallel', 'keenable'])('POST /api/keys stores a real %s key encrypted', async (platform) => {const { status, body } = await request(app, 'POST', '/api/keys', { platform, key: ` ${platform}-secret-123 `, label: 'mine' });expect(status).toBe(201);diff --git a/server/src/__tests__/services/search.test.ts b/server/src/__tests__/services/search.test.tsindex f4f3db90..2dc6ac15 100644--- a/server/src/__tests__/services/search.test.ts+++ b/server/src/__tests__/services/search.test.ts@@ -233,6 +233,64 @@ describe('search service', () => {});});+ describe('Keenable (keyless)', () => {+ function seedKeenable(): void {+ getDb().prepare(`+ INSERT INTO media_models (platform, model_id, display_name, modality, priority, enabled, quota_label, meta_json)+ VALUES ('keenable', 'keenable-search', 'Keenable Search', 'search', 5, 1, 'Free, no key needed', '{}')+ `).run();+ }+ const hits = { results: [+ { url: 'https://a', title: 'A & B', description: '', snippet: 'one', published_at: '2026-05-05T00:00:00Z' },+ { url: 'https://b', title: '', description: '', snippet: 'x'.repeat(2_000) },+ { url: '', title: 'dropped', description: '', snippet: 'x' },+ ] };++ it('searches the public endpoint with the stored sentinel and maps snippets', async () => {+ seedKeenable();+ addKey('keenable', 'no-key');+ expect(searchAvailable()).toBe(true);+ const fn = mockFetch(() => json(hits));+ const out = await runSearch('node version');+ const [url, init] = calls(fn)[0];+ expect(url).toBe('https://api.keenable.ai/v1/search/public');+ expect((init.headers as Record<string, string>)['X-Keenable-Title']).toBe('freellmapi');+ expect((init.headers as Record<string, string>)['X-API-Key']).toBeUndefined();+ expect(bodyOf(calls(fn)[0])).toEqual({ query: 'node version', max_results: 5 });+ expect(out).toMatchObject({ provider: 'keenable', engine: 'keenable-search' });+ expect(out.results).toEqual([+ { title: 'A & B', url: 'https://a', content: 'one', score: 1 },+ { title: 'https://b', url: 'https://b', content: `${'x'.repeat(1_500)}…`, score: 0.5 },+ ]);+ });++ it('uses the keyed endpoint with X-API-Key when a real key is stored', async () => {+ seedKeenable();+ addKey('keenable', 'real-keenable-key');+ const fn = mockFetch(() => json(hits));+ const out = await runSearch('q', { maxResults: 1 });+ const [url, init] = calls(fn)[0];+ expect(url).toBe('https://api.keenable.ai/v1/search');+ expect((init.headers as Record<string, string>)['X-API-Key']).toBe('real-keenable-key');+ expect(bodyOf(calls(fn)[0])).toEqual({ query: 'q', max_results: 1 });+ expect(out.results).toHaveLength(1);+ });++ it('cools a rate-limited keyless row down and fails over to the next engine', async () => {+ seedKeenable();+ addKey('keenable', 'no-key');+ addKey('tavily');+ updateSearchEngine(listSearchEngines().find(e => e.engineId === 'keenable-search')!.id, { priority: 0 });+ const fn = mockFetch(url => url.startsWith('https://api.keenable.ai')+ ? json({ error: 'Too many requests' }, 429, { 'retry-after': '30' })+ : json({ results: [{ title: 'T', url: 'https://t', content: 'c' }] }));+ expect((await runSearch('q')).provider).toBe('tavily');+ // The benched Keenable row is skipped on the next search.+ await runSearch('q2');+ expect(calls(fn).map(c => new URL(c[0]).host)).toEqual(['api.keenable.ai', 'api.tavily.com', 'api.tavily.com']);+ });+ });+it('tries a custom relay before the catalog engines', async () => {addKey('tavily');addCustomRelay('https://relay.example/v1');diff --git a/server/src/docs/openapi.ts b/server/src/docs/openapi.tsindex c647ee40..14597ee4 100644--- a/server/src/docs/openapi.ts+++ b/server/src/docs/openapi.ts@@ -35,7 +35,7 @@ export const openapiSpec = {tags: [{ name: 'Chat', description: 'OpenAI-compatible chat and completion endpoints' },{ name: 'Media', description: 'Image generation and text-to-speech' },- { name: 'Search', description: 'Web search over Parallel (keyless) and your Tavily, Exa, Firecrawl and Linkup keys' },+ { name: 'Search', description: 'Web search over Parallel and Keenable (keyless) and your Tavily, Exa, Firecrawl and Linkup keys' },{ name: 'Decisions', description: 'Decision models (choice, yes/no, score) over your Cloudflare and OpenRouter keys' },{ name: 'Responses', description: 'OpenAI Responses API (Codex CLI wire format)' },{ name: 'Anthropic', description: 'Anthropic Messages API (Claude Code and the Anthropic SDKs)' },@@ -179,7 +179,7 @@ export const openapiSpec = {operationId: 'createSearch',summary: 'Search the web',description:- 'Web search routed over the search engines in the catalog (Parallel, Tavily, Exa, Firecrawl, Linkup) and any ' ++ 'Web search routed over the search engines in the catalog (Parallel, Tavily, Exa, Firecrawl, Linkup, Keenable) and any ' +'custom search relay. Omit `engine` (or set `auto`) to fail over across engines that have a key; ' +'rate-limited or out-of-credit keys cool down and the next one is tried.',requestBody: {diff --git a/server/src/lib/key-parser.ts b/server/src/lib/key-parser.tsindex 9eca8b4d..085173d6 100644--- a/server/src/lib/key-parser.ts+++ b/server/src/lib/key-parser.ts@@ -106,6 +106,7 @@ export const PREFIX_MAP: Record<string, string> = {FIRECRAWL_: 'firecrawl',LINKUP_: 'linkup',PARALLEL_: 'parallel',+ KEENABLE_: 'keenable',CLOUDFLARE_: 'cloudflare',ZHIPU_: 'zhipu',OLLAMA_: 'ollama',@@ -251,6 +252,7 @@ export const AUTH_JSON_PROVIDER_MAP: Record<string, string> = {firecrawl: 'firecrawl',linkup: 'linkup',parallel: 'parallel',+ keenable: 'keenable',};export function detectPlatform(prefix: string): string | null {diff --git a/server/src/lib/search-platforms.ts b/server/src/lib/search-platforms.tsindex 03957c60..dfe3c5ca 100644--- a/server/src/lib/search-platforms.ts+++ b/server/src/lib/search-platforms.ts@@ -3,7 +3,7 @@ import type { SearchPlatform } from '@freellmapi/shared/types.js';// Runtime copy of shared/types.ts SEARCH_PLATFORMS. The server only ever// imports types from @freellmapi/shared (it is not compiled into dist), so the// list lives here too; a test pins the two together.-export const SEARCH_PLATFORMS: readonly SearchPlatform[] = ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'serpsearch'];+export const SEARCH_PLATFORMS: readonly SearchPlatform[] = ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'serpsearch', 'keenable'];const SEARCH_PLATFORM_SET = new Set<string>(SEARCH_PLATFORMS);diff --git a/server/src/providers/index.ts b/server/src/providers/index.tsindex f7c096e1..4f992d85 100644--- a/server/src/providers/index.ts+++ b/server/src/providers/index.ts@@ -8,6 +8,7 @@ import { ExaProvider } from './exa.js';import { FirecrawlProvider } from './firecrawl.js';import { LinkupProvider } from './linkup.js';import { ParallelProvider } from './parallel.js';+import { KeenableProvider } from './keenable.js';import { CloudflareProvider } from './cloudflare.js';import { AIHordeProvider } from './aihorde.js';import { ModelScopeProvider } from './modelscope.js';@@ -218,6 +219,8 @@ register(new FirecrawlProvider());register(new LinkupProvider());// Keyless: anonymous Search MCP by default, REST API with a real key.register(new ParallelProvider());+// Keyless: public endpoint by default, the keyed endpoint with a real key.+register(new KeenableProvider());// Cloudflare Workers AI - OpenAI-compatible endpoint (key = "account_id:token")register(new CloudflareProvider());diff --git a/server/src/providers/keenable.ts b/server/src/providers/keenable.tsnew file mode 100644index 00000000..b29109d1--- /dev/null+++ b/server/src/providers/keenable.ts@@ -0,0 +1,37 @@+import type { Platform } from '@freellmapi/shared/types.js';+import type { KeyValidationResult } from './base.js';+import { SearchOnlyProvider } from './search-only.js';+import { isAnonymousCredential } from '../lib/credential.js';++export const KEENABLE_BASE_URL = 'https://api.keenable.ai/v1';+/** Keenable identifies keyless callers by app name and refuses a keyless call+ * without it (400). */+export const KEENABLE_APP_TITLE = 'freellmapi';++// Keenable (keenable.ai): keyless web search. POST /v1/search/public answers+// with no account (10 requests/second and 1,000/hour per IP), so the Keys page+// stores the `no-key` sentinel and search runs there. A real API key switches+// to POST /v1/search, which drops the hourly cap.+//+// Validation runs no search either way: both probes send an empty body, which+// the API answers 400 (no query). Authentication runs first, so a bad key gets+// 401 instead. A keyless probe still counts as one request toward the hourly+// limit, about 12 an hour at the health checker's pace.+export class KeenableProvider extends SearchOnlyProvider {+ readonly platform: Platform = 'keenable';+ readonly name = 'Keenable';+ keyless = true;++ async validateKey(apiKey: string): Promise<KeyValidationResult> {+ const anonymous = isAnonymousCredential(apiKey);+ return this.probe(`${KEENABLE_BASE_URL}/search${anonymous ? '/public' : ''}`, {+ method: 'POST',+ headers: {+ 'Content-Type': 'application/json',+ 'X-Keenable-Title': KEENABLE_APP_TITLE,+ ...(anonymous ? {} : { 'X-API-Key': apiKey.trim() }),+ },+ body: '{}',+ });+ }+}diff --git a/server/src/routes/keys.ts b/server/src/routes/keys.tsindex 2a962074..0e8110b1 100644--- a/server/src/routes/keys.ts+++ b/server/src/routes/keys.ts@@ -68,7 +68,7 @@ const PLATFORMS = ['serpsearch','freeai','google', 'groq', 'cerebras', 'sail', 'electronhub', 'experiential', 'router9', 'septor', 'clod', 'speechify', 'blaze', 'lucidity', 'airforce', 'dreamprompting', 'waterfall', 'logfare', 'bai', 'radeon', 'nvidia', 'mistral',- 'openrouter', 'cohere', 'tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'cloudflare', 'zhipu', 'ollama',+ 'openrouter', 'cohere', 'tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'keenable', 'cloudflare', 'zhipu', 'ollama','kilo', 'pollinations', 'llm7', 'huggingface', 'opencode', 'ovh', 'agnes', 'reka', 'siliconflow','routeway', 'bazaarlink', 'ainative', 'aion', 'anyapi', 'requesty', 'navy', 'nara', 'sealion', 'orcarouter', 'unorouter', 'xkiro', 'modelscope','qianfan', 'volcengine', 'longcat', 'xfyun', 'aihorde', 'custom',diff --git a/server/src/routes/mcp.ts b/server/src/routes/mcp.tsindex 80f019b5..f5a69218 100644--- a/server/src/routes/mcp.ts+++ b/server/src/routes/mcp.ts@@ -528,7 +528,7 @@ const TOOLS: Record<string, McpTool> = {},web_search: {title: 'Search the web',- description: 'Search the web through the search providers configured in FreeLLMAPI (Parallel, Tavily, Exa, Firecrawl, Linkup, or a custom search endpoint). Returns titles, URLs and short extracts. Spends the search provider\'s free quota, not model tokens.',+ description: 'Search the web through the search providers configured in FreeLLMAPI (Parallel, Tavily, Exa, Firecrawl, Linkup, Keenable, or a custom search endpoint). Returns titles, URLs and short extracts. Spends the search provider\'s free quota, not model tokens.',inputSchema: {type: 'object',additionalProperties: false,diff --git a/server/src/services/search.ts b/server/src/services/search.tsindex 7539146e..5c3a971f 100644--- a/server/src/services/search.ts+++ b/server/src/services/search.ts@@ -10,6 +10,7 @@ import { EXA_BASE_URL } from '../providers/exa.js';import { FIRECRAWL_BASE_URL } from '../providers/firecrawl.js';import { LINKUP_BASE_URL } from '../providers/linkup.js';import { PARALLEL_BASE_URL, PARALLEL_MCP_URL } from '../providers/parallel.js';+import { KEENABLE_APP_TITLE, KEENABLE_BASE_URL } from '../providers/keenable.js';import { isAnonymousCredential } from '../lib/credential.js';import { randomUUID } from 'node:crypto';import { secondsUntilNextMonth } from './key-budget.js';@@ -408,6 +409,28 @@ const ADAPTERS: Record<string, Adapter> = {}));return { results: keepHits(hits) };},++ // Keyless: the stored `no-key` sentinel calls the public endpoint, which+ // only needs the app title; a real key calls the keyed endpoint. Both return+ // the same result shape, with the page text in `snippet`.+ keenable: async (cred, query, opts, n) => {+ const anonymous = isAnonymousCredential(cred.key);+ const parsed = await upstream(`${KEENABLE_BASE_URL}/search${anonymous ? '/public' : ''}`, 'keenable', {+ method: 'POST',+ headers: {+ 'Content-Type': 'application/json',+ 'X-Keenable-Title': KEENABLE_APP_TITLE,+ ...(anonymous ? {} : { 'X-API-Key': cred.key.trim() }),+ },+ body: JSON.stringify({ query, max_results: n }),+ }, opts.signal) as { results?: Array<Record<string, unknown>> };+ const hits = (Array.isArray(parsed?.results) ? parsed.results : []).slice(0, n).map(r => ({+ title: str(r.title) || str(r.url),+ url: str(r.url),+ content: str(r.snippet) || str(r.description),+ }));+ return { results: keepHits(hits) };+ },};/** Platforms with a search adapter. catalog-sync gates searchEngines rows on@@ -572,7 +595,7 @@ export async function runSearch(query: string, opts: SearchOptions = {}): Promis);}throw new SearchError(- 'No search key configured. Enable Parallel (no key needed) or add a Tavily, Exa, Firecrawl or Linkup key on the Keys page.',+ 'No search key configured. Enable Parallel or Keenable (no key needed) or add a Tavily, Exa, Firecrawl or Linkup key on the Keys page.',503,'no_search_keys',);diff --git a/shared/types.ts b/shared/types.tsindex c1c2cda8..08409bf5 100644--- a/shared/types.ts+++ b/shared/types.ts@@ -142,6 +142,7 @@ export type Platform =| 'linkup'| 'parallel'| 'serpsearch'+ | 'keenable'| 'cloudflare'| 'zhipu'| 'ollama'@@ -272,7 +273,7 @@ export type Platform =* web_search tools), never chat. Search engine rows arrive through the* catalog's `searchEngines` registry. The server keeps its own runtime copy in* server/src/lib/search-platforms.ts (shared is type-only on the server). */-export const SEARCH_PLATFORMS = ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'serpsearch'] as const;+export const SEARCH_PLATFORMS = ['tavily', 'exa', 'firecrawl', 'linkup', 'parallel', 'serpsearch', 'keenable'] as const;export type SearchPlatform = (typeof SEARCH_PLATFORMS)[number];export function isSearchPlatform(platform: string): platform is SearchPlatform {