Octen Skills

For AI agents: docs.octen.ai/integrations/octen-skills.md

Why Octen Skills

Octen Skills put Octen inside your agent: live broad web search with clean, model-ready context.

Fast

Web search averages 62ms. Fast enough for multi-step agent workflows.

Accurate

Fresh

Live web data with minute-level updates. Useful for news, prices, and fast-moving pages.

Efficient

Clean highlights, optional full content, and time and domain filters keep model context relevant.

Get Started

Get API Key

Create a key from the API Platform.

GitHub

View and install the skills.

Skills

Skill	Endpoint	Use for
octen-web-search	router	Entry point for live web info. Routes each lookup to the right Octen tool and loads them before any built-in web search.
octen-search	`POST /broad-search`, `POST /search`	Search bars, answer engines, news lookup, and broad multi-angle research.
octen-image-search	`POST /image-search`	Image lookup and visual references.
octen-video-search	`POST /video-search`	Video lookup, clip discovery, and media previews. Invite-only beta — contact us for access.
octen-extract	`POST /extract`	Reading pages, cleaning articles, and knowledge ingestion.

Installation

npx skills add Octen-Team/octen-skills -a claude-code

npx skills add Octen-Team/octen-skills -a cursor

npx skills add Octen-Team/octen-skills -a codex

npx skills add Octen-Team/octen-skills -a gemini-cli

npx skills add Octen-Team/octen-skills -a openclaw

skills auto-detects your current agent — just run:

npx skills add Octen-Team/octen-skills

Without Node (curl)

If you can’t run npx, copy the skills/ directory into your agent’s skills folder:

mkdir -p <skills-dir> && \
  curl -sL https://github.com/Octen-Team/octen-skills/archive/main.tar.gz | \
  tar xz -C <skills-dir> --strip-components=2 octen-skills-main/skills

API Key

Set OCTEN_API_KEY before using any skill. Get a key from the API Platform.

Claude Code
Cursor
Codex
OpenClaw
Other agents

Add to ~/.claude/settings.json:

{
  "env": {
    "OCTEN_API_KEY": "your-key"
  }
}

For per-project use, add the same env block to .claude/settings.local.json.

Use direnv for a directory-scoped key:

echo 'export OCTEN_API_KEY="your-key"' >> .envrc
direnv allow

Or export it in your shell profile (~/.zshrc or ~/.bashrc), then fully quit and reopen Cursor:

export OCTEN_API_KEY="your-key"

Add to ~/.codex/config.toml:

[shell_environment_policy]
set = { OCTEN_API_KEY = "your-key" }

Or export it in your shell profile (~/.zshrc or ~/.bashrc).

Add to ~/.openclaw/.env:

OCTEN_API_KEY=your-key

Export the key in the shell environment your agent runs in (covers Hermes Agent, Gemini CLI, Windsurf, and others):

export OCTEN_API_KEY="your-key"

octen-search

curl -s -X POST "https://api.octen.ai/broad-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{"query": "latest AI research 2026", "search_options": {"count": 5}}'

For broad, multi-angle coverage, pass the full question as-is — Octen expands it into sub-queries searched concurrently and returns results grouped per sub-query:

curl -s -X POST "https://api.octen.ai/broad-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "query": "compare cloud GPU pricing across major providers",
    "max_queries": 5,
    "search_options": {"count": 10, "highlight": {"enable": true}}
  }'

octen-image-search

Image lookup and visual references, searched by text or a reference image.

curl -s -X POST "https://api.octen.ai/image-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "red sports car"}],
    "count": 5
  }'

octen-video-search — invite-only beta

Video lookup, clip discovery, and media previews.

curl -s -X POST "https://api.octen.ai/video-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "how to make espresso"}],
    "count": 5
  }'

octen-extract

curl -s -X POST "https://api.octen.ai/extract" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "urls": ["https://example.com", "https://octen.ai"],
    "format": "markdown"
  }'

When to Use Each Skill

Need	Skill
Any web lookup, unsure which tool	`octen-web-search`
Comprehensive, multi-angle research	`octen-search` (broad search)
A quick web search	`octen-search`
Results scoped to specific sites	`octen-search` with `include_domains`
Photos, diagrams, or visual references	`octen-image-search`
Videos, clips, or a moment within a video	`octen-video-search` (beta)
Reading known URLs as clean content	`octen-extract`

Last modified on October 13, 2026

Overview

Capabilities

Integrations

Resources

Why Octen Skills

Fast

Accurate

Fresh

Efficient

Get Started

Get API Key

GitHub

Skills

Installation

Without Node (curl)

API Key

octen-search

octen-image-search

octen-video-search — invite-only beta

octen-extract

When to Use Each Skill

​Why Octen Skills

Fast

Accurate

Fresh

Efficient

​Get Started

Get API Key

GitHub

​Skills

​Installation

​Without Node (curl)

​API Key

​octen-search

​octen-image-search

​octen-video-search — invite-only beta

​octen-extract

​When to Use Each Skill

Why Octen Skills

Get Started

Skills

Installation

Without Node (curl)

API Key

octen-search

octen-image-search

octen-video-search — invite-only beta

octen-extract

When to Use Each Skill