> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keenable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Every page is listed in https://docs.keenable.ai/llms.txt. To pick a product for a job, read https://docs.keenable.ai/choose.md
> Setup steps for agents, covering the SDKs, the MCP server and the CLI: https://docs.keenable.ai/skill.md
> Keenable search and fetch work without an API key. To add them to code, use the official SDK for the project's language: https://docs.keenable.ai/sdks.md
> Without a key, call POST https://api.keenable.ai/v1/search/public or GET https://api.keenable.ai/v1/fetch/public with an X-Keenable-Title header that names your app.
> With a key, send it in the X-API-Key header and read it from the KEENABLE_API_KEY environment variable. Never ask a user to paste a key into chat. Every access method: https://docs.keenable.ai/auth.md
> To get an API key without the console, use device login: https://docs.keenable.ai/authentication.md#device-login
> MCP server: https://api.keenable.ai/mcp (no key, or X-API-Key; keyless Codex uses https://api.keenable.ai/mcp-public), or https://api.keenable.ai/mcp-oauth for OAuth sign-in. These docs are an MCP server at https://docs.keenable.ai/mcp and the OpenAPI spec is at https://docs.keenable.ai/api-reference/openapi.json
> Keenable searches and fetches public web pages. If a question needs no web information, skip the call.
> On 402 with an API key (code insufficient_credits), stop and ask a human to add credits; don't retry. On 429, wait the number of seconds in Retry-After, then retry. Before you ship, follow https://docs.keenable.ai/production.md
> Every error, with its cause and fix, is in https://docs.keenable.ai/errors.md and moving from another search API is covered in https://docs.keenable.ai/migrate.md
> Before you compare Keenable with another search API, read https://docs.keenable.ai/guides/evaluate-search-apis.md

# Qwen-MM-Plugins search with Keenable

> Use Keenable for web_search and web_extractor in the Qwen-MM-Plugins search plugin with QWEN_MM_SEARCH_BACKEND=keenable. Works without an API key.

*Search backend in Qwen-MM-Plugins*

Keenable is a text search backend in the `search` plugin of [Qwen-MM-Plugins](https://github.com/QwenLM/Qwen-MM-Plugins), Qwen's multimodal plugins for coding agents such as Claude Code, Codex and Qwen Code. Pin it and the plugin's `web_search` and `web_extractor` tools call Keenable. Pinned, it works without an API key.

→ [Search selection in Qwen-MM-Plugins' configuration docs](https://github.com/QwenLM/Qwen-MM-Plugins/blob/main/docs/en/configuration.md#search-selection)

## Install

The Keenable backend is on Qwen-MM-Plugins' `main` branch. The latest search release, `qwen-mm-plugins-search-v1.2.0`, came out before it, so install the search plugin from a checkout. `install.sh local` installs the current checkout:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
git clone https://github.com/QwenLM/Qwen-MM-Plugins.git
cd Qwen-MM-Plugins
bash install.sh local --plugin core --plugin search --harness claude
```

Use `--harness codex` or `--harness qwen-code` for the other agents. Once a search release includes Keenable, `bash install.sh install` works too.

## Pin Keenable

Write the setting to the shared config file, `~/.qwen-mm-plugins/config`:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
bash install.sh configure QWEN_MM_SEARCH_BACKEND=keenable
```

Every Qwen-MM-Plugins component reads that file on its next operation. Ask your agent a question that needs the web: its `web_search` calls now go to Keenable.

## Settings

| Setting | Default | What it does |
| - | - | - |
| `QWEN_MM_SEARCH_BACKEND` | `auto` | `keenable` pins Keenable. `auto` picks the first configured key in this order: Serper, Tavily, Exa, Serply, Keenable. |
| `KEENABLE_API_KEY` | unset | Optional. Raises the keyless rate limits. In `auto` mode, Keenable is picked only when it is the only key set. |

`image_search` doesn't use Keenable: it always uses Serper Lens and needs `SERPER_API_KEY`. A process environment variable overrides the same key in the config file.

> [!NOTE]
>
> Without a key, searches run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). Run `bash install.sh configure KEENABLE_API_KEY="$KEENABLE_API_KEY"` to use your organization's limits. See [API keys](https://docs.keenable.ai/api-keys.md).

## Related pages

> [card] [de-anthropocentric research engine](https://docs.keenable.ai/integrations/de-anthropocentric-research-engine.md)
>
> Keenable is one of the MCP servers the de-anthropocentric research engine recommends for web retrieval, with no install and no key.

> [card] [hyperresearch](https://docs.keenable.ai/integrations/hyperresearch.md)
>
> Use Keenable as the web provider in hyperresearch, the deep-research pipeline, for search and page fetch. No key or extra install, 0.13.1 and later.

> [card] [GPT Researcher](https://docs.keenable.ai/integrations/gpt-researcher.md)
>
> Give GPT Researcher web search with no API key through gpt-researcher-keenable, a retriever plugin.

> [card] [Search quickstart](https://docs.keenable.ai/products/search.md)
>
> Give your agent ranked web pages with excerpts ready to cite. Try it with no API key. Code, cost per mode, filters by site, date and domain, and gotchas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.