使用示例

Dataify MCP CLI 的真实工作流与配方：从列出工具、查看参数，到搜索、解锁网页、查询采集任务状态，再到管道与 CI 自动化。

如何列出可用工具

先确认当前 Token 有哪些工具可用：

如果列表为空，提示 No tools returned. Check token/tools permissions.，请检查 Token 是否正确、是否拥有对应工具权限。

如何查看工具参数

调用前先用 schema 确认参数名、是否必填与类型，避免猜参数：

如何进行网页搜索

以 Google 搜索为例（工具名以你 dataify tools 列出的为准）：

其他搜索引擎工具（同样来自内置 tools 列表）：yandex_serp、duckduckgo_serp、bing_serp。它们的参数通过 dataify schema <tool> 查看。

如何使用 Web Unlocker

request_web_unlocker 用于解锁并抓取网页（--type 指定返回类型，例如 html）：

若提示 Tool "request_web_unlocker" was not returned by the server，先用 dataify tools 确认；内置 tools 列表里对应的是 web_unlocker，实际暴露的工具名以服务端返回为准。

如何查询采集任务状态

web_unlock_task 需要整数型参数，推荐用 --arg-json 保证类型正确：

如何传递数字 / 布尔 / 对象类型参数

普通 --name value 一律按字符串发送。当工具要求数字、布尔、对象或数组时，用 --arg-json：

形式	结果类型
`--q pizza`	字符串 `"pizza"`
`--arg-json json=1`	数字 `1`
`--arg-json enabled=true`	布尔 `true`
`--args-json '{"a":1}'`	对象 `{a:1}`

如何从文件或管道读取参数

当参数较多或想在脚本里复用，把它们放进 JSON 文件或用管道喂入：

先准备 params.json：

{
  "q": "pizza",
  "json": 1
}

执行：

如何输出原始结果或写入文件

默认输出工具返回的主要内容（文本或 structuredContent）。需要完整 MCP 结果时用 --raw；需要落盘时用 --output：

如何为耗时工具设置超时

实时采集类工具可能耗时较长，用 --timeout 调整（支持毫秒 / s / m）：

超时格式：

写法	含义
`120000`	120000 毫秒（120 秒，默认）
`30s`	30 秒
`2m`	2 分钟（120 秒）

也可通过环境变量 DATAIFY_MCP_TIMEOUT 统一设置（见下文），优先级低于命令行 --timeout。

如何调试一次失败调用

加 --debug 把请求 URL 与 JSON-RPC 请求体打印到 stderr，不影响实际请求参数与结果：

如果工具返回错误（isError），CLI 会以退出码 2 结束并把错误信息打印到 stderr。

管道与自动化

CLI 的设计便于管道串联。当标准输出不是 TTY 时，结果以纯文本/JSON 输出，方便下游处理。

用 jq 提取字段

在脚本 / CI 中使用

交互模式批量调试

支持的环境变量

可用环境变量覆盖本地配置：

变量	用途
`DATAIFY_MCP_TOKEN`	API Token（与 `DATAIFY_API_TOKEN` 等价）。
`DATAIFY_API_TOKEN`	API Token 的别名，作用同 `DATAIFY_MCP_TOKEN`。
`DATAIFY_MCP_TIMEOUT`	请求超时（毫秒数字，或带 `s` / `m` 后缀，例如 `180000`、`30s`、`2m`）。

资源

资源	说明	链接
📘 GitHub 仓库	查看源码、示例并做出贡献	GitHub
📦 CLI 模块	包说明、版本与发布信息	dataify-mcp-cli

示例

使用示例#

如何列出可用工具#

如何查看工具参数#

如何进行网页搜索#

如何使用 Web Unlocker#

如何查询采集任务状态#

如何传递数字 / 布尔 / 对象类型参数#

如何从文件或管道读取参数#

如何输出原始结果或写入文件#

如何为耗时工具设置超时#

如何调试一次失败调用#

管道与自动化#

用 jq 提取字段#

在脚本 / CI 中使用#

交互模式批量调试#

支持的环境变量#

资源#