DeepSearch 定向检索
deepsearch-webPerform targeted web searches for specific sites or time periods using the DeepSearch model, delivering more accurate results than standard AI search tools while requiring additional processing time.
Instructions
针对站点或时间范围的 DeepSearch 定向检索，拥有比AI Agent内置搜索更好的搜索效果但更耗时，需要平衡需求
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| top_k | No | ||
| locale | No | ||
| filters | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| usage | Yes | ||
| metadata | Yes |
Implementation Reference
- main.ts:102-132 (registration)Registers the 'deepsearch-web' MCP tool with title, description, input/output schemas, and an inline handler that delegates to DeepSearchWebAgent.search and formats the result.
server.registerTool( "deepsearch-web", { title: "DeepSearch 定向检索", description: "针对站点或时间范围的 DeepSearch 定向检索，拥有比AI Agent内置搜索更好的搜索效果但更耗时，需要平衡需求", inputSchema: deepSearchWebInputShape, outputSchema: searchResultShape, }, async (args) => { const toolLogger = logger.child({ tool: "deepsearch-web" }); toolLogger.info("收到工具调用", args); const result = await deepsearchWebAgent.search(args.query, { top_k: args.top_k, locale: args.locale, filters: args.filters, }); const structured = searchResultSchema.parse(result); toolLogger.info("完成工具调用", { itemCount: structured.items.length }); return { content: [ { type: "text" as const, text: JSON.stringify(structured, null, 2), }, ], structuredContent: structured, }; }, ); - main.ts:33-40 (schema)Defines the input schema for deepsearch-web tool, extending deepSearchInputShape with validation requiring 'site' or 'time_range' in filters.
const deepSearchWebInputShape = { ...deepSearchInputShape, filters: z .record(z.any()) .refine((filters) => typeof filters.site === "string" || typeof filters.time_range === "string", { message: "filters 需要包含 site 或 time_range 字段", }), }; - main.ts:110-131 (handler)The inline handler function for the deepsearch-web tool: logs the call, invokes the agent's search method, parses the result, and returns formatted content with structured data.
async (args) => { const toolLogger = logger.child({ tool: "deepsearch-web" }); toolLogger.info("收到工具调用", args); const result = await deepsearchWebAgent.search(args.query, { top_k: args.top_k, locale: args.locale, filters: args.filters, }); const structured = searchResultSchema.parse(result); toolLogger.info("完成工具调用", { itemCount: structured.items.length }); return { content: [ { type: "text" as const, text: JSON.stringify(structured, null, 2), }, ], structuredContent: structured, }; }, - DeepSearchWebAgent.search: Enforces required filters (site or time_range), logs, and delegates to the MCP client search.
async search(query: string, options: SearchOptions = {}): Promise<SearchResult> { const filters = options.filters ?? {}; if (!filters.site && !filters.time_range) { this.logger.error("缺少必要过滤条件", { query, options }); throw new Error("deepsearch-web 需要提供 site 或 time_range 过滤条件"); } this.logger.info("执行定向检索", { query, options }); return this.client.search(query, { ...options, filters }); } - source/api.ts:232-234 (helper)In DeepSearchTransport.buildUserPrompt, adds specific instruction for 'deepsearch-web' toolName to enforce using site/time_range filters in the API prompt.
toolName === "deepsearch-web" ? "必须使用 filters 中的 site/time_range 限制，确保返回结果满足条件。" : "可结合 filters 中提供的约束优化检索。";