> ## 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

# GPT Researcher web search retriever

> Give GPT Researcher web search with no API key through gpt-researcher-keenable, a retriever plugin.

*Retriever plugin*

Give [GPT Researcher](https://github.com/assafelovic/gpt-researcher) Keenable web search with the `gpt-researcher-keenable` retriever plugin. It works without an API key. GPT Researcher finds the plugin through its plugin entry point, so you don't change any GPT Researcher code.

→ [gpt-researcher-keenable on PyPI](https://pypi.org/project/gpt-researcher-keenable/)

## Install

You need GPT Researcher 0.16.1 or later. Install the plugin:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
pip install gpt-researcher-keenable
```

## Select Keenable

Set the `RETRIEVER` environment variable:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
export RETRIEVER=keenable
```

To use Keenable alongside the built-in retrievers, separate the names with commas, for example `RETRIEVER=keenable,arxiv`.

## Retriever behavior

* Each result gives GPT Researcher a title, a URL and a short preview of the page. GPT Researcher then scrapes the pages it keeps, as it does with its built-in web retrievers.
* `MAX_SEARCH_RESULTS_PER_QUERY` sets the number of results, from 1 to 50.
* If you set `query_domains`, the plugin searches only the first domain you list.
* If a network or API call fails, the plugin logs the error and returns no results, so the research run continues.

> [!NOTE]
>
> If you don't set a key, searches run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). Set `KEENABLE_API_KEY` to use your organization's limits and remove the hourly cap.

## Related pages

> [card] [Hermes Agent](https://docs.keenable.ai/integrations/hermes-agent.md)
>
> Keenable is built into Hermes Agent as a web backend for web\_search and web\_extract, and works without a key.

> [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] [ketch](https://docs.keenable.ai/integrations/ketch.md)
>
> Use Keenable as the built-in search backend in ketch, the agent CLI written in Go.

> [card] [Fetch quickstart](https://docs.keenable.ai/products/fetch.md)
>
> Turn any URL into clean markdown your model can read, or get only the part a prompt asks for. Try it with no API key. Code, cost per call and gotchas.


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