核心用法
MiniMax CLI Web Search 是一个通过本地 CLI 包装器 mcporter 调用 MiniMax MCP 进行网页搜索的技能。其核心工作流程分为两个阶段：
Phase 1 - 环境准备：必须先运行 --preflight 检查，验证 mcporter 存在性、MiniMax MCP 服务器可发现性及健康状态。若检查失败，需根据错误类型修复：安装 mcporter、检查配置文件 config/mcporter.json、确认 API 密钥配置。
Phase 2 - 搜索执行：使用 --query 指定搜索关键词，--count 控制结果数量（默认 5 条），支持 --freshness 添加时效提示、--json 输出标准化 JSON、--timeout 设置超时（默认 35 秒）。
显著优点
- 结构化预检机制：强制性的环境检查降低了跨机器配置漂移导致的失败率
- 标准化输出：支持 JSON 与文本两种格式，便于下游自动化处理
- 完善的错误码体系：6 种退出码明确区分参数错误、依赖缺失、认证问题、网络故障等场景，特别将「无结果」（code 6）设为正常非致命状态
- 安全设计：明确禁止打印 API 密钥，仅报告缺失/无效状态
潜在局限
- 外部依赖较重：需要正确配置 mcporter、MiniMax MCP 服务器及 API 密钥，任一环节故障都会导致不可用
- 超时固定：默认 35 秒可能不适用于复杂查询或网络波动场景
- 结果质量依赖上游：MiniMax 搜索服务本身的时效性与相关性不受本技能控制
- 无本地缓存：每次调用均为实时请求，不适合高频批量查询
适合人群
- 需要实时网页信息的开发者与研究人员
- 已部署 MiniMax MCP 基础设施的团队
- 偏好命令行工作流、需要可脚本化搜索能力的自动化场景
常规风险
| 风险类型 | 具体描述 | 缓解措施 |
|---------|---------|---------|
| 配置漂移 | 不同机器环境差异导致脚本失效 | 每次新环境先执行 `--preflight` |
| 密钥泄露 | 日志或输出中意外暴露 API 密钥 | 技能内置禁止打印密钥值 |
| 网络不稳定 | 超时或上游服务波动 | 增加 `--timeout`，使用更窄的查询词 |
| 结果相关性不足 | 查询词模糊或时效性不匹配 | 重述查询，添加具体时间/实体限定 |
使用建议
首次使用务必完成预检流程；生产环境建议配合 --json 输出以便解析；时效敏感任务应在查询词中显式包含时间词汇（如 today、latest、具体日期）。