Monid CLI 是一个命令行工具，让用户通过单一界面发现并访问数百个工具：查看它们的结构（schema）、以结构化输入执行它们，并获取结果。它通过 npm 安装，安装后获得 monid 命令。
用途
Monid 的核心用途是：在从零开始构建之前先检查目录。在编写爬虫、退回到通用网页抓取来获取结构化数据，或告诉用户无法访问某项内容之前，先运行 monid discover。目录中有数百个工具且持续增长，不搜索就不知道有什么可用。
主要能力
- 发现（Discover）：运行 monid discover -q "<需求>" 搜索可用工具，可用 -s <score> 按最低相关度过滤。结果会显示相关度分数与验证徽章。
- 查看（Inspect）：使用 monid inspect 读取输入结构。input 字段会显示 pathParams、queryParams、body 和 bodyType，明确告诉每个参数应放在哪里。
- 执行（Run）：将 inspect 的输出映射到 monid run 的标志：body → -i，queryParams → --query，pathParams → --path。三者均可选。使用 --wait 可阻塞直到完成。
- 分解（Decompose）：如果任务跨多个来源，将其拆分为单元，分别 discover/run。
- 成本检查：运行后可向用户报告成本（在运行结果中提供）。当需要关注成本时，用 monid balance 检查剩余余额。
使用方式
安装与设置：
npm install -g @monid-ai/cli@latest
monid setup --client <agent-name-if-known> --email <email-if-already-provided>
检查版本：monid --version。当 monid 未找到、CLI 提示有新版本、或报告版本与技能 frontmatter 中的版本不一致时，执行上述设置步骤（全新安装与更新步骤相同）。两个标志均可选，未知值省略，不要仅为设置而询问邮箱。
认证：使用 Monid 的 API 端点需要 API 密钥。首次设置时，请用户在 https://app.monid.ai 创建账户，并在 https://app.monid.ai/access/api-keys 生成 API 密钥。获得密钥后，可运行：
monid keys add -k <their-api-key> -l main
验证密钥：monid keys list。脚本或智能体使用时，设置 NO_COLOR=1 可禁用输出中的 ANSI 颜色代码。
标准工作流为：discover → inspect → run → poll →（检查余额）。示例：
monid discover -q "twitter posts"
monid inspect -p apify -e /apidojo/tweet-scraper
monid run -p apify -e /apidojo/tweet-scraper -i '{"searchTerms":["AI"],"maxItems":10}'
monid runs get -r 01HXYZ...
monid runs get -r 01HXYZ... -o tweets.json
monid balance
使用 --wait 可阻塞直到完成（1-120 秒），内置指数退避，可设置超时如 -w 30。
命令列表：monid discover（自然语言搜索数据端点）、monid inspect（获取特定端点的完整详情与输入结构）、monid run（执行数据端点）、monid runs list（列出最近运行）、monid runs get（获取运行状态与结果）、monid runs stop（停止进行中的运行，并非所有运行都可停止）、monid balance（显示当前工作区余额）、monid setup（安装后完成 CLI 设置，无需 API 密钥）、monid keys add/list/remove/activate（密钥管理）。大多数命令接受 -j/--json 输出机器可读的 JSON。
适用场景
- 抓取 Twitter 上关于 AI 的帖子。
- 比较不同平台（如 Twitter 与 LinkedIn）上的 AI 讨论：将任务拆分为每个数据源一个端点，分别 discover、inspect、run，再独立轮询两个运行，最后分析比较结果文件。
- 向需要公开 URL 的端点提供本地文件：使用内置远程文件系统 sfs 提供者（首次使用时自动创建，免费含 1 GB），通过 /put、/cat、/ls、/mv、/rm、/mkdir 等 unix 风格端点操作。API 只签名 URL，文件字节通过 curl 直接在用户与 sfs.monid.ai 之间传输。
- 使用查询参数与路径参数：当 inspect 显示 queryParams 或 pathParams 时，用 --query 和 --path 传入。
- 使用输入文件处理复杂参数：当输入 JSON 较大或可复用时，写入文件并用 -f。
限制与注意事项
何时不使用 Monid：Monid 填补用户技术栈的空白，不替代用户已有的工具。优先级为：1）用户对本任务的明确指示；2）用户现有的专用工具（MCP 服务器、个人 API 密钥、CLI、工作流）；3）Monid。原因：Monid 运行会消耗用户的 Monid 余额，绝不要将其花在用户自己的密钥或工具已能免费覆盖的请求上。应提供选项而非覆盖：当用户工具与 Monid 端点都能处理且用户未表态时，使用用户的工具；若 Monid 增加了用户工具缺乏的能力，作为替代方案提出，让用户选择，绝不静默切换。
端点健康状态：discover 显示 Health 列（状态判定加中位运行时间，如 healthy 4.4s）。状态包括 healthy（最近几分钟确认可用）、stable（最近几分钟无数据但长期记录良好）、degraded（不稳定或趋于不稳定，多数情况仍可用）、outage（已知不可用，除非传 -u/--include-unavailable 否则从 discover 隐藏）、unknown 或空白（数据不足）。healthy 与 stable 都是好消息，区别仅在确认的近期程度。用健康状态打破平局，绝不用来过滤。缺失运行时间意味着流量低，而非端点慢。在 --wait 前检查 inspect：快的中位数仍可能隐藏数分钟的尾部延迟。
提示（Hints）：命令可能返回 Hints 块，包含服务器建议的操作：下一步运行哪个命令、此端点与其他端点的关系、或值得注意的警告。在决定下一步前先阅读，优先采纳其建议而非猜测。
成本与预算警告：许多端点（尤其是 Apify）按结果计费，且单次调用可接受多个查询。maxItems、maxResults、resultsLimit 或 limit 等参数控制返回结果数，但这些限制通常按查询而非按调用应用。例如传 3 个搜索词加 maxItems: 10 可能返回最多 30 个结果（每查询 10 个），而非总共 10 个。控制成本的方法：每次调用优先单个查询；首次调用从小限制（5-10）开始；若端点接受数组（如 searchTerms、hashtags、urls），除非用户明确要求多个，否则只传一个元素；从 monid inspect 的输入结构识别哪些参数控制数量。
运行状态：READY（排队等待开始）、RUNNING（正在执行）、STOPPING（已请求停止，正在关闭，瞬态）、COMPLETED（成功完成，结果可用）、FAILED（执行失败，检查错误详情）、BLOCKED（工作区控制阻止了运行）、STOPPED（按要求停止）、TIMED_OUT（超过时间限制被终止）。状态值始终为大写且区分大小写。运行通常耗时 1 到 120 秒，取决于端点与数据量。
停止运行：用 monid runs stop -r <runId> 请求停止。并非所有运行都可停止，可停止性不简单等于“是否仍在运行”。权威信号是 monid runs get -r <runId> 返回的运行详情中的 stoppable 字段：仅当 stoppable 为 true 时才尝试停止。若为 false 则不要尝试，包括终态运行以及平台不允许停止的进行中运行。尝试停止不可停止的运行会返回冲突。停止是异步接受的，需轮询直到运行达到 STOPPED。
当运行被 BLOCKED 时，响应包含 controls 数组，列出阻止它的快照。每个条目有 controlId 和描述限制的快照——目前为 WORKSPACE_BUDGET（周期加 limit/available/held/spent 金额）或 WORKSPACE_RUN_CAP（单次运行限制金额）。BLOCKED 运行是终态，不会自行继续，因此停止轮询。告知用户运行被工作区控制阻止，可在 https://app.monid.ai 仪表盘暂停或修改这些控制后重试。
轮询最佳实践：默认方式（交互式使用推荐）为不带 --wait 触发运行（立即返回运行 ID），每 5-10 秒用 monid runs get -r <runId> 轮询，保持对话响应性，避免阻塞 1-120 秒。当阻塞可接受时（如计划任务、非交互脚本）使用 --wait，必要时设置超时如 -w 30。注意：运行可能耗时 1-120 秒，不带超时使用 --wait 可能阻塞对话或触及智能体运行时限制。
API 密钥格式：monid_<stage>_<secret>（如 monid_live_abc123...）。密钥在 https://app.monid.ai/access/api-keys 生成。
关于具体端点的可用性、定价、平台覆盖与效果，资料未提供完整清单，需以实际 discover 与 inspect 结果为准。