Octen Skills

Get API Key

Create a key from the API Platform.

GitHub

View and install from Octen-Team/web-search-skills.

Skills

Install the repository to add Octen search skills to your agent.

Skill	Endpoint	Use for
`octen-web-search`	`POST /search`	A single, direct web search query with fast ranked results.
`octen-search`	`POST /broad-search`	Broad, multi-angle search that decomposes a question into sub-queries and returns grouped results.

API key

Set OCTEN_API_KEY before using either skill.

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.

Add to your shell profile:

export OCTEN_API_KEY="your-key"

Then fully quit and reopen Cursor. For directory-scoped environments, you can also use direnv.

Add to ~/.codex/config.toml:

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

Add to ~/.openclaw/.env:

OCTEN_API_KEY=your-key

Export the key in the shell environment used by your agent:

export OCTEN_API_KEY="your-key"

Installation

Claude Code
Cursor
Codex
OpenClaw
Other agents

Recommended:

npx skills add Octen-Team/web-search-skills

Or install with curl:

mkdir -p ~/.claude/skills && \
  curl -sL https://github.com/Octen-Team/web-search-skills/archive/main.tar.gz | \
  tar xz -C ~/.claude/skills --strip-components=2 web-search-skills-main/skills

Project-level install:

mkdir -p .cursor/skills && \
  curl -sL https://github.com/Octen-Team/web-search-skills/archive/main.tar.gz | \
  tar xz -C .cursor/skills --strip-components=2 web-search-skills-main/skills

User-level install:

mkdir -p ~/.cursor/skills && \
  curl -sL https://github.com/Octen-Team/web-search-skills/archive/main.tar.gz | \
  tar xz -C ~/.cursor/skills --strip-components=2 web-search-skills-main/skills

mkdir -p ~/.codex/skills && \
  curl -sL https://github.com/Octen-Team/web-search-skills/archive/main.tar.gz | \
  tar xz -C ~/.codex/skills --strip-components=2 web-search-skills-main/skills

Recommended:

claw skill install octen-search-skill

Or install with curl:

mkdir -p ~/.openclaw/skills && \
  curl -sL https://github.com/Octen-Team/web-search-skills/archive/main.tar.gz | \
  tar xz -C ~/.openclaw/skills --strip-components=2 web-search-skills-main/skills

Adjust the target directory for your agent:

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

Usage

Use octen-web-search for a direct query:

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

Use octen-search when a question benefits from several angles. The skill calls Broad Search in queries_and_search mode, returning generated sub-queries and grouped search results without an LLM-written summary:

curl -s -X POST "https://api.octen.ai/broad-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "messages": [
      { "role": "user", "content": "latest AI chip market trends 2026" }
    ],
    "mode": "queries_and_search",
    "max_queries": 5,
    "web_search_options": {
      "count": 5
    }
  }'

When to use each skill

Need	Skill
One direct lookup	`octen-web-search`
Recent news or fast-changing topics	`octen-web-search` with topic or time filters
Comparisons, market scans, or research questions	`octen-search`
Results grouped by generated sub-query	`octen-search`

Updating

Re-run the same install command to overwrite with the latest version. If you installed from a git clone, pull the repo and copy the skills/ directory again.

git clone https://github.com/Octen-Team/web-search-skills.git
cp -r web-search-skills/skills/* ~/.codex/skills/

Get API Key

GitHub

​Skills

​API key

​Installation

​Usage

​When to use each skill

​Updating