community-automations/api-schema-extractor

DevOps e Código

PublicSubagente Claude

Extractor de Esquema de API

Muitas APIs internas não têm spec, por isso cada integração começa com suposições e um separador cheio de pedidos de teste. Este extractor analisa a API em produção e escreve a documentação por si.

sonnet4 diasPythonOpenAIPostmanGitHub
ClaudeClaude
ROI for
README.md

Porquê este subagente

Muitas APIs internas não têm spec, por isso cada integração começa com suposições e um separador cheio de pedidos de teste. Este extractor analisa a API em produção e escreve a documentação por si.

Infere parâmetros, formatos de resposta e códigos de status a partir de respostas reais, monta um ficheiro OpenAPI 3.1 e faz lint antes de fazer commit. Obtém uma spec funcional num pull request, pronta a rever e a usar nos seus geradores de clientes e documentação.

Como funciona

    • Read

      Used at step 01 to kick off the pipeline.

    • Write

      Used at step 01 to kick off the pipeline.

    • WebFetch

      Used at step 01 to kick off the pipeline.

    • WebSearch

      Used at step 01 to kick off the pipeline.

Saída de exemplo

json
// Sample output
// (generated when the pipeline finishes)

Given an API base URL and sample calls, probe the endpoints and return a valid, linted OpenAPI 3.1 document describing paths, parameters, and response schemas.

Unlock the rest

The full agent definition, install snippet, and starter task are gated for community members.

Members get the full `.md` agent file, the npm / pnpm install one-liners, a starter prompt that we've tuned against real runs, and the open-source repo when this automation ships there. One email, magic link, done.