Is Agentic 用于评估一个网站、域名或公开 MCP 端点对 AI 智能体的就绪程度，并读取或依据生成的报告采取行动。它会对公开 URL 运行技术审计，发布 0 到 100 的智能体就绪度评分，并给出有证据支撑的问题与推荐修复方案。以下所有接口均为公开、只读且免费，均不需要 API 密钥。
获取评分
默认方式是使用官方 CLI。它会立即返回已存储的报告；若不存在报告，则启动扫描并等待。
npx is-agentic <domain> --json
仅在由人类阅读终端输出时才省略 --json。
当无法运行命令时，改用只读 API。该 API 从不启动扫描；返回 404 表示尚无已完成的报告。
GET https://is-agentic.com/api/v1/report?url=<url-encoded-target>
MCP 主机可连接 Streamable HTTP 端点 https://is-agentic.com/mcp，并调用 is_agentic_get_report、is_agentic_get_methodology 或 is_agentic_get_developer_docs。
读取报告
JSON 响应是一个 PublicScanReport：
score：0 到 100，当目标无法评分时为 null（例如需要身份验证的 MCP 服务器）。score_label 会解释 null 评分。
score_breakdown.essential 与 .recommended：各自包含 earned、available、passing、total。Essential 检查是最重要的；一个网站可能看起来精致，但仍未通过这些检查。
score_breakdown.bonus：包含 points 与 positive_signals。Bonus 是附加项，从不强制要求；不要将缺少 bonus 信号视为缺陷。
issues[]：每项包含 id、name、tier（essential | recommended | bonus）、result（failed | partial）、details（来自扫描的证据）与 recommendation（修复建议）。
report_url：规范的人类可读报告。向他人报告评分时请引用它。
scanned_at：审计运行的时间。报告是不可变快照。
提升网站评分
获取你正在改进的确切目标的报告。
按以下顺序处理问题：essential 失败、essential 部分通过，然后是 recommended。除非其他所有项都通过，否则忽略 bonus。
对于每个问题，details 说明扫描观察到的情况，recommendation 说明需要更改的内容。优先采用 recommendation；它是针对实际证据编写的。
部署修复后，获取新的评分并比较 scanned_at，以确认你读取的不是旧快照（见注意事项）。
错误
失败响应为 RFC 9457 application/problem+json，带有稳定的 code 与解决提示。根据 code 采取行动：
invalid_url (400)：传入公开的 HTTP 或 HTTPS URL。
report_not_found (404)：不存在已完成的报告；使用 CLI 创建，或打开 https://is-agentic.com/scan/<target> 启动扫描，待其完成后重试。
rate_limit_exceeded (429)：重试前遵守 Retry-After。
report_temporarily_unavailable (503)：稍后重试；不要启动新扫描。
注意事项
报告仅在访问发现其超过 6 小时时刷新。部署修复后立即重新运行 CLI 会返回相同的已存储快照；得出结论前请检查 scanned_at，当人类需要立即重新运行时，使用报告页面上的 Rescan 控件。
API 与 CLI 在报告缺失时行为不同：API 返回 404，CLI 启动扫描并等待。请相应选择。
目标是精确的：example.com/docs 与 example.com 是分开的报告，带查询字符串的 URL 也是独立的报告。
速率限制为每 IP 每 60 秒 120 次请求。
为减少 token 消耗，内容页面与已完成的报告支持 Accept: text/markdown。