SuperAPI AI 工具集

endpoint-probe

编程与开发

查看项目

更新于 10-16 01:19

技能介绍

用途:当用户给出基础 URL 并询问“有哪些 API”“如何认证”“端点有哪些”,或需要了解未公开/半公开 API、评估第三方服务、探索 MCP 服务器能力时使用。不适用于抓取 HTML 页面、已知功能的 QA 测试、配置 MCP 服务器或长期监控。

主要能力:脚本按 7 个阶段运行——服务器指纹、约 40 条 well-known 路径、GraphQL introspection、OPTIONS/CORS、认证检测、速率限制检查、约 50 条常见 REST 资源猜测。支持 --mcp 探测 HTTP(StreamableHTTP)MCP 服务器,--mcp-stdio 通过子进程探测本地 MCP 服务器,发现工具名、描述、输入 schema、资源与提示。

用法:python scripts/probe_api.py <base_url> [options]。常用选项有 --auth、--auth-type(bearer/basic/apikey)、--header、--timeout、--json、--no-guess、--api-version、--mcp、--mcp-stdio、--mcp-env、--allow-private。示例:python scripts/probe_api.py https://api.example.com --auth "tok_abc123"。

限制:基础 URL 需为 API 根,过具体路径会影响发现;OpenAI 兼容推理端点应探测域名根。YAML 版 OpenAPI 不解析;gRPC-Web 仅按路径判断;SSE 解析仅取首个 data 行;自签名证书暂不支持;Windows 的 stdio MCP 未测试;--mcp 与 --mcp-stdio 互斥;响应体上限 5 MiB;探测会拦截私有 IP 与云元数据地址(可用 --allow-private 覆盖),stdio 仅允许 npx、uvx、python3、python、node、bunx 等运行器并禁止内联代码标志;凭据经命令行参数会出现在进程列表中,建议用环境变量。报告会脱敏凭据值但保留认证协议信息。