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

# Gajae-Code web search with Keenable

> Use Keenable as the web search provider in Gajae-Code (gjc), the coding-agent harness, with providers.webSearch set to keenable. No key needed.

*Search provider in Gajae-Code*

Keenable is a web search provider in [Gajae-Code](https://github.com/Yeachan-Heo/gajae-code) (`gjc`), the coding-agent harness you drop into any repository. Select it and the agent's `web_search` tool sends queries to Keenable. It works without an API key.

→ [web\_search in Gajae-Code's docs](https://github.com/Yeachan-Heo/gajae-code/blob/main/docs/tools/web_search.md)

## Install

Keenable is in Gajae-Code 0.21.1, the current release on 19 November 2026. Gajae-Code's README has the install script for each platform, for example on Linux and macOS:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/gajae-code/main/scripts/install.sh | sh
```

The README also shows how to download the script at a release tag and read it before you run it.

## Select Keenable

Set the search provider from the shell:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
gjc config set providers.webSearch keenable
```

The setting is saved in the global `config.yml` of the agent directory, `~/.gjc/agent/` by default. `gjc config path` prints the directory in use. Start `gjc` and ask a question that needs the web: the agent's `web_search` calls go to Keenable.

To keep another provider first and fall back to Keenable, list it in `web_search.fallback` instead.

## Settings

| Setting | What it does |
| - | - |
| `providers.webSearch: keenable` | Uses Keenable for `web_search`. Keenable is never picked in `auto` mode. |
| `web_search.fallback` | A list of providers to try after the selected one. Keenable can be one of them. |
| `KEENABLE_API_KEY` | Optional. With a key, or a stored `keenable` credential, gjc calls `/v1/search` with `X-API-Key` instead of the keyless `/v1/search/public`. |

Each request carries `query`, `max_results` and an `X-Keenable-Title` header. Gajae-Code asks for 10 results by default and up to 50.

> [!NOTE]
>
> Without a key, searches run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). Export `KEENABLE_API_KEY`, or add it to `~/.gjc/agent/.env`, to use your organization's limits. See [API keys](https://docs.keenable.ai/api-keys.md).

## Related pages

> [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] [Claude Octopus](https://docs.keenable.ai/integrations/claude-octopus.md)
>
> Set OCTOPUS\_RESEARCH\_WEB\_SEARCH=keenable so Claude Octopus research runs one Keenable search and hands every perspective the top results. No key needed.

> [card] [Cursor](https://docs.keenable.ai/integrations/cursor.md)
>
> Add Keenable to Cursor over MCP with one click, an mcp.json entry or the Keenable CLI, and turn off Cursor's own web search.

> [card] [Agent skill](https://docs.keenable.ai/agent-skill.md)
>
> Install the keenable-web-search agent skill with npx skills add. Your agent searches the web with a bundled script, with no API key and no MCP client.


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