常见问题 FAQ

Q1：连接成功但无法调用工具怎么办？

请按顺序检查以下内容：

API Token 是否有效 — 在 Dataify 控制台确认 Token 未过期

tools 参数中的工具名是否正确 — 工具名必须与服务端注册名完全匹配（如 google_search，不是 google_serp）

当前账户是否拥有对应工具权限 — 部分工具需要特定订阅等级

MCP 工具是否已开放支持 — 联系 Dataify 官方确认

未授权时的典型错误信息：

当前工具不可用：未传 tools 时仅允许免费工具；传入 tools 时需要匹配已启用的工具或分类

Q2：如何获取可用工具列表？

两种方式：

查看本文档：「工具」包含全部 81 个工具的完整列表和说明

通过 MCP 客户端查看：配置完成后，客户端会列出当前可见的所有工具

查询服务端：使用 scraper_serp_tools 工具按产品 ID 查询工具列表和积分价格

联系官方：Dataify 客服可提供当前账户权限范围内的完整工具清单

Q3：Dataify MCP 支持哪些传输方式？

支持 4 种传输方式（通过启动参数 -transport 指定）：

方式	参数值	说明
STDIO	`stdio`	标准输入输出
HTTP	`http`	Streamable HTTP（推荐远程使用）
SSE	`sse`	Server-Sent Events 长连接
双模式	`both`	同时提供 HTTP + SSE（默认）

详见「远程模式 / 进阶」。

Q4：不传 tools 参数会怎样？

不传 tools 参数时，服务端仅展示免费工具。尝试调用非免费工具会返回「当前工具不可用」错误。

建议始终在 URL 中指定需要的工具列表，例如：

?token=xxx&tools=google_search,request_web_unlocker,amazon_product

Q5：SERP 搜索结果有缓存吗？如何获取最新数据？

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

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

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

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

Q6：网页解锁（Web Unlocker）支持哪些功能？

request_web_unlocker 是通用网页解锁 API，支持：

输入任意公开 URL

智能识别并处理 CAPTCHA 验证码

自动执行 JavaScript 渲染（SPA / 动态内容）

返回 HTML 源码或 PNG 截图（可同时返回）

自定义代理国家/地区、HTTP Headers、Cookies

阻止特定资源加载（JS/CSS）加速采集

等待指定 CSS 选择器出现后再返回

默认超时时间 180 秒。详见「数据输出格式」中的参数说明。

Q7：Amazon 产品采集支持哪些方式？

amazon_product 工具是一个复合工具，通过 spider_id 参数切换采集方式：

spider_id	采集方式	必需参数
`amazon_product_by-asin`	按 ASIN 采集	asin
`amazon_product_by-url`	按 URL 采集	url
`amazon_product_by-keywords`	按关键词搜索	keyword
`amazon_product_by-category-url`	按类别 URL 采集	url
`amazon_product_by-best-sellers`	按畅销榜采集	url 或 category_url

Q8：服务健康检查端点有哪些？

端点	用途
`/healthz`	存活探针 — 进程存活即返回 200 OK
`/readyz`	就绪探针 — 依次检查 MySQL / ClickHouse / Redis，全部可达返回 200

Q9：Token 泄露了怎么办？

立即在 Dataify 控制台 → 用户设置 → API Token 重新生成新 Token

更新所有客户端配置中的 Token

旧 Token 会立即失效

⚠️ 请勿将 Token 提交至 GitHub 等公开代码仓库。

常见问题

常见问题 FAQ#

Q1：连接成功但无法调用工具怎么办？#

Q2：如何获取可用工具列表？#

Q3：Dataify MCP 支持哪些传输方式？#

Q4：不传 tools 参数会怎样？#

Q5：SERP 搜索结果有缓存吗？如何获取最新数据？#

Q6：网页解锁（Web Unlocker）支持哪些功能？#

Q7：Amazon 产品采集支持哪些方式？#

Q8：服务健康检查端点有哪些？#

Q9：Token 泄露了怎么办？#