SuperAPI AI 工具集

api-portal-discovery

编程与开发

查看项目

更新于 10-16 08:39

技能介绍

用途:针对给定域名发现公开 API 门户、开发者文档与 OpenAPI/Swagger 规范端点,并汇总证据。

主要能力:

  1. check_api_subdomains:测试常见 API 相关子域(如 api、developer、developers、dev、docs、documentation、api-docs、apidocs、api-portal、portal、integrate、sandbox、public-api、open、openapi、swagger、rest、graphql、gql、v1、v2、v3),构造 FQDN 后发 HTTP HEAD 请求,记录状态码与重定向,标记成功响应。
  2. find_openapi_spec:在发现的 API 子域上测试常见路径(/openapi.json、/openapi.yaml、/swagger.json、/swagger.yaml、/api-docs、/api-docs.json、/v1/openapi.json、/v2/openapi.json、/v3/openapi.json、/docs/openapi.json、/api/openapi.json、/.well-known/openapi.json、/specification/openapi.json),校验是否为有效 OpenAPI 规范并提取元数据。
  3. detect_graphql:测试常见 GraphQL 路径(/graphql、/gql、/api/graphql、/v1/graphql、/query),通过 POST 内省查询检测 GraphQL 响应结构并提取 schema 元数据。
  4. scan_robots_txt:抓取 /robots.txt,解析 Disallow/Allow 指令,识别 API 相关路径与 sitemap 引用。
  5. analyze_developer_portal:分析开发者门户,提取认证方式(OAuth、API key、JWT)、SDK 语言、速率限制文档、Webhook 支持与 API 版本策略等信号。

输出:结构化 JSON,包含 api_subdomains、openapi_specs、graphql_endpoints、developer_portals、robots_txt_findings 及 evidence 列表。

限制与安全:仅使用安全 HTTP 方法(GET、HEAD、OPTIONS),不尝试绕过认证,遵守 API 文档中的速率限制(HTTP 请求 30/分钟/域名,GraphQL 内省 5/分钟,OpenAPI 校验本地解析不限),记录所有请求,不执行 API 规范中的任意代码。401/403 表示受保护 API 仍有发现价值,404 表示路径不存在,超时可记录重试。具体安装与调用方式资料未提供。