momodi

Momo 决策伙伴 · 你的常驻 AI 调研顾问，现在可以在终端和任何支持 MCP 的 AI Agent 里直接使用。

告诉 Momo 你要做的决策：选品、出海、进入某个市场、评估竞品。它会先澄清范围，再自主完成调研，把来源、假设与下一步建议整理成一份 MBB 级别的研究报告。无需注册可先聊 3 轮。

• 好决策，从有出处的数据开始：报告里每个关键数据都注明来源，关键数据经交叉验证。
• 8 大领域实测数据源：TikTok、Reddit、YouTube 等海外社媒原帖；Amazon、eBay、Shein、Lazada 与 30+ DTC 品牌定价；App Store、Google Play、Steam 真实评价；Yahoo Finance、SEC 财报原文与 Polymarket 预测市场；美国海关逐票提单；Booking、Airbnb 等生活服务数据。
• 先看别人的问题能走多远：Discovery 上有公开的完整调研报告，可以先看研究过程再判断是否适合你。

产品主页 m.moments.top/momo · 公司官网 moments.top · 联系我们 [email protected]

---

这个包把摸摸底的调研能力搬进终端和 AI Agent：一个 npm 包，两个入口，momo 命令行和 momo-mcp MCP 服务，共用一个 HTTP 客户端。

不注册先试

npx -y momodi try "宠物殡葬"

不需要账号，匿名 3 轮。用完后会打印注册链接，注册后这段对话会保留。

拿 API key

登录 m.moments.top，打开 /settings/keys，点「生成」。明文只显示一次。

export MOMO_API_KEY=mmd_xxx
npx -y momodi whoami

环境变量是唯一配置来源，没有配置文件。可选 MOMO_BASE_URL（默认 https://m.moments.top）。

命令一览

命令	参数	作用
momo research <topic>	--tier standard|deep、--no-wait、--json、--out <file>、--interval <s>	提交调研并轮询到完成，报告 HTML 写 stdout 或 --out
momo attach <runId>	--json、--out <file>、--interval <s>	对已存在的调研接着等
momo try <message>	--json	匿名体验，不要 key
momo reports	--json、--limit <n>	列出我的报告，最新在前，默认 20 条
momo report <id>	--out <file>、--json	取回一份报告；id 可以是 reportId 前缀或 runId
momo discovery	--json	浏览公开选题，不要 key
momo whoami	无	账号、等级、今日 token、key 前缀

--json 时所有命令的 stdout 变为单行 JSON，错误写成 {"error":…} 到 stderr。

典型用法：

momo research "兰州牛肉面出海" --out report.html
momo research "东南亚玩具书" --tier deep --no-wait --json   # 拿 runId，稍后 attach
momo reports --json | jq -r '.[].id' | xargs -I{} momo report {} --out {}.html

退出码

码	含义	触发
0	成功
1	未分类错误	网络异常、JSON 解析失败、应用 5xx
2	用法错误	缺参数、未设 key、--tier 非法、id 前缀多个匹配
3	鉴权失败	401；403（Momo 权限被停用）
4	调研失败	status:failed，含取消、超时、完成但无报告
5	额度不足	今日 token 用尽（429）；匿名轮数用尽
6	报告未就绪	momo report <runId> 时调研还在跑
7	并发占用	已有调研在运行（409）
130	用户中断	Ctrl-C，调研仍在后台，momo attach <runId> 接着看

接入 Agent 宿主

包名是 momodi，momo-mcp 是它的第二个 bin，所以 npx 要用 -p 指定包。

# Claude Code
claude mcp add momo -e MOMO_API_KEY=mmd_xxx -- npx -y -p momodi momo-mcp

# Cursor / Codex  (.cursor/mcp.json / ~/.codex/config.toml 等价)
{ "mcpServers": { "momo": { "command": "npx", "args": ["-y", "-p", "momodi", "momo-mcp"], "env": { "MOMO_API_KEY": "mmd_xxx" } } } }

# WorkBuddy  ~/.workbuddy/mcp.json（macOS 上 command 改为 `which npx` 的绝对路径，改完重启）
{ "mcpServers": { "momo": { "type": "stdio", "command": "/opt/homebrew/bin/npx", "args": ["-y", "-p", "momodi", "momo-mcp"], "env": { "MOMO_API_KEY": "mmd_xxx" } } } }

更多排障见 docs/cli.md。WorkBuddy 也可以直接用 momo-research/SKILL.md 这个 Skill 调命令行。

MCP 工具

工具	入参	返回
start_research	topic、tier?	{runId, status, reused?}；已有调研在跑时直接返回那个 runId
get_research_status	runId	{status, stage, reportId?, error?}，running 时等 30 秒再查
get_report	reportId	报告 HTML 全文
list_reports	limit?	[{id, title, createdAt}]，最新在前

Agent 调一次 start_research，之后只在 get_research_status 和等待之间循环；done 后用 reportId 调 get_report。

限制

• 一个账号同时只能跑一个调研；第二个会得到 409（退出码 7）。批量请串行。
• 额度按每日 token 配额计，用尽返回 429（退出码 5），次日重置。
• --tier 只有 standard 和 deep；初判不产出报告，所以不提供。
• 报告格式只有 HTML。

开发

npm install
npm test          # vitest，全部对着本地 mock 应用跑，不连真服务
npm run build     # tsc → dist/
npm run trace     # 从测试标签生成故事追溯矩阵，故事无覆盖时退出 1

联系我们

• 商务与合作：[email protected]
• 公司官网：moments.top
• 产品主页：m.moments.top/momo
• 问题反馈：发邮件到 [email protected]，或到 GitHub 提 issue

许可

MIT，见 LICENSE。