클릭 한 번으로 OpenAPI 에이전트 지원 문서 압축 (llms.txt, MCP 스텁, Postman)

작성자

카테고리:

← 피드로
DEV Community · oplante dev · 2026-09-28 개발(SW)

oplante dev

Agents don’t browse Swagger UI the way humans do. They need structured maps, tool stubs, and copy-pasteable examples — not a wall of endpoints meant for clicking.

SpecPack (openapi-agentpack) takes an OpenAPI 3.x spec (drop a file or paste JSON/YAML) and builds a downloadable pack an LLM or agent can use without a human rewriting the docs:

  1. README + how-to-call (curl / JS / Python)
  2. llms.txt — agent-oriented map of the API
  3. MCP tool stubs (JSON) per operation
  4. Postman collection
  5. Normalized openapi.json
  6. Short guide for “call with zero hand-holding”

Why this exists

Hosted docs platforms are great when you want a full docs site. They’re overkill when you just need the pack so an agent (or a teammate bootstrapping MCP) can call the API.

Swagger UI is built for humans. SpecPack is built for the pack itself.

Try it

The generator runs client-side on GitHub Pages. It fails closed on invalid OpenAPI and hard-caps huge specs (size / ops / paths). No enterprise SSO and no paid checkout in v1 — this is the free demo.

원문에서 계속 ↗