Crawl APIs

Scansiona una codebase per definizioni REST, GraphQL, gRPC e OpenAPI

di ea-toolkit · ea-toolkit/architecture-catalog

Promosso ★ 9.2/10

Crawl APIs — Scansiona una codebase per definizioni REST, GraphQL, gRPC e OpenAPI

Cosa fa

Scansiona una codebase target per definizioni API attraverso specifiche OpenAPI/Swagger, route Express/Fastify/NestJS, schemi GraphQL, proto gRPC e framework Python, quindi propone bozze di voci di registro api_contract e api_endpoint per la revisione. Si attiva quando si scoprono, si inventariano o si catalogano le API in un repository.

Rapporto di test

Eseguiti gli esatti pattern di rilevamento della skill su un target appositamente costruito contenente sei diversi stili API e ha trovato tutti e sei (6/6) - inclusi il controller decoratore NestJS, lo schema GraphQL e il servizio proto gRPC che una baseline ingenua di grep-for-route/api ha completamente mancato (3/6). La tassonomia multi-protocollo più il controllo di deduplicazione e la disciplina dello stato solo bozza è un vantaggio concreto e riproducibile rispetto alla ricerca ad-hoc. Il passaggio di scrittura dipende dai modelli models/registry-mapping.yaml e dai template del catalogo, quindi l'output completo del registro funziona all'interno del suo repository; il core di scoperta funziona ovunque.

Testato il: 2026-07-18 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/ea-toolkit/architecture-catalog
mkdir -p ~/.claude/skills
cd architecture-catalog && cp -r .claude/skills/crawl-apis ~/.claude/skills/crawl-apis

Comandi e prompt di esempio

  • /crawl-apisScansiona una codebase per definizioni REST, GraphQL, gRPC e OpenAPI

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Scan my repo and find every REST, GraphQL, and gRPC API endpoint.
  • I need an inventory of all the API contracts across this service.
  • Can you catalog the OpenAPI, NestJS, and Express routes in this codebase?