SuperAPI AI 工具集

postman-api-readiness

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:评估 API 对 AI 智能体的兼容性,回答“AI 智能体能否可靠使用这个 API”。

主要能力:基于 OpenAPI 规范运行 48 项检查,覆盖 8 个维度——元数据、错误、内省、命名、可预测性、文档、性能、可发现性。每项检查带严重级别权重:Critical 4 倍、High 2 倍、Medium 1 倍、Low 0.5 倍。综合得分 70% 以上且无 Critical 失败才算 Agent Ready。检查项包含 operationId、错误响应与错误模式、参数类型与必填标记、路径命名与 HTTP 语义、响应模式与分页、认证与限速文档、缓存与批量端点、OpenAPI 版本与服务器 URL 等。

使用方式:查找本地 OpenAPI/Swagger 文件(如 **/openapi.{json,yaml,yml})或通过 Postman MCP 获取规范;解析并校验规范;分析全部检查项并计算加权得分;输出总体得分、各维度得分、前 5 项优先修复建议,以及重新分析、生成报告、导出到 Postman 等后续选项。若 Postman MCP 可用,还可推送规范、生成集合、环境、Mock 并运行测试。

适用场景:开发者希望提升 API 对 AI 智能体的可发现性、可调用性和错误自愈能力时。

限制:需可解析的 OpenAPI 规范(至少含 info 与 paths),非 OpenAPI 描述或缺失规范的 API 无法分析;无 MCP 时仅做静态分析;具体安装命令、价格与平台支持暂未提供。