Your lightweight open-source personal agent.
Python agent-frameworkai-agentai-agentschatbotchatopsdiscord-botllm-agentsllmslocal-llmmcpmodel-context-protocolmulti-agentopenai-compatibleopenclawpersonal-ai-assistantpythonself-hostedtelegram-bot-ai-assistantwebuiworkflow-automation
feat(web): register Keenable provider in WebUI, docs, and tests
Ilya Gusevfa3e902ee811
diff --git a/docs/configuration.md b/docs/configuration.mdindex cb8f85d6a..2a95bb1b9 100644--- a/docs/configuration.md+++ b/docs/configuration.md@@ -1456,6 +1456,7 @@ By default, web search uses `duckduckgo`, and it works out of the box without an| `olostep` | `apiKey` | `OLOSTEP_API_KEY` | No || `bocha` | `apiKey` | `BOCHA_API_KEY` | Free tier (1M calls for startups) || `volcengine` | `apiKey` | `VOLCENGINE_SEARCH_API_KEY` or `WEB_SEARCH_API_KEY` | Monthly quota, then paid |+| `keenable` | `apiKey` (optional) | `KEENABLE_API_KEY` | Free tier (no login); key raises rate limits || `searxng` | `baseUrl` | `SEARXNG_BASE_URL` | Yes (self-hosted) || `duckduckgo` (default) | — | — | Yes |@@ -1565,6 +1566,22 @@ You can set `BOCHA_API_KEY` in the environment instead of storing it in config.You can also set `WEB_SEARCH_API_KEY` for compatibility with the Volcengine web-search skill. Create the key in the [Volcengine web search console](https://console.volcengine.com/search-infinity/web-search), then copy it from [API keys](https://console.volcengine.com/search-infinity/api-key). Volcengine Ark keys are separate and do not work for this search provider.+**Keenable** (free tier, no login required):+```json+{+ "tools": {+ "web": {+ "search": {+ "provider": "keenable",+ "apiKey": "${KEENABLE_API_KEY}"+ }+ }+ }+}+```++Search works without a key on the free tier; `apiKey` is optional and raises rate limits. Create a key at [keenable.ai](https://keenable.ai). You can also set `KEENABLE_API_KEY` in the environment instead of storing it in config.+**SearXNG** (self-hosted, no API key needed):```json{diff --git a/nanobot/agent/tools/web.py b/nanobot/agent/tools/web.pyindex e1e1976be..6d4de1383 100644--- a/nanobot/agent/tools/web.py+++ b/nanobot/agent/tools/web.py@@ -501,7 +501,7 @@ class WebSearchTool(Tool):"https://api.keenable.ai/v1/search",headers=headers,json={"query": query},- timeout=15.0,+ timeout=float(self.config.timeout),)r.raise_for_status()items = [@@ -513,8 +513,12 @@ class WebSearchTool(Tool):for x in r.json().get("results", [])]return _format_results(query, items, n)+ except httpx.HTTPStatusError as e:+ if e.response.status_code == 429:+ return "Error: Keenable search rate limited. Try again later or reduce search frequency."+ return f"Error: Keenable search failed ({e.response.status_code}): {e}"except Exception as e:- return f"Error: {e}"+ return f"Error: Keenable search failed: {e}"async def _search_searxng(self, query: str, n: int) -> str:base_url = (self.config.base_url or os.environ.get("SEARXNG_BASE_URL", "")).strip()diff --git a/nanobot/webui/settings_api.py b/nanobot/webui/settings_api.pyindex 6cc795c16..5da3a86e0 100644--- a/nanobot/webui/settings_api.py+++ b/nanobot/webui/settings_api.py@@ -90,6 +90,7 @@ _WEB_SEARCH_PROVIDER_OPTIONS: tuple[dict[str, str], ...] = ({"name": "olostep", "label": "Olostep", "credential": "api_key"},{"name": "bocha", "label": "Bocha", "credential": "api_key"},{"name": "volcengine", "label": "Volcengine Search", "credential": "api_key"},+ {"name": "keenable", "label": "Keenable", "credential": "api_key"},)_WEB_SEARCH_PROVIDER_BY_NAME = {provider["name"]: provider for provider in _WEB_SEARCH_PROVIDER_OPTIONSdiff --git a/tests/channels/test_websocket_channel.py b/tests/channels/test_websocket_channel.pyindex 8fb80fcd7..a18ec1507 100644--- a/tests/channels/test_websocket_channel.py+++ b/tests/channels/test_websocket_channel.py@@ -1767,6 +1767,7 @@ async def test_settings_api_returns_safe_subset_and_updates_whitelist(assert search_providers["exa"]["credential"] == "api_key"assert search_providers["bocha"]["credential"] == "api_key"assert search_providers["volcengine"]["credential"] == "api_key"+ assert search_providers["keenable"]["credential"] == "api_key"assert search_providers["searxng"]["credential"] == "base_url"assert body["image_generation"]["enabled"] is Falseassert body["image_generation"]["provider"] == "openrouter"diff --git a/tests/tools/test_web_search_tool.py b/tests/tools/test_web_search_tool.pyindex 9cda67586..6423f077d 100644--- a/tests/tools/test_web_search_tool.py+++ b/tests/tools/test_web_search_tool.py@@ -178,6 +178,32 @@ async def test_keenable_search_without_key_omits_header(monkeypatch):assert "Anon" in result+async def test_keenable_search_uses_env_api_key(monkeypatch):+ async def mock_post(self, url, **kw):+ assert kw["headers"]["X-API-Key"] == "env-keen-key"+ return _response(json={+ "results": [{"title": "Env", "url": "https://keenable.ai/env", "description": "ok"}]+ })++ monkeypatch.setattr(httpx.AsyncClient, "post", mock_post)+ monkeypatch.setenv("KEENABLE_API_KEY", "env-keen-key")+ tool = _tool(provider="keenable", api_key="")+ result = await tool.execute(query="keenable", count=1)+ assert "Env" in result+++async def test_keenable_search_http_error(monkeypatch):+ async def mock_post(self, url, **kw):+ return _response(status=401, json={"error": "invalid key"})++ monkeypatch.setattr(httpx.AsyncClient, "post", mock_post)+ tool = _tool(provider="keenable", api_key="bad-keen-key")+ result = await tool.execute(query="keenable")+ assert "Error: Keenable search failed (401)" in result++@pytest.mark.asyncioasync def test_bocha_search(monkeypatch):async def mock_post(self, url, **kw):diff --git a/webui/src/lib/provider-brand.ts b/webui/src/lib/provider-brand.tsindex ebeea08b6..aba778424 100644--- a/webui/src/lib/provider-brand.ts+++ b/webui/src/lib/provider-brand.ts@@ -130,6 +130,7 @@ const PROVIDER_BRANDS: Record<string, ProviderBrand> = {huggingface: brand("huggingface.co", "#FF9D00", "HF"),jina: brand("jina.ai", "#7C3AED", "J"),kagi: brand("kagi.com", "#FFB319", "K"),+ keenable: brand("keenable.ai", "#0EA5E9", "K"),lm_studio: brand("lmstudio.ai", "#111827", "LM"),longcat: brand("longcatai.org", "#4F8CFF", "LC", ["https://www.longcatai.org/favicon.svg",diff --git a/webui/src/tests/provider-brand.test.ts b/webui/src/tests/provider-brand.test.tsindex bbbffa354..2b06cf80f 100644--- a/webui/src/tests/provider-brand.test.ts+++ b/webui/src/tests/provider-brand.test.ts@@ -57,4 +57,9 @@ describe("provider brand logos", () => {expect(providerBrand("bocha")?.logoUrls).toContain("https://bochaai.com/favicon.ico");expect(providerBrand("bocha")?.initials).toBe("B");});++ it("keeps Keenable web search settings on the first-party brand domain", () => {+ expect(providerBrand("keenable")?.logoUrls).toContain("https://keenable.ai/favicon.ico");+ expect(providerBrand("keenable")?.initials).toBe("K");+ });});