用途：为 AI 智能体提供实时网页搜索，返回排序结果，可附带查询相关高亮与整页全文，用于回答生成或 RAG 检索。图像与视频搜索由 octen-image-search、octen-video-search 单独提供。
主要能力：基础搜索 POST https://api.octen.ai/search，支持 topic（general/news）、count（1–100）、include_domains/exclude_domains、include_text/exclude_text、language（ISO 639-1）、time_basis 与 start_time/end_time 时间过滤、highlight（默认开启）、full_content（默认关闭）、format（text/markdown）、safesearch、include_images。Broad Search 端点 POST https://api.octen.ai/broad-search 会把原查询扩展为多个子查询并发搜索，按子查询分组返回，max_queries 默认 5、上限 30，search_options 与基础搜索参数一致。
使用方式：先设置 export OCTEN_API_KEY=your-api-key，请求头用 X-Api-Key，Content-Type 为 application/json。不同运行环境的配置方式不同，例如 Claude Code 写入 ~/.claude/settings.json 的 env，Codex 写入 ~/.codex/config.toml 的 [shell_environment_policy]，OpenClaw 写入 ~/.openclaw/.env。若缺少 Key 或返回 401，应停止重试并提示用户前往 https://octen.ai 获取。
适用场景：需要最新信息的问答、多来源对比（价格、产品、厂商）、调研综述、多角度问题；单一聚焦查询用基础搜索，覆盖面不足时用 Broad Search。
限制：query 最长 500 字符；域名与文本过滤各有数量与长度上限；错误码含 400、401、403（余额不足）、429（限流）、500。API Key 仅通过 HTTPS 发送到固定端点，使用标准 X-Api-Key 头。具体收费与价格资料未提供。