命令行

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

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。

第二行就是控制台调试台「命令行」一栏给出的写法：接口 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 上开源（MIT），npm 包名是 okdata。在代码里调用请用 SDK。