is-agentic

Is Agentic

Is Agentic 会对公开 URL 进行技术审计，并发布 0 到 100 分的 Agent 就绪度评分，同时提供有证据支持的问题和建议修复方案。以下所有接口均公开、只读且免费；无需 API 密钥。

获取评分

默认使用官方 CLI。它会立即返回已存储的报告；若报告不存在，则启动扫描并等待完成。

npx is-agentic <domain> --json

只有在由人阅读终端输出时，才省略 --json。

无法运行命令时，请改用只读 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；如果无法为目标评分（例如需要身份验证的 MCP 服务），则为 null。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：审计运行时间。报告是不可变的快照。

提高网站评分

1. 获取你要改进的确切目标的报告。
2. 按以下顺序处理 issues：essential 中的失败项、essential 中的部分通过项，然后是 recommended。除非其他项目全部通过，否则忽略 bonus。
3. 对于每个问题，details 会说明扫描观察到的情况，recommendation 会说明需要更改的内容。优先采用建议方案；该方案是根据实际证据撰写的。
4. 部署修复后，获取新评分，并对比 scanned_at，确认你读取的不是旧快照（参见注意事项）。

错误

失败响应遵循 RFC 9457 application/problem+json 格式，并包含稳定的 code 和 resolution 提示。请根据代码采取措施：

• 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。