跳到正文
联系我们 开始接入
开发者平台BetaiKho EmbeddediKho MCP & CLI
MCP 与 CLI

iKho CLI

在终端里访问你的 iKho 录音:浏览、搜索、读取逐字稿、下载音频、查看智能笔记,无需打开应用。

iKho CLI 处于内测阶段,命令行为与参数以联调时提供的正式文档为准;账号由对接工程师开通,见联系我们。

前置条件

  • Node.js 20 或更高版本
  • 一个 iKho 账号

安装

全局安装 @ikho/mcp 包,它会同时提供 ikho 命令行工具:

bash 
npm install -g @ikho/mcp

内测阶段,@ikho/mcp 的正式安装源随账号开通邮件发放,请以邮件中的说明为准。

登录

通过浏览器登录,令牌会自动保存到本地,后续命令无需重复登录:

bash 
ikho login

命令参考

命令说明
ikho login通过浏览器登录,令牌自动保存
ikho list列出录音,支持关键词与日期筛选
ikho show <id>显示单条录音的完整元数据
ikho transcript <id>输出逐字稿,可带说话人与时间戳
ikho note <id>查看 iKho 智能引擎生成的笔记
ikho download <id>下载录音音频到本地文件

ikho list

bash 
ikho list                                     # 最新一页录音
ikho list --query "销售拜访"                    # 按名称关键词筛选
ikho list --from 2026-04-01 --to 2026-04-30    # 按日期区间筛选

ikho show

bash 
ikho show <id>    # 查看单条录音的元数据与可用产物

ikho transcript

bash 
ikho transcript <id>              # 逐字稿
ikho transcript <id> --speaker    # 附带说话人标注
ikho transcript <id> --ts         # 附带每段时间戳

ikho note

bash 
ikho note <id>            # 查看智能笔记(Markdown)
ikho note <id> -o note.md    # 保存到文件

ikho download

bash 
ikho download <id> -o meeting.mp3    # 下载音频到指定文件

组合用法

加上 --json 后,输出可直接交给 jq 等工具做管道处理。例如列出本月录音并只保留 id 与名称:

bash 
ikho list --from 2026-07-01 --to 2026-07-31 --json | jq '.items[] | {id, name}'

输出格式

不带参数时,命令输出适合阅读的表格;加上 --json 则输出结构化 JSON,便于脚本与管道组合。所有错误信息写入 stderr,保持 stdout 干净,方便管道使用。