alufers/mitmproxy2swagger

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

9594 stars · 372 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A CLI tool that converts mitmproxy traffic captures (and HAR files) into OpenAPI 3.0 / Swagger specifications. It lets you reverse-engineer undocumented REST APIs by capturing HTTP traffic and merging results into an existing schema.

Use cases

• generate openapi spec from captured http traffic
• reverse-engineer an undocumented rest api
• convert mitmproxy flow file to swagger
• create api documentation from har file
• document a mobile app's backend api
• merge multiple traffic captures into one api spec

When to choose

• you need an OpenAPI spec for an API with no existing documentation
• you can capture the API's traffic via mitmproxy or browser DevTools HAR export
• you want to incrementally extend an existing schema with new captures

When to avoid

• you need to document GraphQL or non-REST APIs
• you already have hand-written OpenAPI specs and just need editing tooling
• traffic is encrypted and you cannot set up a MITM proxy

Facets

cli-tool · maturity active

reverse-engineering api-documentation parser developer-tools apis developer-tools reverse-engineering documentation cli python cross-platform openapi swagger mitmproxy har traffic-capture rest-api docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="alufers/mitmproxy2swagger")