---
title: "momodi CLI 发布：在终端和 AI 助手里发起研究、取回报告"
url: "https://moments.top/blog/news/momodi-cli-launch"
description: "摸摸底发布 momodi CLI 与 MCP 服务，当前 npm 版本为 0.1.1。用户可在终端发起研究、查询进度并取回 HTML 报告，或连接支持 MCP 的 AI 助手。本文给出上手步骤、使用边界与当前试用问题。"
updated: "2026-10-19"
source: "莫曼茨智能科技（上海）有限公司"
---

# momodi CLI 发布：在终端和 AI 助手里发起研究、取回报告

产品宣传视觉｜把研究，接进你的工作。（AI 辅助创作）

![momodi CLI 宣传图：橙色摸摸底形象将研究接入电脑工作台，屏幕为抽象终端符号](/news/momodi-20261019/cli-promo.png)

如果你已经在终端或 AI 编程助手里工作，遇到一个需要查证的商业问题，常常还要打开网页、重新说明背景，再把报告搬回手头的项目。任务一多，还容易分不清哪一份报告对应哪个问题。

**摸摸底于 2026 年 10 月 18 日在 npm 发布 momodi，截至 10 月 19 日当前版本为 0.1.1。这个包提供命令行和 MCP 服务两种入口，让用户在终端或支持 MCP 的 AI 助手里发起研究、查看进度、取回报告。**

它带来的变化是工作入口：研究结果可以进入现有工作流程，减少手动切换和复制。它不是在电脑本地离线运行的研究模型，也不代表换了入口就能绕过账号权限和研究额度。

图 1｜npm 公开发布页截图，拍摄于 2026 年 10 月 19 日，页面显示版本 0.1.1。

![npm 上 momodi 软件包的真实发布页面，显示 0.1.1 版本与安装入口](/news/momodi-20261019/cli-npm.png)

## 哪些人值得用，哪些人直接打开网页就好

