swagger-api-reader

To cache Swagger and OpenAPI documentation for AI models, you provide the API URL to the tool, which fetches and stores the raw data locally. It supports OpenAPI 3.x and Swagger 2.x formats for immediate model reference.

Yes, you can retrieve OpenAPI definitions from SSO-protected pages. The tool supports bearer, basic, and apiKey authentication, and uses browser-based retrieval via Selenium to handle SSO flows.

You manage cached API docs using add, list, read, refresh, and remove workflows. The tool maintains a URL-hash cache to track and update stored OpenAPI definitions alongside generated human-readable documentation.

Yes, swagger-api-reader works with both Swagger 2.0 and OpenAPI 3.0 specs. It automatically detects Swagger UI pages and processes both formats to generate accessible API documentation for AI reasoning.

Parsing OpenAPI and Swagger files requires the requests, pyyaml, and selenium Python dependencies. These libraries handle HTTP fetching, YAML parsing, and browser-based retrieval for protected API endpoints.