Dataify MCP 所有工具的返回数据均采用 JSON 格式，通过 MCP Structured Tool Result（mcp.NewToolResultStructured）传递给客户端。

⚠️ 注意：本 MCP 服务不透传固定字段结构的响应样例。各工具返回的 JSON 字段由对应的上游接口（SERP 引擎、网页采集 Builder 等）决定，本文档不提供字段级示例。如需具体响应字段，请参考实际接口返回或 Dataify 官方文档。

响应结构概述

每个工具调用成功后，返回 mcp.CallToolResult，内部包含：

结构化数据：上游接口返回的 JSON 对象（服务端会解析嵌套 JSON 字符串后透传）

降级文本：格式化后的 JSON 字符串，当客户端不支持结构化结果时使用

工具调用失败时，返回错误信息字符串（见下方「错误处理」）。

SERP 搜索类输出格式控制

Google / Bing / Yandex / DuckDuckGo 等搜索引擎工具支持通过 json 参数控制输出格式：

具体字段取决于上游搜索引擎；json=3 时返回原始 HTML。

SERP 搜索类工具默认启用 5 分钟缓存：

相同参数的请求在 5 分钟内会直接返回缓存结果

缓存搜索免费，且不计入搜索统计

设置 no_cache=true 可跳过缓存，获取最新结果

工具调用出错时，返回 MCP Error Result，错误信息为纯文本字符串。以下为代码中已确认的错误信息：

错误信息	触发原因
`当前工具不可用：未传 tools 时仅允许免费工具；传入 tools 时需要匹配已启用的工具或分类`	工具不在账户权限范围内，或未在 `tools` 参数中启用
`序列化 <标签> 结果失败: <err>`	上游返回数据无法解析为 JSON
`不支持的 spider_id: <标识>`	采集类工具的 `spider_id` 不在支持列表中
`lowest_price 不能大于 highest_price`	Amazon 产品价格区间参数校验失败
`page_turning 必须大于等于 1`	分页参数 `page_turning` 校验失败（部分采集工具）

其他由上游接口返回的错误（如网络超时、目标站点限制等）以原始文本透传，本文档不逐一列举。