SuperAPI AI 工具集

endor-findings

安全与审计

查看项目

更新于 10-15 21:38

技能介绍

用途:查询并展示 Endor Labs 的安全发现(findings),支持按用户输入构建筛选条件。适用于用户说“show findings”“list vulnerabilities”“what did the scan find”等场景。

主要能力:解析用户关键词为 API 过滤条件,例如 critical 对应 spec.level==FINDING_LEVEL_CRITICAL,high 对应 spec.level==FINDING_LEVEL_HIGH,可达性用 spec.finding_tags 是否包含 FINDING_TAGS_REACHABLE_FUNCTION,类别用 spec.finding_categories 对应漏洞、SAST、密钥、许可证风险等。多个过滤器可用 and 组合。默认无用户筛选时为 critical + high,并排除测试依赖。

使用方式:三种取数路径。一是在扫描后由 scan MCP 工具返回按严重度排序的 finding UUID,再用 get_resource(resource_type: Finding)逐个获取;二是先运行 /endor-scan 再通过 get_resource 获取;三是 CLI 兜底,命令为 npx -y endorctl api list --resource Finding -n $ENDOR_NAMESPACE --filter "{filter_string}" 2>/dev/null。CLI 字段路径与解析注意事项见 references/cli-parsing.md,可达性标签解释见 references/reachability-tags.md,数据源策略见 references/data-sources.md。

结果呈现:输出筛选说明、总数、发现表格(序号、严重度、类别、包、CVE/问题、可达性、描述)与汇总,并按优先级排序:Critical 且可达、Critical 可能可达、High 且可达、High 可能可达、密钥/凭据、Critical 不可达、SAST Critical/High、许可证问题、Medium/Low。还提供后续步骤,如 /endor-fix {top-cve}、/endor-explain {cve}、/endor-findings critical reachable,并在结果较多时分页。

限制与错误处理:无发现时提示可能尚未扫描,建议 /endor-scan;认证错误建议 /endor-setup;过滤语法错误时展示正确格式。具体 API 字段、命令细节及标签含义需参考仓库内对应参考文档。