命令 - Dataify

Dataify MCP CLI 全部命令：全局选项、交互模式，以及参数传递方式。所有命令都围绕"列出工具 → 查看参数 → 调用工具"这条主线展开。

全局选项

下列选项可用于任意命令（写在命令名之前或之后均可，例如 dataify tools --token X 或 dataify --token X tools）：

选项	说明
`--token <TOKEN>`	Dataify API Token，会作为 URL 的 `?token=...` 参数附加到 MCP 请求上。
`--timeout <VALUE>`	请求超时时间。支持毫秒数字、`30s`（秒）、`2m`（分钟），例如 `120000`、`30s`、`2m`。默认 `120000` 毫秒。
`--raw`	输出完整的 MCP `tool result`（含 `content`、`isError` 等原始字段），而不是只输出 `structuredContent` 或文本内容。
`--pretty`	控制 JSON 是否美化缩进。默认开启；传 `--pretty false` 可关闭（单行紧凑输出）。
`--output <FILE>`	把命令输出写入指定文件，而不是打印到终端。
`--header <K=V>`	追加一个自定义 HTTP 请求头，格式为 `Name=value`，可多次使用。
`--debug`	把请求 URL 与 JSON-RPC 请求体打印到 stderr，便于排查；不影响实际请求参数与结果。
`--help`	显示帮助文本（列出用法、全局选项、交互命令与参数形式）。
`--version`	显示 CLI 版本号（`0.1.9`）。

关于 MCP 地址与工具列表：CLI 内部的 MCP 地址固定为 https://mcp.dataify.com/mcp，tools 查询参数也固定为内置的 25 个工具（见下文）。解析器虽然接受 --server / --endpoint / --tools，但实际运行时会使用内置固定值，因此这三个选项目前不会对请求产生影响。你只需要配置 Token。

`dataify`（无命令 → 交互模式）

不带任何命令直接运行，若终端是交互式 TTY，则进入交互模式：

进入后会显示欢迎信息与常用命令提示，提示符为 dataify>。这是连续执行工具命令的轻量模式（不接入 AI，不会理解自然语言），适合反复调试同一批工具调用。详见下方"交互模式"一节。

如果标准输入/输出不是 TTY（例如在管道里），则不进入交互模式，而是直接打印帮助文本。

`dataify chat` / `dataify repl`

显式进入交互模式（与直接运行 dataify 效果相同）：

两者等价，都调用同一个交互循环。交互模式支持的历史记录上限为 1000 条，并带有命令补全。

`dataify tools` / `dataify list`

列出当前 Token 可见的全部工具（来自 MCP tools/list，会自动按游标翻页拉全）。

选项	说明
`--raw`	输出原始的 `{ tools: [...] }` 结构，而不是对齐后的表格。
`--output <FILE>`	将结果写入文件。
`--token <TOKEN>`	覆盖使用的 Token。

如果返回 No tools returned. Check token/tools permissions.，说明当前 Token 没有可用工具权限，或 Token 不正确。

`dataify schema <tool>`

显示某个工具的参数结构（来自该工具的 inputSchema）：参数名、是否必填、类型与说明。

参数 / 选项	说明
`<tool>`	工具名称，必填。例如 `google_search`。
`--raw`	以原始结构输出（虽然本命令本身主要输出表格，但该选项仍可用）。
`--output <FILE>`	将结果写入文件。

若工具名不存在，会报错：Tool "<tool>" was not returned by the server。先用 dataify tools 确认该工具对当前 Token 可用。

输出示例（表格列：Parameter / Required / Type / Description）：

+-----------+----------+--------+--------------------------------+
| Parameter | Required | Type   | Description                    |
+-----------+----------+--------+--------------------------------+
| q         | yes      | string | Search query text.             |
+-----------+----------+--------+--------------------------------+
| json      | no       | number | Whether to return JSON format. |
+-----------+----------+--------+--------------------------------+

类型说明：Type 列直接取自工具的 JSON Schema，可能是 string / number / boolean / array 等，也可能是 enum、anyOf、oneOf、allOf 等组合类型（当存在对应字段时）。

`dataify call <tool> [--param value]`

通用调用方式：显式通过 call 调用任意工具。第一个位置参数是工具名，其余是工具参数。

参数 / 选项	说明
`<tool>`	要调用的工具名称，必填。
`[--param value]`	工具的参数，支持多种传值形式（见文末"参数传递方式"）。
`--raw` / `--pretty` / `--output`	输出控制（见全局选项；这里写在工具参数位置上同样生效）。

dataify call <tool> ... 与 dataify <tool> ... 完全等价。

`dataify <tool> [--param value]`（直接调用）

如果你输入的"命令"不在内置命令集合中（call / tools / list / schema / config / chat / repl / help / version），CLI 会把它当作工具名直接调用，等价于 dataify call <tool> ...。这是最常用的写法。