如果你偶尔做一次市场研究，希望边看边聊，使用 [Momo 网页](https://m.moments.top/momo)即可，不必为了这次更新去学习命令行。

CLI 是“在终端输入命令来操作工具”的意思。它更适合已经使用终端、脚本或 AI 编程助手的人。例如，你正整理一份竞品方案，希望把“提交研究—查看进度—保存报告”连起来，再把报告放到项目目录中交给同事复核。

MCP 则是一种让 AI 助手连接外部工具的方式。连接后，助手可以调用 Momo 提交研究、查询进度和读取结果。对使用者来说，区别在于可以在当前助手中交代任务，无需每一步都自己输入命令；具体配置仍以所用助手的要求为准。

图 2｜研究怎样接回工作：交代问题、保留任务编号、取回报告，再由人核查。这是流程说明图。

![CLI 与 MCP 研究流程示意图：交代问题、提交研究、取回 HTML 报告、由人核查](/news/momodi-20261019/cli-flow-v2.png)

## 先试一个小问题，再决定是否接入工作

运行环境需要 Node.js 20 或以上。已安装 Node.js 的用户，可以在终端运行以下命令，先体验匿名澄清：

```bash
npx -y momodi@0.1.1 try "我准备把便携咖啡机卖到新加坡，先帮我澄清需要研究什么，不启动正式研究。"
```

这里固定版本为 0.1.1，便于对照本文。匿名体验提供 3 轮试聊，用于明确问题，不等于免费完成正式研究。

**当前版本的实测情况也需要说明。** 10 月 19 日，我们使用相同场景测试，收到了围绕产品形态、目标人群、渠道和成本的澄清回复；随后获取剩余试聊轮数时出现 HTTP 400 提示，命令以非零状态结束。如果你遇到相同情况，可以先使用网页入口。自动化脚本也不能只看到有回复就认定整条命令成功，应同时检查退出状态和错误信息。

这次没有运行完整的正式研究，因此不能据此宣称正式报告已通过端到端验证，更不能把一次澄清回复当成市场结论。

## 已有账号：把报告保存到手边，而不是来回复制

登录产品后，可在 [API 密钥设置页](https://m.moments.top/settings/keys)生成密钥。它相当于允许工具使用你账户的凭证，明文只显示一次，请保存在自己的安全环境中，不要放进公开代码、截图或群聊。

按 npm 文档将密钥设置为环境变量 `MOMO_API_KEY` 后，可以先运行：

```bash
npx -y momodi@0.1.1 whoami
```

确认账户后，再提交已想清楚的问题。下面是操作示例，不代表我们已经执行了这项研究：

```bash
npx -y momodi@0.1.1 research "比较新加坡便携咖啡机的主要竞品、渠道和试销前需核实的成本，区分已证实信息与假设" --tier standard --out singapore-coffee.html
```

研究完成后，报告以 HTML 文件保存，可以用浏览器打开。文件名建议包含主题或日期，避免后续任务覆盖同名文件。

如果不想让终端一直等待，可加上 `--no-wait --json`，记下返回的任务编号。之后使用 `attach` 加上该编号继续查询。**中断终端等待不等于取消后台研究**，没有必要因为关掉窗口就重复提交。

已有报告也可以通过 `reports` 列出，再用 `report` 和报告编号取回。这对多人协作的直接帮助是：交接时保留任务编号与原始报告，同事知道自己正在复核哪一份材料。

图 3｜三个常用命令。图中的任务编号和报告编号需要换成自己的编号；分行展示的命令应连成一行输入。

![momodi CLI 命令速查：reports 列出报告、attach 继续等待任务、report 取回报告](/news/momodi-20261019/cli-commands-v2.png)

## 让 AI 助手接着做，也要保留人的检查

包内的 `momo-mcp` 服务提供四个工具：发起研究、查询研究状态、读取报告、列出报告。支持 MCP 的宿主可按照自己的配置格式启动：

```bash
npx -y -p momodi@0.1.1 momo-mcp
```

同时应为该服务配置 `MOMO_API_KEY`。这条启动命令不等于已经完成各类助手的安装配置，具体方法可参考 [npm 文档](https://www.npmjs.com/package/momodi)。

可以把工作拆成一个容易检查的顺序：先交代商业问题，再等待研究完成，取回原始报告，然后要求助手把每个重要结论对应到来源、假设和待核实事项。最后由人打开关键来源，检查是否过时、是否适用于自己的市场。

报告进入 AI 助手后仍可能被误读。不要让后续助手在摘要中删掉限制条件，也不要因为它能自动读报告，就默认它可以自动决定采购或投资。

## 接入前，先知道这些限制

- **一个账号同时只能运行一个研究。** 多个选题应排队处理，不要并发重复提交。
- **正式研究受每日 token 额度限制。** 可以把 token 理解为模型处理文字等内容的计量单位；可用量以账户信息为准，安装 npm 包不等于获得无限研究权限。
- **CLI 正式研究提供 standard 和 deep 两档。** 网页中的初判不产出正式报告，因此没有作为 CLI 的报告档位提供。
- **当前报告格式为 HTML。** 不应把它宣传为已支持直接导出 Word、Excel 或 PDF。
- **这是联网服务。** 默认连接 `m.moments.top`，研究任务会发送到服务端。提交内部资料之前，应确认组织允许的资料范围和使用方式。

对已有技术工作流程的人，momodi CLI 提供了一个更顺手的研究入口。是否值得接入，先用一个小任务判断：能否保留研究记录、找到原始报告，并让下一位接手的人知道哪些结论还需要核实。

*版本、命令及限制依据 2026 年 10 月 19 日 npm 公开包 0.1.1 核对；已检查发布包并进行一次匿名试聊，尚未验证正式付费研究和各类 MCP 宿主的完整流程。问题反馈：contact@moments.top。*