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

# Claude Octopus research with Keenable search

> Set OCTOPUS_RESEARCH_WEB_SEARCH=keenable so Claude Octopus research runs one Keenable search and hands every perspective the top results. No key needed.

*Research source in Claude Octopus*

[Claude Octopus](https://github.com/nyldn/claude-octopus) runs research as several model perspectives in parallel. With `OCTOPUS_RESEARCH_WEB_SEARCH=keenable`, it first runs one Keenable search for the research question and gives every perspective the top five results as leads. It works without an API key.

→ [Optional web search suggestions in Claude Octopus's research docs](https://github.com/nyldn/claude-octopus/blob/main/docs/RESEARCH-EVIDENCE.md#optional-web-search-suggestions)

## Install

The option ships in Claude Octopus 11.26.0, the current release on 19 November 2026. Install the plugin in Claude Code:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
claude plugin marketplace add https://github.com/nyldn/plugins.git
claude plugin install octo@nyldn-plugins
```

## Turn on the search

Export the variable, then start a research run:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
export OCTOPUS_RESEARCH_WEB_SEARCH=keenable
"$HOME/.claude-octopus/plugin/scripts/orchestrate.sh" discover \
  --intensity standard "Compare current approaches to signed webhooks"
```

Before `probe_discover` dispatches its perspectives, Claude Octopus sends the question to Keenable. Each perspective gets up to five titles, URLs and 500-character excerpts, wrapped as untrusted content. They are leads, not verified claims: the perspectives still open and cite the pages, and the usual citation checks apply.

## Behaviour

| Case | What happens |
| - | - |
| Default run, dry run, cache hit or resumed run | No lookup. |
| Intensity `quick`, `standard` or `deep` | One lookup. Keenable adds no model seat. |
| Search fails, is empty or malformed | One fixed warning, then research continues with the original prompts. |
| A provider allowlist is set | Add `keenable` to it next to the model providers, or no lookup runs. |
| `KEENABLE_API_KEY` set | Calls `/v1/search` with `X-API-Key`. Without it, calls `/v1/search/public` with an `X-Keenable-Title` header. |

One lookup has a 15-second deadline and doesn't retry or follow redirects. Python's standard library makes the request, so there is nothing else to install. The key, if you set one, is kept out of model child processes and prompts.

> [!NOTE]
>
> Without a key, lookups run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md), shared by everyone behind your IP address. Export `KEENABLE_API_KEY` to use your organization's limits. See [API keys](https://docs.keenable.ai/api-keys.md).

## Related pages

> [card] [Gajae-Code](https://docs.keenable.ai/integrations/gajae-code.md)
>
> Use Keenable as the web search provider in Gajae-Code (gjc), the coding-agent harness, with providers.webSearch set to keenable. No key needed.

> [card] [FrontierAgent](https://docs.keenable.ai/integrations/frontier-agent.md)
>
> Set WEB\_SEARCH\_PROVIDER=keenable to send FrontierAgent's web\_search tool to Keenable, up to 50 results per query. Works without an API key.

> [card] [Codex](https://docs.keenable.ai/integrations/codex.md)
>
> Add Keenable to Codex over MCP or the Plugins Directory, and turn off Codex's built-in web search so the agent calls Keenable.

> [card] [CLI](https://docs.keenable.ai/cli.md)
>
> Install the Keenable CLI, sign in once, add Keenable to Claude Code, Cursor and Codex over MCP, and search, fetch and run monitors from the terminal.


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