参数命名规则：未知的长选项（--name value）会作为工具参数发送，且选项名里的连字符会被转换为下划线。例如 --no-cache true 会变成参数 no_cache。如果某个工具参数本身就带下划线，直接写 --no_cache true 即可。

`dataify config`

查看和管理本地 CLI 配置（~/.dataify-mcp-cli/config.json）。无子命令时默认执行 get。

子命令	说明
`path`	打印配置文件绝对路径。
`get`	打印当前配置。会合并显示固定的 `server` 与 `tools`，以及已保存的 `token` / `timeout`。
`set`	写入配置。仅支持 `--token <TOKEN>` 与 `--timeout <VALUE>` 两个字段；可同时指定。

说明：config get 始终附带输出固定的 server（https://mcp.dataify.com/mcp）与 tools（内置 25 个工具列表），方便你确认接入点；但这两个值不会被写入配置文件、也无法通过 set 修改。

`dataify version`

打印 CLI 版本号：

`dataify help`

打印帮助文本，内容包含用法、全局选项、交互命令与参数形式示例：

交互模式命令

在 dataify（或 dataify chat / dataify repl）进入的交互模式下，可使用以下命令。所有命令都可以不带前导 / 直接输入（例如输入 tools 等价于 /tools）；命令与参数支持引号包裹。

命令	说明
`/help`（或 `?`）	再次显示交互模式帮助。
`/tools`	列出当前 Token 可用的工具。
`/schema <tool>`	显示某个工具的参数结构。
`/call <tool> ...`	调用某个工具，例如 `/call google_search --q "pizza"`。
`工具名 ...`	直接调用工具，例如 `google_search --q "pizza" --arg-json json=1`。
`/retry`	重新执行上一条命令。
`/clear`	清屏。
`/exit`（或 `/quit`、`exit`、`quit`）	退出交互模式。

dataify> /tools
dataify> /schema google_search
dataify> /call google_search --q "pizza" --arg-json json=1
dataify> google_search --q "pizza" --arg-json json=1
dataify> /retry
dataify> /clear
dataify> /exit

提示：交互模式会记住上一条成功解析的命令，/retry 可一键重跑；输入为空则忽略；未闭合的引号会报错提示。

参数传递方式

调用工具时，参数有几种写法，用来适配不同类型（字符串 / 数字 / 布尔 / 对象 / 数组）：

形式	作用	示例
`--name value`	作为字符串参数发送（未知选项名会转成下划线）。	`dataify google_search --q "pizza"`
`--arg k=v`	显式以字符串设置参数 `k`。	`dataify call google_search --arg q=pizza --arg json=1`
`--arg-json k=v`	把 `v` 当作 JSON 解析后设置参数 `k`（得到数字 / 布尔 / 对象等）。	`dataify call web_unlock_task --arg-json page=1`
`--args-json '{...}'`	用一个 JSON 对象整体合并进参数。	`dataify call google_search --args-json '{"q":"pizza","json":"1"}'`
`--args-file file.json`	从 JSON 文件读取对象并合并进参数。	`dataify call google_search --args-file params.json`
`--stdin`	从标准输入读取一个 JSON 对象并合并进参数。	`echo '{"q":"pizza"}' \| dataify google_search --stdin`

补充说明：

默认情况下，普通 --name value 得到的是字符串值。所以如果工具要求数字或布尔，更稳妥的是用 --arg-json（例如 --arg-json json=1 得到数字 1；--arg-json enabled=true 得到布尔 true）。

--args-json 必须是 JSON 对象（不能是数组或原始值），否则报错。

--args-file 与 --args-json 会"合并"进已设置的参数；后面出现的同名键会覆盖前面的。

工具参数里不允许出现位置参数（裸字符串），也不允许在 -- 之后继续传参，否则会报错。

输出控制 --raw / --pretty / --output 既可以作为全局选项（命令前后），也可以作为工具参数位置上的一组"元选项"出现，效果一致。

固定 MCP 地址

CLI 始终向以下地址发请求（仅 <your_api_token> 由你提供）：

https://mcp.dataify.com/mcp?token=<your_api_token>&tools=user_info,web_unlocker,google_serp,yandex_serp,duckduckgo_serp,bing_serp,amazon,youtube,facebook,instagram,reddit,walmart,google,booking,indeed,airbnb,google_play_store,github,tiktok,linkedin,glassdoor,twitter,crunchbase,zillow,ebay

你无需（也无法）修改 MCP 地址或 tools 列表，只需确保 Token 正确即可。

命令

全局选项#

dataify（无命令 → 交互模式）#

dataify chat / dataify repl#

dataify tools / dataify list#

dataify schema <tool>#

dataify call <tool> [--param value]#

dataify <tool> [--param value]（直接调用）#

dataify config#

dataify version#

dataify help#

交互模式命令#

参数传递方式#

固定 MCP 地址#