# 命令行

> okdata 命令行：npx okdata。一句话找接口、看价格、带花费上限地调用、查余额，一步写好 Claude Code、Cursor、Codex 的 MCP 配置。

网页版：https://okdata.online/zh/docs/cli/

在终端里，或者让在终端里干活的智能体，直接找接口、调接口。

```sh
npx okdata login                     # 或者先全局安装：npm install -g okdata
npx okdata call douyin.videos.search 'query=露营装备' 'sort=latest'
```

需要 Node 20.3+。`okdata login` 会打开一个链接，核对 8 位码后批准，这台电脑就连上了你的账号：会新建一个叫「Command line」的 Key 存在本机，不会显示出来。也可以不登录，直接设环境变量 `OKDATA_API_KEY`。

第二行就是控制台[调试台](/zh/console/playground/)「命令行」一栏给出的写法：接口 ID 加上每个参数的 `名字=值`（有空格或中文的值加引号）。列表用逗号分隔（`ids=1,2,3`）或 JSON（`ids=["1","2"]`）。

## 命令

| 命令 | 花钱吗 | 做什么 |
| --- | --- | --- |
| `okdata find <关键词…>` | 免费，不用 Key | 用中文或英文描述找接口，提到平台名会只搜这个平台 |
| `okdata show <接口 ID>` | 免费，不用 Key | 参数、价格、翻页方式、示例和文档链接；加 `--lang zh` 看中文 |
| `okdata call <接口 ID> 名字=值…` | 按次计费 | 调一次。`--max-price 0.05`：可能超过这个价就拒绝，不扣钱；`--out items.jsonl` 存结果 |
| `okdata call … --pages N --max-spend X` | 按次计费 | 最多翻 N 页，总花费可能超过 X 美元前就停 |
| `okdata more <请求号>` | 免费 | 24 小时内重新读取某次调用的结果；`--receipt` 看扣费记录 |
| `okdata balance` | 免费 | 余额、这个 Key 的限额和账号的频率档位 |
| `okdata run <plan.json>` | 加 `--yes` 才计费 | 一组调用：默认只算出最多花多少，`--yes` 才在 `--max-spend` 以内执行 |
| `okdata login` | 免费 | 把这台电脑连到你的账号 |
| `okdata setup --client claude-code` | 免费 | 把 okdata MCP 写进客户端配置；也支持 `cursor`、`codex`，可以一次写多个 |

每个命令都支持 `--json`（标准输出只有一个 JSON，包括出错时）和 `--help`。不加 `--json` 时，摘要输出到 stderr，结果每行一个 JSON 输出到 stdout，所以可以直接接 `jq`：`okdata call … | jq .text`。

## 退出码

| 码 | 含义 |
| --- | --- |
| 0 | 完成 |
| 1 | 命令、参数写错了，什么都没发出去 |
| 2 | 被拒绝，没扣钱；错误里写了原因和要不要重试 |
| 3 | 扣了钱但失败或只拿到一部分（比如查无此项照常扣费、批量里有缺失、翻页中途停下） |
| 4 | 没有 Key，或 Key 无效、已停用；运行 `okdata login` |
| 5 | 网络问题，没收到 API 的回应 |

## 源码

命令行工具在 [GitHub](https://github.com/okdataapi/okdata) 上开源（MIT），npm 包名是 `okdata`。在代码里调用请用 [SDK](/zh/docs/sdk/)。

更新于 2026-11-13