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

# AgentField deep research agent with Keenable

> Run AgentField's deep research example on Keenable web search with SEARCH_PROVIDER=keenable. No account or API key needed.

*Search backend in an AgentField example*

AgentField's [deep research agent](https://github.com/Agent-Field/agentfield/tree/main/examples/python_agent_nodes/deep_research) breaks a research question into subtasks, searches the web for each leaf task and writes a report. Set `SEARCH_PROVIDER=keenable` and its searches go to Keenable. Tavily stays the default. Keenable needs no account or API key.

→ [Deep research agent README](https://github.com/Agent-Field/agentfield/blob/main/examples/python_agent_nodes/deep_research/README.md)

## Install

The example lives in the AgentField repository. From a clone, install its requirements:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
git clone https://github.com/Agent-Field/agentfield.git
cd agentfield
pip install -r examples/python_agent_nodes/deep_research/requirements.txt
```

## Run the agent on Keenable

Select Keenable and start the agent:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
export SEARCH_PROVIDER=keenable
python examples/python_agent_nodes/deep_research/main.py
```

In a second terminal, send a research question:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
curl -X POST http://localhost:8080/reasoners/planning_execute_deep_research \
  -H "Content-Type: application/json" \
  -d '{
    "research_question": "What changed in the EU AI Act this year?",
    "max_depth": 3,
    "max_tasks_per_level": 5
  }'
```

The agent plans its subtasks, runs one Keenable search per leaf task and returns the synthesized report.

## Settings

| Variable | Values | Default |
| - | - | - |
| `SEARCH_PROVIDER` | `tavily`, `parallel`, `serply`, `keenable`, `outcrawl` | `tavily` |
| `KEENABLE_API_KEY` | Your Keenable API key. Optional: it lifts the keyless rate limit. | unset |

> [!NOTE]
>
> Without a key, searches run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). A deep research run makes many searches, so export `KEENABLE_API_KEY` for larger questions. See [API keys](https://docs.keenable.ai/api-keys.md).

## Related pages

> [card] [npcpy](https://docs.keenable.ai/integrations/npcpy.md)
>
> Search the web from npcpy with the keenable provider for search\_web, or call search\_keenable directly. No API key needed, in npcpy 2.1.28 and later.

> [card] [RL and eval environments](https://docs.keenable.ai/integrations/rl-eval-environments.md)
>
> Use Keenable as the search backend in SkillOpt OfficeQA rollouts and Halo GRPO search environments: one config value, opt-in, never a default.

> [card] [Vercel AI SDK](https://docs.keenable.ai/integrations/vercel.md)
>
> Keyless web search and page fetch for the Vercel AI SDK (`@keenable/ai-sdk`), plus Vercel Connect to keep the API key out of environment variables.

> [card] [Tool calling](https://docs.keenable.ai/tool-calling.md)
>
> Give an LLM web search and page fetch as tools. Pass the SDK's TOOLS to any OpenAI-compatible chat completions client and run each call with run\_tool\_call.


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