通过验证的OpenAPI文档不一定是AI代理能使用的文档。语法是 一方面;语义清晰、安全性和可发现性则是另一回事。Jentic API 评分卡 将你的 OpenAPI 文档与 Jentic API AI 准备框架（JAIRF） 跨越六个维度，并返回一个等级——这样你就知道哪些地方需要改进。配对 配合配套的api-improve代理技能，可以自动应用这些改进： 非断裂编辑，可重复使用。 OpenAPI 覆盖层，以及之前/之后的变更日志。

目录

• 快速入门
• 它的得分
• 工作原理
• 要求
• 安装
• 现在试试
• 控制输出深度
• 机器可读输出
• HTML 报告
• LLM分析
• 匿名访问与密钥访问
• 技能
• Jentic-API 记分卡
• Jentic-API-Improve
• CLI 参考
• 命令
• score
• GitHub Action
• 喜欢浏览器？
• 默认企业级
• 你的 OpenAPI 文档永远不会离开你的环境
• 可端到端可听
• 签署受监管环境
• 无处不在
• 置顶以保证重复性
• 状态
• 计分发动机信号状态
• 许可证

快速开始

Jentic API Scorecard

An OpenAPI document that passes validation isn’t necessarily one an AI agent can use. Grammar is one thing; semantic clarity, safety, and discoverability are another. The Jentic API Scorecard scores your OpenAPI document against the Jentic API AI Readiness Framework (JAIRF) across six dimensions and returns a single grade — so you know exactly where to improve. Pair it with the companion api-improve agent skill to apply those improvements automatically: non-breaking edits, a reusable OpenAPI Overlay, and a before/after changelog.

Table of contents

• Quick start
• What it scores
• How it works
• Requirements
• Install
• Try it now
• Control output depth
• Machine-readable output
• HTML report
• LLM analysis
• Anonymous vs keyed access
• Skills
  • jentic-api-scorecard
  • jentic-api-improve
• CLI reference
  • Commands
  • score
• GitHub Action
• Prefer a browser?
• Enterprise-ready by default
  • Your OpenAPI document never leaves your environment
  • Auditable end to end
  • Signed for regulated environments
  • Runs anywhere
  • Pinned for reproducibility
• Status
  • Scoring engine signal status
• License

Quick start

1. Get a free key at the Jentic Scorecard API Keys page.

2. Score an OpenAPI document:

   JENTIC_API_KEY= npx @jentic/api-scorecard-cli score ./openapi.yaml
   

What it scores

Each OpenAPI document is evaluated across six lenses — small, targeted improvements in any of them tend to produce outsized gains for both human developers and AI agents: