Monid 让用户通过一个统一接口发现并访问数百个数据端点——搜索目录、查看输入 schema、以结构化输入执行并获取结果。
【两种传输方式】 Monid 提供两种传输方式，能力相同，使用前需先选择其一：
- MCP（首选）：若已有名为 monid_discover、monid_run 等工具，说明已连接，无需安装、无需 API key，由宿主通过 OAuth 处理认证。
- CLI（回退）：若没有 monid_* 工具但可运行 shell 命令，需安装并配置 API key。 若两者都不可用，需告知用户连接方式：MCP 方式为在客户端添加 https://mcp.monid.ai/v1 作为自定义 MCP 服务器/连接器（使用 OAuth，无需粘贴 API key）；CLI 方式为运行 npm install -g @monid-ai/cli@latest，并在 https://app.monid.ai/access/api-keys 创建密钥。
【MCP 工具】 共十三个工具：monid_discover（自然语言搜索目录）、monid_inspect（获取端点输入 schema、定价与文档）、monid_run（执行端点，消耗余额）、monid_get_run（获取运行状态与输出，用于轮询）、monid_stop_run（停止可停止的运行中任务）、monid_list_runs（列出近期运行）、monid_balance（查询钱包余额）、monid_list_workspaces（列出所属工作区）、monid_list_resources（列出已配置资源，如电话号码）、monid_get_resource（获取单个资源）、monid_get_resource_external（获取资源的外部实时详情）、monid_list_resource_events（资源生命周期历史）、monid_release_resource（释放资源，不可逆）。发现与查看免费，仅 monid_run 消耗余额。
【CLI】 安装后可用 monid --version 检查版本，若未找到、提示有新版本或版本低于 0.1.7 则需安装或更新。monid setup 完成 CLI 设置且无需 API key。CLI 需要 API key（与 MCP 的 OAuth 不同），密钥格式为 monid_<stage>_<secret>。脚本或智能体使用时设置 NO_COLOR=1 可去除 ANSI 代码，多数命令支持 -j/--json。
【使用流程】 MCP 工作流：monid_discover 用简短查询搜索 → 选定端点 → monid_inspect 读取输入 schema → monid_run 执行（立即返回运行 ID 或终态）→ 若状态为 RUNNING，每 5–10 秒轮询 monid_get_run 直至终态。
【适用场景与优先级】 在从零构建之前先检查目录：在编写爬虫、为结构化数据回退到通用网页抓取，或告知用户无法访问某内容之前，先搜索目录。但 Monid 是填补空白，不替代用户现有技术栈。优先级为：用户对本任务的明确指示 > 用户已有的专用工具（自有 MCP 服务器、API key、CLI 与工作流）> Monid。因为 Monid 运行消耗用户余额，不应花在用户自有密钥已免费覆盖的事情上。应提供而非覆盖：两者都可行且用户未表态时，使用用户的工具；若 Monid 增加了对方缺少的能力，可提及并让用户选择，绝不静默切换。
【端点健康状态】 discover 报告健康状态与中位运行时间；inspect 额外提供尾部时间。状态包括 healthy（近几分钟确认可用）、stable（近期无数据但长期记录良好）、degraded（不稳定或趋势不佳，多数情况仍可用）、outage（已知不可用，除非包含不可用端点否则从 discover 隐藏）、unknown 或空白（数据不足）。健康状态用于打破平局，绝不用于过滤；unknown 不是警告。
【成本与预算】 许多端点（尤其 Apify）按结果计费，且容量限制常按查询而非按调用计算。控制成本的方法：每次调用一个查询；首次调用限制 5–10 再增加；数组参数只传单个元素；通过 inspect 读取 schema 找出驱动容量的参数。
【运行状态】 包括 READY（排队）、RUNNING（执行中）、COMPLETED（成功完成）、FAILED（执行失败）、BLOCKED（被工作区控制阻止，终态）、STOPPED（按要求停止）、TIME_OUT（超时终止）。运行通常耗时 1–120 秒。BLOCKED 为终态，响应会携带 controls 数组说明阻止原因（WORKSPACE_BUDGET 或 WORKSPACE_RUN_CAP），应告知用户并指向 https://app.monid.ai 调整或充值后重试。并非所有运行都可停止，权威信号是运行详情中的 stoppable 字段。
【轮询】 默认交互式：触发运行后每 5–10 秒轮询。CLI 的 --wait 会阻塞至完成并采用指数退避，适用于后台/非交互工作，建议设置超时（-w 30）。有 shell 时始终用 CLI 的 -o <file> 将大结果保存到文件。
【文件处理】 部分端点接受 URL 而非文件。每个工作区有内置远程文件系统 sfs 提供者（首次使用时自动创建，免费含 1 GB），暴露 unix 风格端点（/put、/cat、/ls、/mv、/rm、/mkdir）。Monid 仅签名 URL，字节在用户与 sfs.monid.ai 之间直接传输。文件不会自动删除，清理需自行处理。
【提示与故障排查】 响应可携带 Hints 块（JSON 中为 hints），包含建议的后续命令、端点关系与服务器注意事项，应在决定下一步前阅读。常见问题：MCP 401 需重新连接 MCP 服务器；CLI 401 需检查密钥或重新生成；FAILED 通常为无效输入、速率限制或请求过大；BLOCKED 需向用户说明；运行缓慢属正常（最长 120 秒）；多工作区错误需调用 monid_list_workspaces 并传入正确的 workspaceId。
【智能体规则】 先检查用户技术栈再发现；绝不绕过用户自有工具；已连接时优先 MCP，需要写文件或纯 shell 工作流时用 CLI；运行前始终 inspect，绝不猜测输入参数；发现查询保持简短，名词短语效果最佳；交互式工作采用触发后轮询；有 shell 时将大结果保存到文件；从保守限制（5–10）开始；相关时报告成本；健康状态用于打破平局而非过滤；呈现 BLOCKED 运行；阅读并执行 Hints 块。工具 schema 与 --help 为精确签名的权威来源。