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

# Build with Coding Agent

Coding agents such as Claude Code and Cursor can build an Octen integration for you. This page gives an agent what it needs: what Octen offers, the docs in agent-friendly formats, how to connect to Octen, and how to use it in applications.

## What Octen Offers

Octen is the search infrastructure for AI: a real-time web search foundation that lets LLMs, agents, and apps reason with the world's latest information.

| Product                                                         | What it does                                                                                      |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| [Broad Search](/capabilities/broad-search)                      | Expands one query into multi-angle sub-queries and searches them concurrently.                    |
| [Web Search](/capabilities/web-search)                          | Live web search with ranked results, highlights, and optional full content.                       |
| [Image Search](/capabilities/image-search) (beta)               | Image search by text or reference image; the design topic adds style summaries and HTML snippets. |
| [Video Search](/capabilities/video-search) (beta)               | Video search from a text query, with rich metadata.                                               |
| [Extract](/capabilities/extract)                                | Turns up to 20 URLs into clean, LLM-ready markdown or text.                                       |
| [Model Gateway](/capabilities/model-gateway)                    | Frontier models behind one API key, with built-in Octen search tools.                             |
| [Embedding](/capabilities/embedding)                            | Text embeddings for semantic search, RAG, and recommendations.                                    |
| [VL Embedding](/capabilities/vl-embedding)                      | Multimodal embeddings across text, images, and videos.                                            |
| [Answer](/capabilities/answer)                                  | A question in, a synthesized answer with sources out.                                             |
| [Deep Research](/capabilities/deep-research)                    | Autonomous multi-round research that streams back a cited report.                                 |
| [Multimodal Chat](/capabilities/multimodal-chat) (beta)         | Replies with interleaved text, images, and videos, grounded in multimodal search.                 |
| [Grounded Generation](/capabilities/grounded-generation) (beta) | Generates images and videos grounded in search results.                                           |

## How to Read the Docs

### Plain text pages

Add `.md` to the end of any docs URL to get the page as plain Markdown. For example, the Web Search API reference is available at [https://docs.octen.ai/api-reference/search.md](https://docs.octen.ai/api-reference/search.md).

This format beats scraping or copying the HTML pages:

* Plain text contains fewer formatting tokens.
* Content that isn't rendered in the default view, such as content hidden in a tab, is included.
* LLMs parse and understand Markdown hierarchy.

### llms.txt

[docs.octen.ai/llms.txt](https://docs.octen.ai/llms.txt) carries comprehensive API documentation designed for LLM consumption, following the llms.txt standard for making websites accessible to LLMs.

## Connect to Octen

Connect to Octen with one command through Agent Skills, the MCP server, or the CLI.

<Note>
  You'll need an Octen API key first. Create one from the [API Platform](https://octen.ai/platform/api-keys).
</Note>

### Octen Skills

Agent skills for search, extract, and design references. One command, agent auto-detected:

```bash theme={null}
npx skills add Octen-Team/octen-skills
```

Per-agent commands and API key setup are in [Octen Skills](/integrations/octen-skills).

### Octen MCP Server

Search and extract tools for any MCP-compatible client. In Claude Code:

```bash theme={null}
claude mcp add --scope user octen \
  -e OCTEN_API_KEY=your-key-here \
  -- npx -y octen-mcp
```

Configs for Claude Desktop, Cursor, VS Code, and other clients are in [Octen MCP Server](/integrations/octen-mcp-server).

### Octen CLI

The full Octen API in your terminal, plus one-command setup of the MCP server or Skills:

```bash theme={null}
npm i -g @octen.ai/cli
octen configure-skills --claude-code --set-key
```

Commands and options are in [Octen CLI](/integrations/octen-cli).

## Use in Applications

In application code, call the Octen API directly: the base URL is `https://api.octen.ai`, authenticated with the `x-api-key` header or a Bearer token.

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.octen.ai/search \
    -H "Content-Type: application/json" \
    -H "x-api-key: YOUR_API_KEY" \
    -d '{"query": "Tesla stock price"}'
  ```

  ```python Python SDK theme={null}
  from octen import Octen

  client = Octen(api_key="your-api-key")  # or set OCTEN_API_KEY env var
  results = client.search.search(query="Tesla stock price")
  ```
</CodeGroup>

Every endpoint, parameter, and response schema is in the [API Reference](/api-reference/broad-search). For Model Gateway, existing OpenAI and Anthropic SDK code works after swapping the base URL and key; see [Model Gateway](/capabilities/model-gateway).
