Crawl APIs

Analyse une base de code pour les définitions REST, GraphQL, gRPC et OpenAPI

par ea-toolkit · ea-toolkit/architecture-catalog

Testé · Fonctionne ★ 9.2/10

Crawl APIs — Analyse une base de code pour les définitions REST, GraphQL, gRPC et OpenAPI

Ce que fait

Analyse une base de code cible pour les définitions d'API à travers les spécifications OpenAPI/Swagger, les routes Express/Fastify/NestJS, les schémas GraphQL, les protos gRPC et les frameworks Python, puis propose des entrées de registre api_contract et api_endpoint provisoires pour examen. Se déclenche lors de la découverte, de l'inventaire ou du catalogage des APIs dans un dépôt.

Rapport de test

Exécuté les modèles de détection exacts de la compétence sur une cible spécialement conçue contenant six styles d'API différents et il a trouvé les six (6/6) - y compris le contrôleur de décorateur NestJS, le schéma GraphQL et le service proto gRPC qu'une base naïve de grep-for-route/api à un seul passage a complètement manqué (3/6). La taxonomie multi-protocole, le contrôle de déduplication et la discipline du statut 'draft-only' constituent un avantage concret et reproductible par rapport à une recherche ad hoc. L'étape de réécriture dépend des modèles models/registry-mapping.yaml et des templates du catalogue, donc la sortie complète du registre fonctionne au sein de son dépôt d'origine ; le cœur de la découverte fonctionne partout.

Testé le: 2026-07-18 · Claude Code 2.x (agent harness)

Installation

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

Commandes et exemples de prompts

  • /crawl-apisAnalyse une base de code pour les définitions REST, GraphQL, gRPC et OpenAPI

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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?