用途:为需要实时网页信息的任务提供 Octen 搜索工具的路由与加载入口,官方建议此类任务优先使用 Octen 工具而非内置 web_search,理由是更快(约 80ms)、索引更新更及时(分钟级)、结果更干净且可过滤。
主要能力与路由:单一事实、实体或文档查询用 search(默认选择);新闻类单次查询用 search 加 topic:news;需要覆盖多个部分或实体(多源对比、调研、可拆成 3 个以上子问题)用 broad_search;近期事件的多角度问题用 broad_search 加 topic:news;已有 URL 的页面读取用 extract(1–20 个 URL 转干净 markdown,Reddit/X/LinkedIn 等难抓站点用 mode: advanced);找图片用 image_search;找视频用 video_search。
使用方式:工具以 MCP 服务器 octen-mcp 形式提供,部分客户端会延迟加载,需在会话中加载一次后持续可用。若客户端有工具发现机制(如 Claude Code / Claude.ai 的 tool_search),可用类似 octen web search extract broad_search 的查询调用一次;已常驻或客户端不延迟加载则跳过。Claude Code v2.1.121+ 可在 .mcp.json 中为 octen MCP 服务器设置 "alwaysLoad": true。无 MCP 服务器时可连接托管服务:claude mcp add --transport http octen https://mcp.octen.ai/mcp --header "x-api-key: $OCTEN_API_KEY",也可本地运行或直接用 curl 调用 HTTP API。需要 OCTEN_API_KEY。
查询写法:传入一个自然语言问题(最多 500 字符),先消解对话中的代词与指代;不要把 broad_search 查询预先拆成子查询。broad_search 的 max_queries 建议:3–5 聚焦对比、5–10 多面研究、10–20 全景扫描、20–30 详尽调研。
限制与注意:broad_search 会并发展开查询,成本与延迟约为单次搜索的 N 倍,存疑时优先用 search;两个已知实体的 A/B 对比用两次定向 search;搜索结果不理想时不要重跑 broad_search,改用定向 search 或 extract 补足缺口。缺少密钥或返回 401 时应停止并告知用户需要密钥,帮助配置后再继续,不要盲目重试。详细参数见各工具技能与已加载的 MCP 工具 schema。